Skip to content

feat(player): adopt compact Throughline player with canonical styling - #48

Open
christophersesugh wants to merge 80 commits into
mainfrom
feat/port-player-prototype-ui
Open

christophersesugh wants to merge 80 commits into
mainfrom
feat/port-player-prototype-ui

Conversation

@christophersesugh

@christophersesugh christophersesugh commented Nov 16, 2026 •

Copy link
Copy Markdown
Contributor

Change

Adopt the standalone player design's compact composition as the default public schema-2 ThroughlineGraphPlayer, with the existing Throughline colour tokens and without copying the demo's model or playback engine.

  • Compact player header, Graph / Sequence / State tabs, frame/event heading and camera tools. The authored graph itself is preserved exactly: original node sizes/positions, edge routing, group structure, selection, focus, send/trail/aggregate highlights, and animations; only graph text sizing changes.
  • Responsive overlay inspector: at most 60% of wider player canvases (768px cap), full-width visualization overlay on narrow mobile embeds (≤560px), while the player header, view tabs, and transport remain usable for frame-by-frame inspection. One vertical inspector scroll; the evidence disclosure no longer creates a nested vertical scrollbar; long values wrap instead of being truncated.
  • Exact source-linked schema-2 projection, committed-state and message-phase distinctions, known/unknown/absent/null values, provenance IDs, evidence and causal limits, and the existing usePlayer seek reducer remain authoritative.
  • Source-evidence sequences retain the complete, independently paged message correlation/event log under inspector disclosure, even though the main view now uses dynamic lanes.
  • Namespace all player styles under .thl.player-shell, retaining canonical --thl-* palette. Package CSS remains offline; reference font loading is confined to Playground.
  • Production naming: player-chrome.tsx and player-layout.browser.test.tsx; original layoutGraph remains the sole graph geometry engine (no alternative layout implementation).
  • Playground now describes the new layout and keeps desktop/tablet/mobile, artifact and theme previews. No public API exports or schema changes; no ADR/spec/ticket additions.

Verification

Verified head: 8175024c4d866c6b7c9cb7c579dd7d2332ad7fb3. All CI checks passed on this exact head, including the proposed merge result.

  • TypeScript and Playground typecheck/build: passed.
  • Compiler, security, perf and hostile-input suite: 389/389 passed.
  • Chromium / Firefox / WebKit: 120/120 browser tests passed per engine. This includes authored graph geometry and routing, inspector 60%/100% responsive overlay, playback access and the single-scroll contract.
  • Runtime/license audits, distributable build, packed Node/React SSR+MDX and browser consumers, framework/Markdown hosts, and proposed merge-result integration verification: passed.
  • Automatic checks do not constitute human screen-reader testing or final visual acceptance. Maintain those separate release gates.

Integration

Do not merge or publish automatically. PR #45 (release candidate) and PR #46 (Playground authoring) remain separate and may require branch integration after maintainer review.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Nov 16, 2026 •

Copy link
Copy Markdown

Deploying throughline with  Cloudflare Pages  Cloudflare Pages

Latest commit: 943dc32
Status: ✅  Deploy successful!
Preview URL: https://0643fc71.throughline-218.pages.dev
Branch Preview URL: https://feat-port-player-prototype-u.throughline-218.pages.dev

View logs

@christophersesugh christophersesugh changed the title feat(player): port throughline-player prototype layout with canonical palette feat(player): adopt compact Throughline player with canonical styling Nov 16, 2026
@christophersesugh
christophersesugh marked this pull request as ready for review November 16, 2026 16:42

This branch has not been deployed

No deployments
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