Skip to content

docs(layout): document the mouse-override icon in the pane-header spec#154

Open
dormouse-bot wants to merge 1 commit into
mainfrom
fix/layout-spec-mouse-icon
Open

docs(layout): document the mouse-override icon in the pane-header spec#154
dormouse-bot wants to merge 1 commit into
mainfrom
fix/layout-spec-mouse-icon

Conversation

@dormouse-bot

Copy link
Copy Markdown
Collaborator

What

The pane-header section of docs/specs/layout.md omitted the mouse-reporting override icon entirely — it was absent from both the "Elements from left to right" list and the responsive-tier breakdown.

The icon has lived in the header for a while (defined in docs/specs/mouse-and-clipboard.md), but #148 made its tier behavior concrete: it now drops at the minimal tier (showMouseIcon && tier !== 'minimal' in TerminalPaneHeader.tsx). That change updated the code without updating layout.md, leaving the placement/tier spec — which AGENTS.md designates as the source of truth for header element placement and sizing — incomplete.

Changes (docs only)

  • Add the mouse-reporting override icon to the header element list, in its actual position (after the flexible gap, before the split icons).
  • Cross-reference docs/specs/mouse-and-clipboard.md for its visual states/behavior, mirroring how the bell and TODO pill point at alert.md.
  • Update the three tier descriptions: the icon is visible in the full and compact tiers and hidden in minimal, and it only appears at all when the inside program requests mouse reporting.

Verification

Cross-checked against the source: the render order in lib/src/components/wall/TerminalPaneHeader.tsx places the icon between the flexible (flex-1 overflow-hidden) region and the tier === 'full' split/zoom block, gated on tier !== 'minimal'; tier thresholds (>280 full, >160 compact, else minimal) match the ResizeObserver callback. Terminology (CursorClickIcon / SelectionSlashIcon, "Mouse icon") matches mouse-and-clipboard.md.

No regression test — this is a documentation-only change with no runtime behavior.

…ment list and tiers

The pane-header spec omitted the mouse-reporting override icon from both
the element list and the responsive-tier breakdown. #148 made its tier
behavior concrete (hidden at the minimal tier) without updating the spec.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying mouseterm with  Cloudflare Pages  Cloudflare Pages

Latest commit: a75cb98
Status: ✅  Deploy successful!
Preview URL: https://4cf902a8.mouseterm.pages.dev
Branch Preview URL: https://fix-layout-spec-mouse-icon.mouseterm.pages.dev

View logs

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant