LearnNewsExamplesServices
Frontmatter
id15165
titleMake Workstation dock composition adapt to viewport width
stateClosed
labels
enhancementdesignaitesting
assigneesneo-gpt-emmy
createdAt10:12 AM
updatedAt12:00 PM
githubUrlhttps://github.com/neomjs/neo/issues/15165
authorneo-gpt-emmy
commentsCount0
parentIssue13158
subIssues[]
subIssuesCompleted0
subIssuesTotal0
contentTrust
projected
quarantined0
signals[]
blockedBy[]
blocking[]
closedAt12:00 PM

Make Workstation dock composition adapt to viewport width

Closed Backlog/active-chunk-6 enhancementdesignaitesting
neo-gpt-emmy
neo-gpt-emmy commented on 10:12 AM

Context

Live viewport inspection of the standalone Workstation flagship falsified the idea that the root is frozen: the workspace does receive the new browser extent. The dock composition around it is not adaptive.

Neural Link DOM rectangles and computed styles at two controlled Playwright viewports show the failure:

Surface 1280px viewport 900px viewport Behavior
dock edge row 1256px 876px responds
left edge band 260px 260px fixed
right edge band 320px 320px fixed
bottom band 200px high 200px high fixed
center split 641px 261px absorbs the entire width loss
primary grid 379px 151px crushed

At 900px the fixed left/right bands consume 580px before rails and gaps, leaving the central split only 261px. The app technically resizes, but the flagship layout merely compresses its primary work surface.

Live latest-open plus all-state A2A sweep at 2026-07-14T08:12:55.590Z: no equivalent ticket or overlapping claim found. Exact/all-state GitHub and Knowledge Base searches for Workstation responsive resizing also returned no equivalent.

The Problem

Workstation's edge-zone composition encodes desktop-max dimensions as unconditional dimensions. Browser resizing therefore preserves secondary columns at full size while sacrificing the central 100k-row work surface. This is the opposite of a responsive workstation hierarchy.

The problem is app projection policy, not dockZone.v1: the model's sizes ratios correctly govern children inside split nodes, but the edge-band CSS sits outside those ratios.

The Architectural Reality

  • resources/scss/src/apps/workstation/Workspace.scss:62 fixes the left band at 260px.
  • resources/scss/src/apps/workstation/Workspace.scss:66 fixes the right band at 320px.
  • resources/scss/src/dashboard/Container.scss:136 supplies generic fixed edge-band defaults, including the 200px bottom band.
  • apps/workstation/tour/denseWorkstation.mjs:41 owns the semantic zone/split document. Responsive visual extents must not rewrite that persisted topology merely to solve CSS sizing.
  • WorkstationNL.spec.mjs already owns live composition geometry and is the correct consumer for resize-without-reload evidence.

The Fix

Add an app-owned adaptive desktop sizing policy for the Workstation edge bands and bottom band.

  1. Replace unconditional Workstation edge widths with bounded responsive values (for example clamp() / container-query-owned tokens) that retain the intended maxima at wide desktop extents.
  2. Give the bottom evidence band a bounded responsive height rather than inheriting an unconditional 200px at every viewport.
  3. Preserve the dockZone.v1 document and split ratios; this ticket changes projection geometry, not persisted topology.
  4. Add a whitebox resize journey that changes the same browser from 1280px to 900px without reload and reads computed rectangles after layout settles.

Acceptance Criteria

  • Resizing the live browser from 1280px to 900px changes the computed left/right edge-band widths without reloading or rebuilding the dock document.
  • At 1280px and above, the current visual maxima (260px left, 320px right, 200px bottom) remain available.
  • At 900px, the center split is at least 400px wide and the primary grid is at least 230px wide; neither is clipped outside the dock host.
  • The bottom band yields vertical space at shorter desktop viewports instead of remaining unconditionally 200px.
  • Tab overflow, auto-hide rails, split ratios, live Store identities, and the running feed remain intact through the resize.
  • A focused Workstation whitebox E2E pins before/after computed rectangles on the same page.

Out of Scope

Phone/mobile composition below the 900px desktop floor · changing dockZone.v1 · saving viewport-specific perspectives · generic dashboard edge-band defaults · redesigning pane content.

Avoided Traps

  • Do not treat root resize delivery as proof of responsive composition.
  • Do not hardcode a second set of JavaScript pixel widths when CSS owns this projection policy.
  • Do not mutate or normalize the persisted dock document on every browser resize.

Related

Origin Session ID: adddb25d-fc36-4b08-b9a3-3a62a108cda1

Retrieval Hint: Workstation viewport 1280 900 fixed edge bands 260 320 center split 261 primary grid 151 responsive composition

tobiu referenced in commit 0d15dc3 - "feat(workstation): adapt dock composition to viewport (#15165) (#15169)" on 12:00 PM
tobiu closed this issue on 12:00 PM