Gesture & focus testing — the hand-only checklist

Some Weavero surfaces cannot be tested programmatically: synthetic DOM events are untrusted (isTrusted: false) and XUL/native handlers ignore them, real drag sessions can’t be forged, and OS window focus is meaningless under a headless display. These run by hand. Companion pages: disable-testing, restart-testing, taskbar-overlay-testing (its S6/S7/S11 rows are part of this checklist on Windows).

Run the full checklist before a release; run the relevant section after touching drag/drop, window moves, or focus code.

Tab drags (main window)

• Reorder a tab within the strip — drop indicator tracks the cursor, tab lands at the indicated slot.
• Drag a tab down out of the strip → tears off into a standalone reader window under the cursor; the new window is focused; the source window reveals a loaded neighbor tab (not the library, unless nothing loaded remains); reading position preserved (no-reload swap).
• Drag a tab into another main window’s strip at a specific slot → lands at that slot; the dragged tab becomes the target’s active tab (Firefox rule); tab id preserved (check via List all tabs if in doubt).
• Multi-select (Ctrl+click) several tabs, drag the selection to another window → all move; the dragged tab (not the first) is active in the target.
• Drop a tab into the pinned region → auto-pins.
• ESC / drop back on the source strip mid-drag → nothing moves, no ghost window.

Reader-window drags

• Drag a reader-window strip tab into a main window’s tab bar → merges back as a tab, selected, same tab identity; the reader window closes if that was its last tab.
• Drag a main-window reader tab onto a reader window → mounts into its strip (move semantics — source tab closes).
• Drag a group chip onto another window → the whole group travels; onto the desktop → group pops into its own window.
• After each move: scroll the document — position/zoom/selection survived; sidebar previews still render.

Cross-window item drag & drop

• Drag items from one window’s items list onto another window’s items list → items are added to the collection shown there (all of them, when multiple collections are selected).
• Cross-library variant → items copy once (linked copies reused); attached files follow when the target library allows file editing (group libraries with files disabled legitimately skip files).
• The source window’s collection selection and items list do not flicker or jump during the drop.

Focus rules (after any window/tab machinery change)

• Tear-off: the new window has OS focus. Known limitation (Windows, 2026-07-21): if the drag is released over another application’s window, that app keeps the foreground — Windows’ foreground lock forbids a background process stealing it back, so the plugin’s focus() is a no-op and the new reader window opens behind. Expected-fail; only drops on Zotero’s own surfaces or the desktop guarantee focus.
• Merge-back: the target window has focus and the merged tab is selected.
• Closing a window: focus falls to a sensible surviving window; the library tab is a fallback, not the default.
• Restoring a saved window/session: the restored window opens with its saved geometry (maximized windows reopen maximized) and does not steal focus from where you are typing (background restore).

Reader pin bookmarks (after touching pin drag / _wvReaderShowPin)

The in-document pushpin for a position bookmark. Surface it: open a PDF, open Weavero’s reader Bookmarks panel, click a position-type bookmark row → the pin drops at that spot (it fades after a moment but stays while hovered). Then, at the mouse:

• Click the pin without moving → it stays put; the bookmark’s stored position is unchanged. (A press under the drag threshold is a click, not a drag — the lift is deferred until the pointer travels past it, so a click can’t nudge the tip.)
• Grab the head and drag slowly → the pin follows the hand from the grab point, not snapping its tip under the cursor (grab offset preserved).
• Drop on the page → the bookmark re-anchors to where the tip landed; the sidebar list re-sorts by location; the label auto-updates to “Page N” only if it wasn’t manually renamed.
• Drag off the page and drop → pin greys out / no-drop cursor while off-page, and on release the bookmark is unchanged (cancels back to its original spot).

Outline tab menu (after touching the Outline-tab wiring / page labels)

Page numbers (“p. N”) in Weavero’s Outline tab, issue #42. Open a PDF with an outline, switch the sidebar to Outline (Weavero takeover active), then:

• Right-click the Outline tab button → a menu in the annotations sort-menu format opens under it: heading PAGE NUMBERS, rows ✓ Show (default) and Hide. (Left-click and double-click keep their native meanings: switch tab, expand/collapse all.)
• Click “Hide” → the labels disappear at once, the menu closes. Right-click again → the tick is on Hide; “(default)” stays on Show.
• Switch to another document → its labels are still shown (the choice is per document). Back to the first → still hidden, also after closing and reopening the tab, and after a Zotero restart.
• Click “Show (default)” → labels return; weavero/outlines.json no longer carries a settings entry for the document (picking the default drops the record).
• Preferences → Reader outline → uncheck “Show page numbers” → every open reader’s outline drops the labels without a tab round-trip; the menu now reads Show / ✓ Hide (default); a document switched to Show from there still shows them.

Items-list width (after touching the table CSS or registering columns)

The items-list header must not size the centre pane (2026-09-11: with three Weavero columns the header’s intrinsic width exceeded the pane’s share, the side panes were squeezed, column drags moved the centre pane, and titles on the ellipsis boundary blinked). Show a dozen columns including Weavero’s Annotations / Tags / Related, then:

• Narrow the window until the items pane is at roughly its minimum → the collections pane and item pane keep their splitter widths; columns shrink inside the items pane instead.
• Drag a column separator (e.g. Creator | Year) → only that pair of columns changes; the centre pane and the other columns stay put.
• Watch truncated titles for a few seconds at that width → no blinking between “Tes…” and “Test12”-style renderings.

Popups (after touching popup code)

Run test/popups.spec.js first, then by hand:

• Comment popup and relations popup open anchored to their trigger, in the main window and in a standalone reader window.
• Second click on the same anchor toggles the popup closed.
• A click anywhere outside — including other documents/iframes — dismisses it.

Windows taskbar (multi-monitor, after identity/badge changes)

Follow the taskbar overlay matrix — minimum hand pass: S6 (drag across monitors without dropping), S7 (new window), and one fresh-reboot S13 run. Verify with your eyes (or screen captures), not logs: the failure modes are visible states the bookkeeping can believe it prevented.