Public: anyone can read this; the crew can change it.
The plan map is a component in docs/design/areas/map.md, and its classes leave §5d #5509
Check · Review · Land · Live done — Landed and live in production.
mason/forge:mason/5495-the-plan-map-is-a-component-in-docs-desi → main 1 commit fork
2 files
changed +26
−20
docs/DESIGN.md −20
| @@ -558,26 +558,6 @@ the same line (#4888). | ||
| 558 | 558 | - `.wd` |
| 559 | 559 | - **`style/content.ts`, apps, runs, and the crew** — run pages, their logs and checks (a pull's look is §5's **look**). |
| 560 | 560 | - **`pages/board.ts`** — the board itself is §5's **board**; the spend tables `spend.ts` draws wear §5's `.table` and `.stack`, no class of their own |
| 561 | - **`pages/map.ts`** — the map of what waits for what: | |
| 562 | - `.map-ask` | |
| 563 | - `.map-breath` | |
| 564 | - `.map-canvas` | |
| 565 | - `.map-card` | |
| 566 | - `.map-dot` | |
| 567 | - `.map-edge` | |
| 568 | - `.map-edge-crit` | |
| 569 | - `.map-edge-done` | |
| 570 | - `.map-main` | |
| 571 | - `.map-meta` | |
| 572 | - `.map-node` | |
| 573 | - `.map-rule` | |
| 574 | - `.map-svg` | |
| 575 | - `.map-title` | |
| 576 | - `.map-who` | |
| 577 | - `.map-who-i` | |
| 578 | - `.map-who-n` | |
| 579 | - `.map-word` | |
| 580 | - `.map-wrap` | |
| 581 | 561 | - **`studio/feed_style.ts`** — the home feed's cards and its composer (the apps rail is §5's card, row and btn; an admin's tick boxes and Archive are always shown, deliberately, with no Select toggle): |
| 582 | 562 | - `.feed` |
| 583 | 563 | - `.feed-head` |
docs/design/areas/map.md added +26
| @@ -0,0 +1,26 @@ | ||
| 1 | # Plan map | |
| 2 | ||
| 3 | The map of what waits for what (`/:owner/:name/map`): one SVG of the repository's open issues as cards, laid out by | |
| 4 | dependency, with the edges between them and the pillars beside it. `mapPage` in `src/web/pages/map.ts` draws the page and `drawMap` | |
| 5 | the SVG; `mapCss` there holds every rule below. A card's state (ready, working, blocked, waiting, parked, held, deferred, done) | |
| 6 | is `data-state` on `.map-node`, not a class. | |
| 7 | ||
| 8 | - `.map-wrap` — the page's two-column grid: the canvas, then the 272px side column; one column under 860px. | |
| 9 | - `.map-main` — the canvas column; `min-width: 0` so a wide map never pushes the side column off the page. | |
| 10 | - `.map-canvas` — the bordered frame the SVG sits in; `is-view`, `is-drag` and `is-cut` say whether it pans, is being dragged, or is cut off with a fade. | |
| 11 | - `.map-svg` — the map's SVG itself, full width; its text uses the page font and never takes the pointer. | |
| 12 | - `.map-rule` — the labelled line across the map above the issues that are "not linked" to any other. | |
| 13 | - `.map-node` — one issue's card, a link to the issue; `data-state` sets its colours. | |
| 14 | - `.map-card` — the card's rectangle, filled and stroked by the node's state. | |
| 15 | - `.map-breath` — the soft accent ring around a card being worked on. | |
| 16 | - `.map-title` — the issue's title on the card. | |
| 17 | - `.map-meta` — the issue's number, in tabular figures. | |
| 18 | - `.map-who` — the assignee's mark: a circle with an initial and a name. | |
| 19 | - `.map-who-i` — the assignee's initial inside the circle. | |
| 20 | - `.map-who-n` — the assignee's name beside it. | |
| 21 | - `.map-word` — the state's word at the card's right edge. | |
| 22 | - `.map-dot` — the coloured dot before the state's word. | |
| 23 | - `.map-edge` — one dependency edge between two cards. | |
| 24 | - `.map-edge-crit` — an edge on the critical path, in the accent. | |
| 25 | - `.map-edge-done` — an edge with a closed issue at either end, faded. | |
| 26 | - `.map-ask` — a pillar row's lead-time figures in the side column, inline, with the hover title saying what they measure. |
new above
offline