From 100b0f01bac140fce6ba8828dac88011d21c930a Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 23 Oct 2026 14:39:15 +0000 Subject: [PATCH] Standards map polish: pack the families, steady hover, no draw-in - layoutGraph lays out each family of documents joined by dependencies on its own and packs them onto one column grid: the OAuth family top left, then the narrow ones first into the column runs with the highest floor. The drawing goes from 2151 to 1385 units tall and fills its plate. - Hover intent on the map: a node takes the highlight once the pointer rests on it (90ms), leaving clears after 160ms unless another node is reached; focus acts at once. Nodes and lines fade together over --dur (M19). - The spine draw-in and halo are gone from the map; the spine stays bold. M4 now covers the decorative plate only; the accessibility statement, design doc, plan and tasks (R-12) are updated. Co-Authored-By: Claude Opus 5.5 (1M context) Claude-Session: https://claude.ai/code/session_016ZfjWWhsQeCwo13HsJKZvm --- docs/design.md | 3 +- specs/016-visual-redesign/plan.md | 3 +- specs/016-visual-redesign/tasks.md | 1 + src/components/StandardsMap.astro | 82 ++----------- src/components/StandardsMap.svelte | 35 +++++- src/lib/graph.ts | 186 ++++++++++++++++++++++------- src/lib/standards.ts | 2 +- src/pages/accessibility.astro | 4 +- tests/e2e/standards.spec.ts | 83 +++++++++---- tests/unit/graph.test.ts | 9 ++ 10 files changed, 264 insertions(+), 144 deletions(-) diff --git a/docs/design.md b/docs/design.md index b26f276..4adc5c5 100644 --- a/docs/design.md +++ b/docs/design.md @@ -250,7 +250,7 @@ package of the redesign that builds it. Anything not in this table does not anim | M1 | Every page | Cross-document view transition, root crossfade 220ms | continuity | none (as today) | WP2 | | M2 | Home → `/mcp/`, `/standards/` → spec, `/explorer/` → scenario | Shared `view-transition-name` on the data view (matrix plate from `MatrixThumb.astro` as `matrix`, map; on the explorer, the scenario title into the page h1) so it morphs instead of crossfading | "this is the same object, larger" | none | WP3, WP5, WP6 | | M3 | Home facts, server page facts, spec page facts (`Facts.astro`) | Count-up from 0 to the value, 600ms, once, when 50% in view, tabular figures | "these are live numbers" | value rendered at once | WP3 | -| M4 | Standards map, decorative plate | Highlighted path draws in (`stroke-dashoffset`), 1200ms, halo fades after, once on load | "follow this path" | path shown complete | WP5, WP8 | +| M4 | Decorative plate | Highlighted path draws in (`stroke-dashoffset`), 1200ms, halo fades after, once on load. The standards map dropped its draw-in in review follow-up R-12: on a merged trunk only one or two arrows moved, so it read as a glitch; the spine is drawn bold and still | "follow this path" | path shown complete | WP5, WP8 | | M5 | Explorer chain | Per step: the sender and receiver light up in the actor head, the current arrow draws in (300ms, ease-out), the body fades up 8px (220ms); earlier steps keep a quieter arrow and later ones a hairline, in colour, not opacity, so text keeps its contrast | "you are here" | arrow and body shown, highlight and dimming applied without transition | WP6, R-08 | | M6 | Explorer chain | One scene clock (a Web Animations API timeline) holds the playhead; Play, Pause, Previous, Next, the scrub bar, a click on a step or a log line and the arrow keys all move it. Steps advance every 2.5 s. Auto-advance (amended by review follow-up 8): armed once per page, it starts when the chain has sat in view for 1 s with no input, and stops for good on hover, touch, focus, scroll or any key; it never restarts by itself and never starts with a step in the URL. Play, once pressed, pauses on any click, key or scroll | guided reading | Play button hidden, no auto-advance; the scrub bar and the step buttons still seek | WP6, R-08 | | M7 | Explorer token view | On step change, claims that differ from the previous hop get a 2px `--signal` rail that fades to `--rule` over 480ms, starting when the message has drawn (300ms) and 40ms apart | "this is what changed in the token" | rail shown without fade | WP6, R-08 | @@ -265,6 +265,7 @@ package of the redesign that builds it. Anything not in this table does not anim | M16 | Theme toggle | Icon swap only; no rotation | n/a | n/a | WP2 | | M17 | Explorer toggles | A toggle link swaps the chain in place (crumbs, toggles, notice, steps) through a same-document view transition, 220ms; steps the two chains share morph, the rest fade, and M8 runs on the new rails. The toggle stays its own static page for a reload, a new tab or no JS | "the same chain, with one thing changed" | ordinary navigation | R-08 | | M18 | Explorer chain | A quiet decision log under the chain gains one line per step reached (number, sender → receiver, message), the newest fading in over 220ms; a line seeks back to its step | "what has happened so far" | lines appear | R-08 | +| M19 | Standards map | Neighbourhood highlight on hover once the pointer rests on a node for 90ms, at once on keyboard focus: the other nodes and lines fade to 18% over 220ms and the node's own lines take full colour; leaving clears after 160ms unless the pointer reaches another node, so a sweep across the map moves the highlight once instead of flashing the drawing | "these are related" | the same delays, the fade instant | R-12 | Removed from the site by the redesign: the pulsing dot in the work-in-progress banner (it loops), the hover lifts on cards, buttons and the hero thumbnail, the rotating theme toggle, the ambient diff --git a/specs/016-visual-redesign/plan.md b/specs/016-visual-redesign/plan.md index 5b6a875..fdbc118 100644 --- a/specs/016-visual-redesign/plan.md +++ b/specs/016-visual-redesign/plan.md @@ -202,7 +202,7 @@ package that builds it. Anything not in this table does not animate. | M1 | Every page | Cross-document view transition, root crossfade 220ms | continuity | none (as today) | WP2 | | M2 | Home → `/mcp/`, `/standards/` → spec, `/explorer/` → scenario | Shared `view-transition-name` on the data view (matrix plate, map, chain head) so it morphs instead of crossfading | "this is the same object, larger" | none | WP3, WP5, WP6 | | M3 | Home facts, server page facts | Count-up from 0 to the value, 600ms, once, when 50% in view, tabular figures | "these are live numbers" | value rendered at once | WP3 | -| M4 | Standards map, decorative plate | Highlighted path draws in (`stroke-dashoffset`), 1200ms, halo fades after, once on load | "follow this path" | path shown complete | WP5, WP8 | +| M4 | Decorative plate | Highlighted path draws in (`stroke-dashoffset`), 1200ms, halo fades after, once on load. The standards map dropped its draw-in in review follow-up R-12: on a merged trunk only one or two arrows moved, so it read as a glitch; the spine is drawn bold and still | "follow this path" | path shown complete | WP5, WP8 | | M5 | Explorer chain | Per step: the sender and receiver light up in the actor head, the current arrow draws in (300ms, ease-out), the body fades up 8px (220ms); earlier steps keep a quieter arrow and later ones a hairline, in colour, not opacity, so text keeps its contrast | "you are here" | arrow and body shown, highlight and dimming applied without transition | WP6, R-08 | | M6 | Explorer chain | One scene clock (a Web Animations API timeline) holds the playhead; Play, Pause, Previous, Next, the scrub bar, a click on a step or a log line and the arrow keys all move it. Steps advance every 2.5 s. Auto-advance (amended by review follow-up 8): armed once per page, it starts when the chain has sat in view for 1 s with no input, and stops for good on hover, touch, focus, scroll or any key; it never restarts by itself and never starts with a step in the URL. Play, once pressed, pauses on any click, key or scroll | guided reading | Play button hidden, no auto-advance; the scrub bar and the step buttons still seek | WP6, R-08 | | M7 | Explorer token view | On step change, claims that differ from the previous hop get a 2px `--signal` rail that fades to `--rule` over 480ms, starting when the message has drawn (300ms) and 40ms apart | "this is what changed in the token" | rail shown without fade | WP6, R-08 | @@ -217,6 +217,7 @@ package that builds it. Anything not in this table does not animate. | M16 | Theme toggle | Icon swap only; no rotation | — | — | WP2 | | M17 | Explorer toggles | A toggle link swaps the chain in place (crumbs, toggles, notice, steps) through a same-document view transition, 220ms; steps the two chains share morph, the rest fade, and M8 runs on the new rails. The toggle stays its own static page for a reload, a new tab or no JS | "the same chain, with one thing changed" | ordinary navigation | R-08 | | M18 | Explorer chain | A quiet decision log under the chain gains one line per step reached (number, sender → receiver, message), the newest fading in over 220ms; a line seeks back to its step | "what has happened so far" | lines appear | R-08 | +| M19 | Standards map | Neighbourhood highlight on hover once the pointer rests on a node for 90ms, at once on keyboard focus: the other nodes and lines fade to 18% over 220ms and the node's own lines take full colour; leaving clears after 160ms unless the pointer reaches another node, so a sweep across the map moves the highlight once instead of flashing the drawing | "these are related" | the same delays, the fade instant | R-12 | Explicitly removed from today's site: the pulsing dot in the work-in-progress banner (it loops), the hover lifts on cards, buttons and the hero thumbnail, the rotating theme toggle, the ambient diff --git a/specs/016-visual-redesign/tasks.md b/specs/016-visual-redesign/tasks.md index cdf87ac..0ea641b 100644 --- a/specs/016-visual-redesign/tasks.md +++ b/specs/016-visual-redesign/tasks.md @@ -205,3 +205,4 @@ Items from the redesign review, one pull request each, in order. - [x] R-09 Content pass (WP9 above): section-root headlines under 24 characters, the title suffix and footer statement, an accessibility statement that lists every motion with its reduced-motion form, `check:prose` as a gate, and the about, contribute, made-in-Europe, legal and 404 pages in plain English - [x] R-10 Decorative plate (WP8 above): a deterministic miniature delegation chain in the head of the explorer and breach indexes and every spec page, beside the title on wide screens, drawn in once (M4) and complete under reduced motion, with social cards for the two section roots from the same generator - [x] R-11 Spec page composition: under the head, relations and features take the wide column and a panel beside them holds the figures (revisions, relations, features, counting up as M3) and the revision timeline (its rail drawing in as M13, the entries still so their contrast holds), sticky as on a breach page; below 60rem the panel follows the relations. Relation groups and feature topics pack into columns (`columns: 19rem`) instead of one long list; a group heading is the verb phrase alone ("Builds on", "Is built on by") and the source link follows the note. Features group by topic under a bar of how many carry each level, named in words beside it. A spec with no recorded features shows a sentence in the panel, not a zero and not an empty section. The withdrawn or expired notice moves into the main column. Baselines through the `refresh-screenshots` label +- [x] R-12 Standards map polish (asked by Jan): the drawing is about a third shorter and fills its plate. `layoutGraph` lays out each family of documents joined by dependencies on its own and packs them onto one column grid: the largest (the OAuth family) goes top left, then the narrow ones first, each into the run of columns whose floor is highest up, so the standalone documents stack by body beside the long first column and the WIMSE, SD-JWT and EU families fill the room under the MCP column instead of a row under everything (2151 to 1385 units tall at today's data). The hover highlight waits for the pointer to rest on a node (90ms) and clears 160ms after it leaves unless it reaches another node, so a sweep across the map no longer flashes the whole drawing; keyboard focus acts at once; nodes and lines fade together over `--dur` (M19, new). The spine draw-in and its halo are gone from the map (on the merged trunk only one or two arrows moved): the spine stays bold and still; M4 now covers the decorative plate only. Baselines through the `refresh-screenshots` label diff --git a/src/components/StandardsMap.astro b/src/components/StandardsMap.astro index edfacf3..8af0c74 100644 --- a/src/components/StandardsMap.astro +++ b/src/components/StandardsMap.astro @@ -32,9 +32,9 @@ const usedMaturities = MATURITY_ORDER.filter((m) => specs.some((s) => s.maturity // references are the most and the least telling lines, so the map opens without them const shownByDefault = (t: RelationType) => t !== "references"; -// M4: the longest builds-on chain draws in from the oldest document to the newest +// the longest builds-on chain is drawn bold, from the oldest document to the newest const spine = buildsOnSpine(specs, relations); -const spineStep = new Map(spine.map((r, i) => [`${r.from}|${r.type}|${r.to}`, i])); +const onSpine = new Set(spine.map((r) => `${r.from}|${r.type}|${r.to}`)); const spineFirst = spine[0] ? byId.get(spine[0].to) : undefined; const spineLast = spine.at(-1) ? byId.get(spine.at(-1)?.from ?? "") : undefined; @@ -61,10 +61,10 @@ const unchecked = (name: string, value: string) => const filterCss = [ ...usedTypes.map( (t) => - `${unchecked("type", t)} :is(#map .edge-${t}, #map .spine-halo[data-type="${t}"]) { visibility: hidden }\n` + + `${unchecked("type", t)} #map .edge-${t} { visibility: hidden }\n` + `${unchecked("type", t)} #spec-list .xl[data-type="${t}"] { display: none }`, ), - `${scope}:has(input[name="view"][value="recent"]:checked) :is(#map .node:not([data-recent]), #map .band, #map .edge, #map .spine-halo) { opacity: 0.2 }`, + `${scope}:has(input[name="view"][value="recent"]:checked) :is(#map .node:not([data-recent]), #map .band, #map .edge) { opacity: 0.2 }`, `${scope}:has(input[name="view"][value="recent"]:checked) #spec-list li:not([data-recent]) > .row { opacity: 0.35 }`, ...bodies.map( (b) => @@ -191,35 +191,17 @@ const filterCss = [