Chat dock: let the window float anywhere on screen, not just the three docked spots #1904

Closed
opened 2026-11-12 12:27:07 +00:00 by sam · 2 comments
Owner

The chat dock is restricted to three locations: docked left, center-bottom, docked right. It should behave like a floating window instead: draggable to any position on screen, resizable from every edge and corner, explicit Left / Float / Right controls, snapping to an edge while dragging, an in-place minimise, and Ctrl+/ to toggle the window. Today a header drag only pins to an edge and a resize handle exists only while pinned.

The chat dock is restricted to three locations: docked left, center-bottom, docked right. It should behave like a floating window instead: draggable to any position on screen, resizable from every edge and corner, explicit Left / Float / Right controls, snapping to an edge while dragging, an in-place minimise, and Ctrl+/ to toggle the window. Today a header drag only pins to an edge and a resize handle exists only while pinned.
sam self-assigned this 2026-11-12 13:30:52 +00:00
Author
Owner

Chat dock is now a free-floating window on desktop width (#1904), in PR #1912 (branch feat/1904-chat-dock-float, commit 4e9745d5c).

Changed files:

  • ui/src/chat/ChatDock.vue: header drags to any position; 8 edge/corner resize handles (pointer + arrow keys, role=separator with aria-orientation/valuenow/min/max); Left/Float/Right segmented control in the header; snap preview near side edges committing on release; minimise in place with a draggable collapsed bar; Ctrl+/ toggle; Escape unchanged; layout persisted via useStorage.
  • ui/src/chat/ChatDockLayout.ts (new, ChatDock-prefixed pure module): rect clamping, 8-way resizeRect, snapEdge, bar placement, legacy migration. App.vue untouched, CSS-var contract (--chat-pin-l/r, --chat-dock-clear) unchanged; old archie.chat.dock key migrated into archie.chat.dock.v2 and removed.
  • ui/test/chat-dock-float.test.ts (new): 9 table-driven tests over the layout module.

Commands run and results on this exact tree:

  • cd ui && pnpm test: 113 pass, 0 fail (incl. the 9 new tests).
  • pnpm run typecheck: clean.
  • pnpm run build: built in 1.74s.
  • task check from the worktree root: exit 0.
  • Browser check (vite dev server on 127.0.0.1:5197, headless Chrome; the dock was mounted in isolation because the local backend on 8484 requires org setup, so the full shell would not render): drag-anywhere with snap commit to the right pin (pin-r 460px, mode right stored), drag to the middle unpins to float, all 8 handles present with role=separator/tabindex=0/aria-label "Resize chat"/aria-orientation/valuenow, keyboard resize (se) and keyboard move (arrow keys) change the stored geometry, Left/Float/Right switch --chat-pin-l/r, minimise in place keeps position and the bar drags, Escape collapses, Ctrl+/ opens and closes, legacy localStorage key migrated and removed, phone width (390px) keeps the full-width bottom bar with no handles or mode controls.
Chat dock is now a free-floating window on desktop width (#1904), in PR https://git.catlow.cloud/sam/archie/pulls/1912 (branch feat/1904-chat-dock-float, commit 4e9745d5c). Changed files: - ui/src/chat/ChatDock.vue: header drags to any position; 8 edge/corner resize handles (pointer + arrow keys, role=separator with aria-orientation/valuenow/min/max); Left/Float/Right segmented control in the header; snap preview near side edges committing on release; minimise in place with a draggable collapsed bar; Ctrl+/ toggle; Escape unchanged; layout persisted via useStorage. - ui/src/chat/ChatDockLayout.ts (new, ChatDock-prefixed pure module): rect clamping, 8-way resizeRect, snapEdge, bar placement, legacy migration. App.vue untouched, CSS-var contract (--chat-pin-l/r, --chat-dock-clear) unchanged; old archie.chat.dock key migrated into archie.chat.dock.v2 and removed. - ui/test/chat-dock-float.test.ts (new): 9 table-driven tests over the layout module. Commands run and results on this exact tree: - cd ui && pnpm test: 113 pass, 0 fail (incl. the 9 new tests). - pnpm run typecheck: clean. - pnpm run build: built in 1.74s. - task check from the worktree root: exit 0. - Browser check (vite dev server on 127.0.0.1:5197, headless Chrome; the dock was mounted in isolation because the local backend on 8484 requires org setup, so the full shell would not render): drag-anywhere with snap commit to the right pin (pin-r 460px, mode right stored), drag to the middle unpins to float, all 8 handles present with role=separator/tabindex=0/aria-label "Resize chat"/aria-orientation/valuenow, keyboard resize (se) and keyboard move (arrow keys) change the stored geometry, Left/Float/Right switch --chat-pin-l/r, minimise in place keeps position and the bar drags, Escape collapses, Ctrl+/ opens and closes, legacy localStorage key migrated and removed, phone width (390px) keeps the full-width bottom bar with no handles or mode controls.
sam closed this issue 2026-11-12 13:46:16 +00:00
Author
Owner

Rebased onto current main; PR !1912 is mergeable again (head 3c1ecc808).

The rebase kept both feature sets in ui/src/chat/ChatDock.vue: the float-anywhere window (free drag, 8-way resize, Left/Float/Right, edge snap, minimise in place, Ctrl+/ toggle, layout persisted under the new storage key with legacy migration, phone width keeps the bottom bar) and main's newer dock behavior (unseen reply badge + jump button, visualViewport keyboard offset on phone, swipe-down-to-hide).

Verified on the exact pushed tree (identical to the rebased commit): pnpm test, pnpm run typecheck, pnpm run build, and task check all exit 0.

Rebased onto current main; PR !1912 is mergeable again (head 3c1ecc808). The rebase kept both feature sets in ui/src/chat/ChatDock.vue: the float-anywhere window (free drag, 8-way resize, Left/Float/Right, edge snap, minimise in place, Ctrl+/ toggle, layout persisted under the new storage key with legacy migration, phone width keeps the bottom bar) and main's newer dock behavior (unseen reply badge + jump button, visualViewport keyboard offset on phone, swipe-down-to-hide). Verified on the exact pushed tree (identical to the rebased commit): pnpm test, pnpm run typecheck, pnpm run build, and task check all exit 0.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: sam/archie#1904