gabriel / musehub public
_devdocs.scss
1,209 lines 35.4 KB Hotspot
Raw
sha256:634da27c5b4ea6e3cb5aa9cfb4e58dbf922b627caef67ffb0cb64bcaf70b7b9f Merge task/246-identity-qa-v2 (#246 Cryptographic Identity … Opus 5.5 minor ⚠ breaking 9 days ago
1 // ─────────────────────────────────────────────────────────────────────────────
2 // Component: Developer docs (muse docs pages, /muse/*)
3 // File: src/scss/components/_devdocs.scss
4 //
5 // Visual rules for all devdocs-* classes. Structural layout lives in
6 // pages/_muse-docs.scss.
7 //
8 // Tokens: --color-accent, --color-accent-link, --color-purple, --color-warning
9 // --color-danger, --color-success, --text-primary/secondary/muted
10 // --bg-base, --bg-surface, --bg-overlay, --bg-hover, --bg-void
11 // --border-default, --border-subtle, --font-mono, --font-sans
12 // Usage: /muse and /muse/* developer documentation pages
13 // ─────────────────────────────────────────────────────────────────────────────
14
15 // ── Hero / index ──────────────────────────────────────────────────────────────
16
17 // Landing colour roles (musehub#243). The accent, link and status tokens are the same in both
18 // themes, and as text on the light theme they measure 1.4–2.7:1 (WCAG AA needs 4.5:1). The landing
19 // reads them through these roles: unchanged on the dark theme, and mixed toward --text-primary on
20 // the light one, which keeps each hue and gives at least 4.5:1 on every light surface.
21 // Interim: delete these roles (and DOC_LAND_19b's list) when musehub#283 fixes the theme tokens.
22 .devdocs-index {
23 --land-accent: var(--color-accent);
24 --land-link: var(--color-accent-link);
25 --land-success: var(--color-success);
26 --land-warning: var(--color-warning);
27 --land-purple: var(--color-purple);
28 }
29
30 [data-theme="light"] .devdocs-index {
31 --land-accent: color-mix(in srgb, var(--color-accent) 45%, var(--text-primary));
32 --land-link: color-mix(in srgb, var(--color-accent-link) 40%, var(--text-primary));
33 --land-success: color-mix(in srgb, var(--color-success) 45%, var(--text-primary));
34 --land-warning: color-mix(in srgb, var(--color-warning) 45%, var(--text-primary));
35 --land-purple: color-mix(in srgb, var(--color-purple) 45%, var(--text-primary));
36 }
37
38 .devdocs-hero {
39 border-bottom: 1px solid var(--border-default);
40 }
41
42 .devdocs-eyebrow {
43 display: block;
44 font-size: 11px;
45 font-weight: 600;
46 letter-spacing: 0.08em;
47 text-transform: uppercase;
48 color: var(--land-accent, var(--color-accent));
49 margin-bottom: var(--space-2);
50 }
51
52 .devdocs-hero-title {
53 font-size: clamp(28px, 5vw, 44px);
54 font-weight: 300;
55 color: var(--land-accent, var(--color-accent));
56 letter-spacing: -0.02em;
57 line-height: 1.1;
58 margin: 0 0 var(--space-4);
59 }
60
61 .devdocs-hero-lead {
62 font-size: var(--text-md);
63 color: var(--text-secondary);
64 line-height: 1.65;
65 max-width: 640px;
66 margin: 0 0 var(--space-6);
67
68 a { color: var(--land-link, var(--color-accent-link)); }
69 }
70
71 .devdocs-h2 {
72 font-size: 18px;
73 font-weight: 700;
74 color: var(--text-primary);
75 margin: var(--space-8) 0 var(--space-2);
76 letter-spacing: -0.01em;
77 }
78
79 // ── Stat cluster ──────────────────────────────────────────────────────────────
80
81 .devdocs-stat {
82 text-align: right;
83
84 @media (max-width: 640px) { text-align: left; }
85 }
86
87 .devdocs-stat-num {
88 display: block;
89 font-size: 24px;
90 font-weight: 800;
91 color: var(--text-primary);
92 font-family: var(--font-mono);
93 line-height: 1;
94 }
95
96 .devdocs-stat-label {
97 font-size: 11px;
98 color: var(--text-secondary);
99 letter-spacing: 0.04em;
100 }
101
102 // ── Phase index cards ─────────────────────────────────────────────────────────
103
104 .devdocs-phase-card {
105 display: flex;
106 flex-direction: column;
107 gap: var(--space-3);
108 padding: var(--space-5);
109 border-radius: 10px;
110 border: 1px solid var(--border-default);
111 background: var(--bg-surface);
112 text-decoration: none;
113 transition: border-color 0.15s, background 0.15s;
114
115 &:hover {
116 border-color: var(--color-accent);
117 background: var(--bg-overlay);
118 text-decoration: none;
119 }
120
121 &--active {
122 background: color-mix(in srgb, var(--color-accent) 5%, var(--bg-surface));
123 }
124 }
125
126 .devdocs-phase-card__num {
127 font-size: 11px;
128 font-family: var(--font-mono);
129 font-weight: 700;
130 color: var(--land-accent, var(--color-accent));
131 }
132
133 .devdocs-phase-card__title {
134 font-size: 15px;
135 font-weight: 600;
136 color: var(--text-primary);
137 margin: 0;
138 }
139
140 .devdocs-phase-card__desc {
141 font-size: 13px;
142 color: var(--text-secondary);
143 margin: 0;
144 line-height: 1.5;
145 }
146
147 .devdocs-tag {
148 font-size: 11px;
149 font-family: var(--font-mono);
150 padding: 1px 6px;
151 border-radius: 4px;
152 background: var(--bg-overlay);
153 color: var(--text-muted);
154 border: 1px solid var(--border-subtle);
155 }
156
157 // ── Sidebar nav ───────────────────────────────────────────────────────────────
158
159 .devdocs-nav-group-label {
160 font-size: 10px;
161 font-weight: 700;
162 letter-spacing: 0.1em;
163 text-transform: uppercase;
164 color: var(--text-muted);
165 margin-bottom: var(--space-2);
166 padding: 0 var(--space-2);
167 }
168
169 .devdocs-nav-link {
170 display: block;
171 font-size: 13px;
172 color: var(--text-secondary);
173 text-decoration: none;
174 padding: 4px var(--space-2);
175 border-radius: 5px;
176 transition: color 0.1s, background 0.1s;
177 line-height: 1.4;
178
179 &:hover {
180 color: var(--text-primary);
181 background: var(--bg-overlay);
182 text-decoration: none;
183 }
184
185 &--active {
186 color: var(--color-accent-link);
187 background: color-mix(in srgb, var(--color-accent) 8%, transparent);
188 }
189
190 &--phase { font-weight: 500; }
191
192 &--sub {
193 font-size: 12px;
194 color: var(--text-muted);
195 padding-left: var(--space-4);
196 }
197 }
198
199 // ── Content area ──────────────────────────────────────────────────────────────
200
201 .devdocs-content {
202 border-left: 1px solid var(--border-subtle);
203 @media (max-width: 768px) { border-left: none; }
204 }
205
206 // ── Phase header ──────────────────────────────────────────────────────────────
207
208 .devdocs-phase-header {
209 border-bottom: 1px solid var(--border-default);
210 }
211
212 .devdocs-phase-num {
213 display: block;
214 font-size: 11px;
215 font-family: var(--font-mono);
216 font-weight: 700;
217 color: var(--color-accent);
218 letter-spacing: 0.06em;
219 margin-bottom: var(--space-2);
220 }
221
222 .devdocs-phase-title {
223 font-size: clamp(24px, 4vw, 34px);
224 font-weight: 800;
225 color: var(--text-primary);
226 letter-spacing: -0.02em;
227 margin: 0 0 var(--space-3);
228 line-height: 1.15;
229 }
230
231 .devdocs-phase-desc {
232 font-size: var(--text-base);
233 color: var(--text-secondary);
234 line-height: 1.7;
235 max-width: 600px;
236 margin: 0;
237 }
238
239 // ── Sections ──────────────────────────────────────────────────────────────────
240
241 .devdocs-section-title {
242 font-size: 20px;
243 font-weight: 700;
244 color: var(--text-primary);
245 margin: 0 0 var(--space-2);
246 letter-spacing: -0.01em;
247 scroll-margin-top: 72px;
248
249 a { color: inherit; text-decoration: none; &:hover { color: var(--color-accent-link); } }
250 }
251
252 .devdocs-subsection-title {
253 font-size: 15px;
254 font-weight: 600;
255 color: var(--text-primary);
256 margin: var(--space-6) 0 var(--space-2);
257 scroll-margin-top: 72px;
258
259 a { color: inherit; text-decoration: none; &:hover { color: var(--color-accent-link); } }
260 }
261
262 .devdocs-content p {
263 font-size: var(--text-base);
264 color: var(--text-secondary);
265 line-height: 1.7;
266 margin: 0 0 var(--space-4);
267
268 code {
269 font-size: 13px;
270 background: var(--bg-overlay);
271 border: 1px solid var(--border-default);
272 border-radius: 4px;
273 padding: 1px 5px;
274 color: var(--color-purple);
275 font-family: var(--font-mono);
276 }
277
278 a { color: var(--color-accent-link); text-decoration: none; &:hover { text-decoration: underline; } }
279 }
280
281 // ── Code blocks ───────────────────────────────────────────────────────────────
282
283 .devdocs-code-block {
284 border-radius: 8px;
285 border: 1px solid var(--border-default);
286 overflow: hidden;
287 background: var(--bg-base);
288
289 pre {
290 margin: 0;
291 padding: var(--space-4) var(--space-5);
292 font-size: 13px;
293 font-family: var(--font-mono);
294 line-height: 1.65;
295 color: #abb2bf;
296 overflow-x: auto;
297 background: transparent;
298 border: none;
299 border-radius: 0;
300 }
301
302 .tok-kw { color: #c678dd; }
303 .tok-str { color: #98c379; }
304 .tok-num { color: #d19a66; }
305 .tok-cmt { color: #5c6370; font-style: italic; }
306 .tok-key { color: #e06c75; }
307 .tok-fn { color: #61afef; }
308 .tok-type{ color: #e5c07b; }
309 .tok-var { color: #abb2bf; }
310 .tok-punc{ color: #abb2bf; }
311 .tok-acc { color: #56b6c2; }
312
313 &--output {
314 background: var(--bg-void);
315 border-color: var(--border-subtle);
316 margin-top: -1px;
317 border-top-left-radius: 0;
318 border-top-right-radius: 0;
319
320 pre { color: #7a8394; }
321
322 .tok-key { color: #c97575; }
323 .tok-str { color: #7aaa6a; }
324 .tok-num { color: #b5824d; }
325 .tok-kw { color: #a05cb5; }
326 }
327 }
328
329 .devdocs-code-header {
330 display: flex;
331 align-items: center;
332 justify-content: space-between;
333 padding: 6px 12px;
334 background: var(--bg-overlay);
335 border-bottom: 1px solid var(--border-default);
336 }
337
338 .devdocs-code-lang {
339 font-size: 11px;
340 font-weight: 600;
341 font-family: var(--font-mono);
342 color: var(--text-muted);
343 letter-spacing: 0.04em;
344 text-transform: uppercase;
345 }
346
347 .devdocs-code-label {
348 font-size: 11px;
349 color: var(--text-muted);
350 font-style: italic;
351 }
352
353 // ── Tables ────────────────────────────────────────────────────────────────────
354
355 .devdocs-table {
356 width: 100%;
357 font-size: 13px;
358 border-collapse: collapse;
359 margin: var(--space-4) 0;
360 display: block;
361 overflow-x: auto;
362 -webkit-overflow-scrolling: touch;
363
364 th {
365 text-align: left;
366 font-size: 11px;
367 font-weight: 700;
368 letter-spacing: 0.06em;
369 text-transform: uppercase;
370 color: var(--text-muted);
371 padding: 6px 10px;
372 border-bottom: 1px solid var(--border-default);
373 }
374
375 td {
376 padding: 7px 10px;
377 border-bottom: 1px solid var(--border-subtle);
378 color: var(--text-secondary);
379 vertical-align: top;
380 line-height: 1.5;
381 }
382
383 tr:last-child td { border-bottom: none; }
384
385 td:first-child {
386 font-family: var(--font-mono);
387 font-size: 12px;
388 color: var(--color-purple);
389 white-space: nowrap;
390 }
391
392 td:nth-child(2) {
393 font-family: var(--font-mono);
394 font-size: 12px;
395 color: var(--text-muted);
396 }
397 }
398
399 // ── Callouts ──────────────────────────────────────────────────────────────────
400
401 .devdocs-callout {
402 display: flex;
403 gap: var(--space-3);
404 padding: var(--space-4);
405 border-radius: 8px;
406 border: 1px solid color-mix(in srgb, var(--color-accent) 25%, transparent);
407 background: color-mix(in srgb, var(--color-accent) 6%, transparent);
408 margin: var(--space-4) 0;
409 font-size: 13px;
410 color: var(--text-secondary);
411 line-height: 1.6;
412
413 &--warn {
414 border-color: color-mix(in srgb, var(--color-warning) 30%, transparent);
415 background: color-mix(in srgb, var(--color-warning) 6%, transparent);
416 }
417
418 code {
419 font-family: var(--font-mono);
420 font-size: 12px;
421 background: var(--bg-overlay);
422 border: 1px solid var(--border-default);
423 border-radius: 3px;
424 padding: 1px 5px;
425 color: var(--color-purple);
426 }
427 }
428
429 .devdocs-callout-icon {
430 flex-shrink: 0;
431 width: 16px;
432 height: 16px;
433 margin-top: 1px;
434 color: var(--color-accent);
435 .devdocs-callout--warn & { color: var(--color-warning); }
436 }
437
438 // ── Inline badges ─────────────────────────────────────────────────────────────
439
440 .devdocs-badge {
441 display: inline-block;
442 font-size: 10px;
443 font-weight: 700;
444 font-family: var(--font-mono);
445 padding: 1px 6px;
446 border-radius: 4px;
447 vertical-align: middle;
448 letter-spacing: 0.04em;
449
450 &--hard { background: color-mix(in srgb, var(--color-danger) 15%, transparent); color: var(--color-danger); border: 1px solid color-mix(in srgb, var(--color-danger) 25%, transparent); }
451 &--warn { background: color-mix(in srgb, var(--color-warning) 15%, transparent); color: var(--color-warning); border: 1px solid color-mix(in srgb, var(--color-warning) 25%, transparent); }
452 &--ok { background: color-mix(in srgb, var(--color-success) 15%, transparent); color: var(--color-success); border: 1px solid color-mix(in srgb, var(--color-success) 25%, transparent); }
453 &--info { background: color-mix(in srgb, var(--color-accent) 15%, transparent); color: var(--color-accent); border: 1px solid color-mix(in srgb, var(--color-accent) 25%, transparent); }
454 }
455
456 // ── Breadcrumb ────────────────────────────────────────────────────────────────
457
458 .devdocs-breadcrumb {
459 display: flex;
460 align-items: center;
461 gap: 6px;
462 font-size: 12px;
463 color: var(--text-muted);
464 margin-bottom: var(--space-6);
465
466 a { color: var(--color-accent-link); text-decoration: none; &:hover { text-decoration: underline; } }
467 span { color: var(--text-muted); }
468 }
469
470 // ── Phase prev/next nav ───────────────────────────────────────────────────────
471
472 .devdocs-phase-nav {
473 border-top: 1px solid var(--border-default);
474 }
475
476 .devdocs-phase-nav-btn {
477 display: flex;
478 align-items: center;
479 gap: 6px;
480 font-size: 13px;
481 font-weight: 500;
482 color: var(--text-secondary);
483 text-decoration: none;
484 padding: 6px 12px;
485 border-radius: 6px;
486 border: 1px solid var(--border-default);
487 transition: border-color 0.15s, color 0.15s;
488
489 &:hover {
490 border-color: var(--color-accent);
491 color: var(--color-accent-link);
492 text-decoration: none;
493 }
494 }
495
496 // ── Index intro divider ───────────────────────────────────────────────────────
497
498 .devdocs-index-intro {
499 border-bottom: 1px solid var(--border-default);
500 }
501
502 // ── Suggested reading paths (musehub#243) ─────────────────────────────────────
503 // A real table (goal → sections), so it resets the reference-table rules it would otherwise
504 // inherit: `display: block` + a nowrap mono first column made its min-content 554 px and widened
505 // the whole landing page on phones.
506
507 .devdocs-reading-paths__title { margin-top: 0; }
508
509 .devdocs-reading-paths__lead {
510 margin: var(--space-2) 0 var(--space-5);
511 font-size: 15px;
512 line-height: 1.6;
513 color: var(--text-secondary);
514 }
515
516 .devdocs-table.devdocs-reading-paths__table {
517 display: table;
518 table-layout: fixed;
519 overflow: visible;
520 margin: 0;
521
522 th[scope="col"] { color: var(--text-secondary); }
523 th[scope="col"]:first-child { width: 36%; }
524
525 th[scope="row"] {
526 padding: 9px 10px;
527 border-bottom: 1px solid var(--border-subtle);
528 vertical-align: top;
529 font-size: inherit;
530 font-weight: inherit;
531 letter-spacing: normal;
532 text-transform: none;
533 overflow-wrap: anywhere;
534 }
535
536 td {
537 padding: 9px 10px;
538 font-family: inherit;
539 font-size: inherit;
540 color: var(--text-secondary);
541 }
542
543 tr:last-child th { border-bottom: none; }
544 }
545
546 .devdocs-reading-path__goal {
547 display: block;
548 font-size: 14px;
549 font-weight: 700;
550 color: var(--text-primary);
551 }
552
553 .devdocs-reading-path__about {
554 display: block;
555 margin-top: 2px;
556 font-size: 13px;
557 line-height: 1.45;
558 color: var(--text-secondary);
559 }
560
561 .devdocs-reading-path__steps {
562 display: flex;
563 flex-wrap: wrap;
564 gap: 2px 0;
565 margin: 0;
566 padding: 0;
567 list-style: none;
568
569 li { margin: 0; }
570 li + li::before { content: "→" / ""; padding: 0 0.4em; color: var(--text-secondary); }
571 }
572
573 .devdocs-reading-path__step {
574 font-family: var(--font-mono);
575 font-size: 12px;
576 color: var(--land-link, var(--color-accent-link));
577 }
578
579 // ── Architecture concept map (musehub#243 V1) ─────────────────────────────────
580 // Server-rendered and complete without script: every concept is a link, and its
581 // summary, status and relations are visible text. docs.ts only adds tracing:
582 // on hover/focus it highlights the concept's neighbours and, at desktop widths,
583 // draws connector lines between them.
584
585 .cmap { margin: var(--space-8) 0 var(--space-10); }
586
587 .cmap-head { max-width: 720px; margin-bottom: var(--space-5); }
588 .cmap-title { margin-top: 0; }
589
590 .cmap-lead {
591 font-size: 14px;
592 color: var(--text-secondary);
593 line-height: 1.6;
594 margin: 0 0 var(--space-3);
595 }
596
597 .cmap-legend {
598 display: flex;
599 flex-wrap: wrap;
600 gap: var(--space-2);
601 list-style: none;
602 margin: 0;
603 padding: 0;
604 }
605
606 .cmap-board { position: relative; }
607
608 .cmap-wires {
609 position: absolute;
610 inset: 0;
611 width: 100%;
612 height: 100%;
613 overflow: visible;
614 pointer-events: none;
615 z-index: 2;
616 }
617
618 .cmap-wire {
619 fill: none;
620 stroke: var(--land-accent, var(--color-accent));
621 stroke-width: 1.5;
622 stroke-linecap: round;
623 opacity: 0.75;
624 }
625
626 .cmap-layers {
627 position: relative;
628 z-index: 1;
629 list-style: none;
630 margin: 0;
631 padding: 0;
632 display: grid;
633 gap: var(--space-5);
634 grid-template-columns: minmax(0, 1fr) minmax(0, 1.1fr) minmax(0, 1fr);
635 grid-template-areas:
636 "domains core merging"
637 "provenance core collaboration";
638 }
639
640 .cmap-layer {
641 min-width: 0;
642 padding: var(--space-4);
643 border: 1px solid var(--border-default);
644 border-radius: 12px;
645 background: var(--bg-surface);
646
647 &--core {
648 grid-area: core;
649 align-self: center;
650 border-color: color-mix(in srgb, var(--color-accent) 50%, var(--border-default));
651 background: color-mix(in srgb, var(--color-accent) 7%, var(--bg-surface));
652 }
653 &--domains { grid-area: domains; }
654 &--merging { grid-area: merging; }
655 &--provenance { grid-area: provenance; }
656 &--collaboration { grid-area: collaboration; }
657 }
658
659 .cmap-layer__title {
660 display: flex;
661 align-items: center;
662 gap: var(--space-2);
663 margin: 0;
664 font-size: 12px;
665 font-weight: 700;
666 letter-spacing: 0.06em;
667 text-transform: uppercase;
668 color: var(--text-primary);
669 }
670
671 .cmap-layer__step {
672 display: inline-grid;
673 place-items: center;
674 width: 20px;
675 height: 20px;
676 border-radius: 50%;
677 font-family: var(--font-mono);
678 font-size: 11px;
679 // Outlined, not filled: --bg-base text on the accent is 2.2:1 on the light theme (cf. #244 V1).
680 border: 1.5px solid var(--land-accent, var(--color-accent));
681 color: var(--text-primary);
682 }
683
684 .cmap-layer__question {
685 margin: var(--space-1) 0 var(--space-3);
686 font-size: 12px;
687 color: var(--text-secondary);
688 }
689
690 .cmap-layer__note {
691 margin: var(--space-3) 0 0;
692 font-size: 11px;
693 color: var(--text-secondary);
694 }
695
696 .cmap-nodes {
697 display: grid;
698 gap: var(--space-3);
699 list-style: none;
700 margin: 0;
701 padding: 0;
702 }
703
704 .cmap-item { transition: opacity 0.15s; }
705
706 .cmap-node {
707 display: grid;
708 grid-template-columns: minmax(0, 1fr) auto;
709 align-items: center;
710 gap: 2px var(--space-2);
711 padding: var(--space-2) var(--space-3);
712 border: 1px solid var(--border-subtle);
713 border-radius: 8px;
714 background: var(--bg-base);
715 color: inherit;
716 text-decoration: none;
717 transition: border-color 0.15s, box-shadow 0.15s;
718
719 &:hover { border-color: var(--land-accent, var(--color-accent)); text-decoration: none; }
720 &:focus-visible { outline: 2px solid var(--land-accent, var(--color-accent)); outline-offset: 2px; }
721 }
722
723 .cmap-node__label { font-size: 14px; font-weight: 600; color: var(--text-primary); }
724
725 .cmap-node__section {
726 grid-column: 1 / -1;
727 font-family: var(--font-mono);
728 font-size: 11px;
729 color: var(--land-link, var(--color-accent-link));
730 }
731
732 .cmap-node__about {
733 margin: var(--space-1) var(--space-3) 0;
734 font-size: 12px;
735 line-height: 1.5;
736 color: var(--text-secondary);
737
738 code { font-size: 11px; }
739 }
740
741 .cmap-rels {
742 list-style: none;
743 margin: 2px var(--space-3) 0;
744 padding: 0;
745 color: var(--text-secondary);
746 }
747
748 // Doubled class: page-level list rules would otherwise set the size of these items.
749 .cmap .cmap-rels li {
750 margin: 0;
751 font-size: 11px;
752 line-height: 1.6;
753
754 &::before { content: "→ " / ""; color: var(--land-accent, var(--color-accent)); }
755 }
756
757 .cmap-node__about a { color: var(--land-link, var(--color-accent-link)); }
758
759 .cmap-rel__verb { font-style: italic; }
760
761 .cmap-status {
762 justify-self: end;
763 padding: 1px 7px;
764 border: 1px solid currentColor;
765 border-radius: 999px;
766 font-size: 10px;
767 font-weight: 600;
768 letter-spacing: 0.04em;
769 text-transform: uppercase;
770 white-space: nowrap;
771
772 &--shipped { color: var(--land-success, var(--color-success)); }
773 &--opt-in { color: var(--land-warning, var(--color-warning)); }
774 &--not-wired { color: var(--land-purple, var(--color-purple)); border-style: dashed; }
775 &--not-built { color: var(--text-secondary); border-style: dashed; }
776 }
777
778 // Tracing state (set by docs.ts): the active concept and its neighbours stay bright.
779 .cmap--tracing .cmap-item { opacity: 0.35; }
780 .cmap--tracing .cmap-item--active,
781 .cmap--tracing .cmap-item--related { opacity: 1; }
782 .cmap-item--active .cmap-node {
783 border-color: var(--land-accent, var(--color-accent));
784 box-shadow: 0 0 0 3px color-mix(in srgb, var(--land-accent, var(--color-accent)) 25%, transparent);
785 }
786 .cmap-item--related .cmap-node {
787 border-color: color-mix(in srgb, var(--land-accent, var(--color-accent)) 60%, var(--border-default));
788 }
789
790 @media (max-width: 960px) {
791 .cmap-layers { grid-template-columns: minmax(0, 1fr); grid-template-areas: none; }
792 .cmap-layer[class] { grid-area: auto; }
793 // min(): a 320 px phone leaves a layer ~238 px for its nodes, less than the 240 px track.
794 .cmap-nodes { grid-template-columns: repeat(auto-fill, minmax(min(240px, 100%), 1fr)); }
795 .cmap-wires { display: none; }
796 }
797
798 @media (max-width: 480px) {
799 .cmap-layer { padding: var(--space-3); }
800 }
801
802 @media (prefers-reduced-motion: reduce) {
803 .cmap-item,
804 .cmap-node { transition: none; }
805 }
806
807 @media (forced-colors: active) {
808 .cmap-node { border-color: CanvasText; }
809 .cmap-item--active .cmap-node { outline: 2px solid Highlight; }
810 .cmap--tracing .cmap-item { opacity: 1; }
811 .cmap-wire { stroke: Highlight; }
812 }
813
814 // ── Shared docs figure (musehub#242 W7, DOC_INF_12) ───────────────────────────
815 // macros/docs_figure.html: a <figure> named by its caption title. The body is server-rendered,
816 // complete without script and readable as text, so it is its own text alternative.
817
818 .docfig {
819 margin: var(--space-6) 0 var(--space-8);
820 padding: var(--space-4);
821 border: 1px solid var(--border-default);
822 border-radius: 12px;
823 background: var(--bg-surface);
824 }
825
826 .docfig__caption {
827 display: grid;
828 gap: var(--space-1);
829 margin-bottom: var(--space-4);
830 }
831
832 .docfig__title { font-size: 15px; font-weight: 700; color: var(--text-primary); }
833 .docfig__lead { font-size: 13px; line-height: 1.55; color: var(--text-secondary); }
834 // Doubled class: the page's paragraph rules would otherwise set this line's size.
835 .docfig .docfig__source { margin: var(--space-3) 0 0; font-size: 11px; line-height: 1.5; color: var(--text-secondary); }
836
837 // ── First-push sequence (musehub#244 V1) ──────────────────────────────────────
838 // Three lanes: keychain | CLI | hub. DOM order is CLI → keychain → hub (the reading order);
839 // grid areas place the keychain on the left. Lifelines and connectors are CSS backgrounds.
840
841 .seqfig { --seq-line: var(--border-default); }
842
843 .seqfig__head,
844 .seqfig__step {
845 display: grid;
846 grid-template-columns: minmax(0, 1fr) minmax(0, 1.4fr) minmax(0, 1fr);
847 grid-template-areas: "keychain cli hub";
848 }
849
850 .seqfig__head { padding-bottom: var(--space-2); }
851
852 .seqfig__lane-name {
853 font-size: 11px;
854 font-weight: 700;
855 letter-spacing: 0.06em;
856 text-transform: uppercase;
857 text-align: center;
858 color: var(--text-secondary); // --text-muted is below AA at 11px on --bg-surface
859
860 &--keychain { grid-area: keychain; }
861 &--cli { grid-area: cli; }
862 &--hub { grid-area: hub; }
863 }
864
865 // Doubled class: page-level list rules would otherwise add markers and spacing.
866 .seqfig .seqfig__steps { list-style: none; margin: 0; padding: 0; counter-reset: seq; }
867 .seqfig .seqfig__step { counter-increment: seq; margin: 0; }
868
869 .seqfig__cell {
870 position: relative;
871 display: flex;
872 align-items: center;
873 justify-content: center;
874 min-width: 0;
875 padding: var(--space-2);
876 font-size: 12px;
877 line-height: 1.45;
878 text-align: center;
879
880 &--cli { grid-area: cli; }
881 &--keychain { grid-area: keychain; }
882 &--hub { grid-area: hub; }
883 }
884
885 // Lifelines: one vertical line down the middle of each lane.
886 .seqfig__cell--keychain,
887 .seqfig__cell--cli,
888 .seqfig__cell--hub {
889 background: linear-gradient(var(--seq-line), var(--seq-line)) center / 1px 100% no-repeat;
890 }
891
892 // A used lane connects to the CLI box with a horizontal line.
893 .seqfig__cell--keychain:not(.seqfig__cell--idle)::before,
894 .seqfig__cell--hub:not(.seqfig__cell--idle)::before {
895 content: "";
896 position: absolute;
897 top: 50%;
898 height: 2px;
899 background: var(--color-accent);
900 }
901 .seqfig__cell--keychain:not(.seqfig__cell--idle)::before { left: 50%; right: 0; }
902 .seqfig__cell--hub:not(.seqfig__cell--idle)::before { left: 0; right: 50%; }
903
904 .seqfig__msg {
905 position: relative;
906 z-index: 1;
907 max-width: 100%;
908 padding: 4px 8px;
909 border: 1px solid var(--color-accent);
910 border-radius: 8px;
911 background: var(--bg-base);
912 color: var(--text-primary);
913 overflow-wrap: anywhere;
914
915 code { font-size: 11px; }
916 }
917
918 .seqfig__cell--idle .seqfig__msg {
919 border-style: dashed;
920 border-color: var(--border-default);
921 color: var(--text-secondary);
922 }
923
924 .seqfig__box {
925 position: relative;
926 z-index: 1;
927 display: grid;
928 gap: 2px;
929 width: 100%;
930 padding: var(--space-2) var(--space-3) var(--space-2) calc(var(--space-3) + 24px);
931 border: 1px solid var(--border-default);
932 border-radius: 8px;
933 background: var(--bg-base);
934 text-align: left;
935
936 &::before {
937 content: counter(seq);
938 content: counter(seq) / ""; // numbered visually; the <ol> already numbers it for assistive tech
939 position: absolute;
940 left: var(--space-2);
941 top: var(--space-2);
942 display: inline-grid;
943 place-items: center;
944 width: 20px;
945 height: 20px;
946 border-radius: 50%;
947 font-family: var(--font-mono);
948 font-size: 11px;
949 // Outlined: --color-accent is the same light blue in both themes, so text on it fails AA in light (2.18:1).
950 border: 1.5px solid var(--color-accent);
951 background: var(--bg-surface);
952 color: var(--text-primary);
953 }
954 }
955
956 .seqfig__cmd {
957 color: var(--text-primary);
958 text-decoration: none;
959 &:hover { text-decoration: underline; }
960 &:focus-visible { outline: 2px solid var(--color-accent); outline-offset: 2px; }
961 code { font-size: 12px; font-weight: 600; }
962 }
963
964 .seqfig__local { color: var(--text-secondary); code { font-size: 11px; } }
965 // Mixed toward the text colour so small text stays AA in both themes (darker in light, lighter in dark).
966 .seqfig__signs { font-size: 11px; font-weight: 600; color: color-mix(in srgb, var(--color-success) 55%, var(--text-primary)); }
967 .seqfig__signs--none { font-weight: 400; color: var(--text-secondary); }
968
969 // The lane label is spoken in each cell; on wide screens the lane headers show it instead.
970 .seqfig__label {
971 position: absolute;
972 width: 1px;
973 height: 1px;
974 overflow: hidden;
975 clip-path: inset(50%);
976 white-space: nowrap;
977 }
978
979 @media (max-width: 640px) {
980 .seqfig__head { display: none; }
981 .seqfig__step {
982 grid-template-columns: minmax(0, 1fr);
983 grid-template-areas: "cli" "keychain" "hub";
984 padding-bottom: var(--space-3);
985 }
986 .seqfig__cell { justify-content: flex-start; padding: 2px 0 2px var(--space-5); text-align: left; }
987 .seqfig__cell--cli { padding-left: 0; }
988 .seqfig__cell--keychain,
989 .seqfig__cell--cli,
990 .seqfig__cell--hub { background: none; }
991 .seqfig__cell--keychain:not(.seqfig__cell--idle)::before,
992 .seqfig__cell--hub:not(.seqfig__cell--idle)::before { display: none; }
993 .seqfig__label { position: static; width: auto; height: auto; overflow: visible; clip-path: none; font-weight: 600; }
994 }
995
996 @media (forced-colors: active) {
997 .seqfig__msg,
998 .seqfig__box { border-color: CanvasText; }
999 .seqfig__cell--idle .seqfig__msg { border-color: GrayText; color: GrayText; }
1000 .seqfig__cell--keychain:not(.seqfig__cell--idle)::before,
1001 .seqfig__cell--hub:not(.seqfig__cell--idle)::before { background: CanvasText; }
1002 .seqfig__box::before { forced-color-adjust: none; background: Highlight; color: HighlightText; }
1003 }
1004
1005 @media (prefers-reduced-motion: reduce) {
1006 .seqfig__cmd { transition: none; }
1007 }
1008
1009 // ── Foundations figures (musehub#245 V1 ID derivation, V3 object graph) ───────
1010 // Static, server-rendered, readable as text in DOM order; theme tokens only.
1011
1012 .idfig {
1013 list-style: none;
1014 margin: 0;
1015 padding: 0;
1016 display: grid;
1017 gap: var(--space-3);
1018 grid-template-columns: repeat(auto-fit, minmax(min(100%, 260px), 1fr));
1019 }
1020
1021 .idfig__card {
1022 min-width: 0;
1023 padding: var(--space-3);
1024 border: 1px solid var(--border-default);
1025 border-radius: 6px;
1026 background: var(--bg-base);
1027 }
1028
1029 .docfig .idfig__name { margin: 0 0 var(--space-2); font-size: 13px; font-weight: 700; color: var(--text-primary); }
1030
1031 .docfig .idfig__strip {
1032 display: flex;
1033 flex-wrap: wrap;
1034 gap: 3px;
1035 margin: 0 0 var(--space-2);
1036 }
1037
1038 .idfig__seg {
1039 display: inline-flex;
1040 flex-direction: column;
1041 min-width: 0;
1042 max-width: 100%;
1043 padding: 2px 6px;
1044 border: 1px solid var(--border-default);
1045 border-radius: 4px;
1046 background: var(--bg-surface);
1047 }
1048
1049 .idfig__seg--header { border-color: var(--color-accent); }
1050 .idfig__seg--nul { justify-content: center; padding: 2px 4px; border-style: dashed; }
1051
1052 .idfig__bytes {
1053 font-family: var(--font-mono);
1054 font-size: 12px;
1055 line-height: 1.4;
1056 color: var(--text-primary);
1057 overflow-wrap: anywhere;
1058 }
1059
1060 .idfig__seg--nul .idfig__bytes,
1061 .idfig__seg--empty .idfig__bytes { color: var(--text-secondary); }
1062 .idfig__seg--empty .idfig__bytes { font-style: italic; }
1063
1064 .idfig__label { font-size: 11px; line-height: 1.3; color: var(--text-secondary); } // --text-muted is below AA at 11px
1065
1066 .docfig .idfig__result { margin: 0; font-size: 12px; color: var(--text-primary); }
1067 .docfig .idfig__note { margin: var(--space-1) 0 0; font-size: 12px; line-height: 1.5; color: var(--text-secondary); }
1068
1069 .idfig__propagation,
1070 .dagfig__table {
1071 font-size: 12px;
1072
1073 caption {
1074 caption-side: top;
1075 padding-bottom: var(--space-2);
1076 text-align: left;
1077 font-size: 13px;
1078 color: var(--text-secondary);
1079 }
1080 }
1081
1082 // Figure tables: the generic table's column styling (uppercase headers, muted mono 2nd column)
1083 // would recolour data and uppercase paths, so the figures reset it.
1084 .devdocs-table.idfig__propagation,
1085 .devdocs-table.dagfig__table {
1086 td:first-child,
1087 td:nth-child(2) { font-family: inherit; font-size: 12px; color: var(--text-primary); white-space: normal; }
1088 tbody th { font-size: 12px; font-weight: 600; letter-spacing: normal; text-transform: none; color: var(--text-primary); }
1089 thead th { color: var(--text-secondary); }
1090 }
1091
1092 .devdocs-table.idfig__propagation { // fits 320 px: fixed columns instead of a scrolling table
1093 display: table;
1094 width: 100%;
1095 margin-top: var(--space-4);
1096 table-layout: fixed;
1097
1098 thead th:first-child { width: 34%; }
1099 td, th { padding: 6px 8px; }
1100 code { font-size: 11px; white-space: nowrap; }
1101 }
1102 .devdocs-table.idfig__propagation .idfig__same th,
1103 .idfig__same td { font-weight: 400; color: var(--text-secondary); }
1104
1105 .dagfig__commits {
1106 list-style: none;
1107 margin: 0 0 var(--space-3);
1108 padding: 0;
1109 display: grid;
1110 gap: var(--space-2);
1111 grid-template-columns: repeat(auto-fit, minmax(min(100%, 220px), 1fr));
1112 }
1113
1114 .dagfig__commit {
1115 display: grid;
1116 grid-template-columns: auto minmax(0, 1fr);
1117 column-gap: var(--space-2);
1118 align-items: start;
1119 padding: var(--space-2);
1120 border: 1px solid var(--border-default);
1121 border-radius: 6px;
1122 background: var(--bg-base);
1123 font-size: 12px;
1124 line-height: 1.5;
1125 }
1126
1127 .dagfig__label {
1128 grid-row: span 2;
1129 display: inline-grid;
1130 place-items: center;
1131 width: 24px;
1132 height: 24px;
1133 border: 1.5px solid var(--color-accent); // outlined, like .seqfig__box::before (AA in both themes)
1134 border-radius: 50%;
1135 background: var(--bg-surface);
1136 color: var(--text-primary);
1137 font-family: var(--font-mono);
1138 font-weight: 700;
1139 }
1140
1141 .dagfig__meta { color: var(--text-primary); overflow-wrap: anywhere; }
1142 .dagfig__parents { color: var(--text-secondary); }
1143
1144 .docfig .dagfig__caption { margin: 0 0 var(--space-2); font-size: 13px; color: var(--text-secondary); }
1145
1146 .dagfig__scroll { // the one scroller: keyboard-focusable and labelled (role=region) for narrow screens
1147 max-width: 100%;
1148 overflow-x: auto;
1149 &:focus-visible { outline: 2px solid var(--color-accent); outline-offset: 2px; }
1150 }
1151
1152 .devdocs-table.dagfig__table { display: table; margin: 0; overflow: visible; }
1153 .dagfig__cell code { white-space: nowrap; }
1154 .dagfig__tag { display: block; font-size: 11px; color: var(--text-secondary); }
1155 .dagfig__cell--new .dagfig__tag { font-weight: 600; color: color-mix(in srgb, var(--color-success) 55%, var(--text-primary)); }
1156
1157 .devdocs-details {
1158 margin: var(--space-3) 0 var(--space-6);
1159
1160 summary {
1161 cursor: pointer;
1162 font-size: 13px;
1163 color: var(--text-secondary);
1164 &:focus-visible { outline: 2px solid var(--color-accent); outline-offset: 2px; }
1165 }
1166 }
1167
1168 @media (forced-colors: active) {
1169 .idfig__card,
1170 .idfig__seg,
1171 .dagfig__commit { border-color: CanvasText; }
1172 .idfig__seg--header { border-color: Highlight; }
1173 .dagfig__label { border-color: CanvasText; }
1174 }
1175
1176 // ── Cryptographic Identity figure (musehub#246 V1, HD derivation tree) ────────
1177 // Reuses the Foundations .idfig cards and segment strips; adds only the group label,
1178 // the producing command, the "differs" marker and the known-defect card. The marker
1179 // is also spelled out in each label ("· differs"), so colour is never the only cue.
1180
1181 .docfig .hdfig__group {
1182 margin: var(--space-4) 0 var(--space-2);
1183 font-size: 12px;
1184 font-weight: 700;
1185 color: var(--text-secondary);
1186 }
1187
1188 .docfig .docfig__body > .hdfig__group:first-child { margin-top: 0; }
1189
1190 .docfig .hdfig__how {
1191 margin: 0 0 var(--space-2);
1192 font-size: 12px;
1193 color: var(--text-secondary);
1194 overflow-wrap: anywhere;
1195 }
1196
1197 // The light theme keeps dark-theme colour tokens (tracked separately), so code text in the
1198 // figure uses --text-primary rather than the inline-code colour, to stay WCAG AA in both themes.
1199 .docfig .hdfig code { color: var(--text-primary); }
1200 .docfig .hdfig .idfig__note { overflow-wrap: anywhere; }
1201
1202 .hdfig__seg--changed { border-color: var(--color-accent); border-width: 2px; }
1203 .hdfig__seg--changed .idfig__label { color: var(--text-primary); font-weight: 700; }
1204 .hdfig__card--defect { border-style: dashed; border-color: var(--color-warning); }
1205
1206 @media (forced-colors: active) {
1207 .hdfig__seg--changed { border-color: Highlight; }
1208 .hdfig__card--defect { border-color: CanvasText; }
1209 }
File History 12 commits
sha256:634da27c5b4ea6e3cb5aa9cfb4e58dbf922b627caef67ffb0cb64bcaf70b7b9f Merge task/246-identity-qa-v2 (#246 Cryptographic Identity … Opus 5.5 minor ⚠ 9 days ago
sha256:2de1e96b7f547494958a8edace1860efc2c0de0933c4f00f777f2cc18abaf324 docs(identity): QA contract v2 for /muse/identity against m… Opus 5.5 minor ⚠ 9 days ago
sha256:a854c8a1d0741324c1efdd52a873f3447587724a66250c0eabe3906f5c505825 docs(landing): tie the interim light-theme colour roles to … Opus 5.5 9 days ago
sha256:d92f362b6c8aa3408e30fde1ad762a1e85c0f0fc054635d225c536d854470aba docs(landing): QA contract v2 — engine-pinned claim fixes, … Opus 5.5 minor ⚠ 9 days ago
sha256:0d8df91e78d3fa8d14d82f9b35de2f6991462e104025f8f1d80174f55cd18fb6 docs(foundations): QA contract v2 — verified object model, … Opus 5.5 minor ⚠ 9 days ago
sha256:2875d6ec579fb0c6bf573f367b27a59aaebe888de5691f5ddb42c538ea432400 fix(docs): first-push figure step numbers meet WCAG AA in t… Opus 5.5 patch 9 days ago
sha256:71e7849472a1545f06b42a349e127eb355fd30953cb39a182a5ae0c5e2da7fb0 docs(getting-started): QA contract v2 audit — no-release pa… Opus 5.5 minor ⚠ 10 days ago
sha256:597ccb67ee85981be2facd62d44c72e3484f2323c8ca876ca388d498e0c2a5a9 Merge task/243-docs-concept-map (#243 V1 concept map) into dev Opus 5.5 patch 10 days ago
sha256:13b886ba1f92343d568cf8cdf74846810609fc4c244e6edacee8451e1f15d22d docs(landing): interactive architecture concept map on /mus… Opus 5.5 patch 10 days ago
sha256:1066bd2893ed5a5ace0322bbb97ecc9babf891a25751fadbb76efc65d41d2e66 feat: enriched repo cards with live intel signals on domain… Sonnet 4.6 minor ⚠ 194 days ago
sha256:df4329cd20f05c8ee7ff57951929b7e3526b02698bcee7c9902131af75d64b4a refactor: purge all legacy CSS token aliases Sonnet 4.6 minor ⚠ 198 days ago
sha256:e2adca12a0ed2534ebbdf7ba183d0284811e615ae7a3e92c6eb9c674ab3bf164 feat: migrate muse docs pages to components/pages split; de… Sonnet 4.6 minor ⚠ 198 days ago