@laitszkin/apollo-toolkit 3.10.0 → 3.11.1

package/init-project-html/sample-demo/resources/project-architecture/assets/architecture.css

@@ -1,1059 +1,161 @@
-/* Shared atlas styles — pair with architecture-page.template.html */
-:root {
-  --bg: #0f1419;
-  --surface: #1a222c;
-  --surface-elevated: #232d3a;
-  --text: #e8ecf1;
-  --muted: #9aa7b2;
-  --accent: #e07a5f;
-  --accent-soft: rgba(224, 122, 95, 0.15);
-  --edge: #4a5b6c;
-  --ok: #6fcf97;
-  --font-display: "Fraunces", "Georgia", serif;
-  --font-body: "Plus Jakarta Sans", "Segoe UI", system-ui, sans-serif;
-  --radius: 12px;
-  --shadow: 0 12px 40px rgba(0, 0, 0, 0.35);
-}
-
-@media (prefers-color-scheme: light) {
-  :root {
-    --bg: #f4f1ea;
-    --surface: #ffffff;
-    --surface-elevated: #faf8f3;
-    --text: #1a1d22;
-    --muted: #5c6670;
-    --accent: #c45c3e;
-    --accent-soft: rgba(196, 92, 62, 0.12);
-    --edge: #a8b0b9;
-    --shadow: 0 8px 28px rgba(26, 29, 34, 0.08);
-  }
-}
-
-*,
-*::before,
-*::after {
-  box-sizing: border-box;
-}
-
-body {
-  margin: 0;
-  min-height: 100vh;
-  font-family: var(--font-body);
-  font-size: 1rem;
-  line-height: 1.6;
-  color: var(--text);
-  background: radial-gradient(1200px 800px at 10% -10%, rgba(224, 122, 95, 0.08), transparent),
-    var(--bg);
-}
-
-.atlas-page {
-  max-width: 1120px;
-  margin: 0 auto;
-  padding: 2.5rem 1.5rem 4rem;
-  position: relative;
-}
-
-.atlas-header {
-  margin-bottom: 2rem;
-}
-
-.atlas-kicker {
-  font-size: 0.75rem;
-  letter-spacing: 0.12em;
-  text-transform: uppercase;
-  color: var(--accent);
-  margin: 0 0 0.5rem;
-}
-
-.atlas-title {
-  font-family: var(--font-display);
-  font-weight: 600;
-  font-size: clamp(2rem, 4vw, 2.75rem);
-  line-height: 1.15;
-  margin: 0 0 0.5rem;
-}
-
-.atlas-meta {
-  color: var(--muted);
-  font-size: 0.9rem;
-  margin: 0;
-}
-
-.atlas-summary,
-.atlas-legend,
-.atlas-diagram,
-.atlas-features,
-.feature-story,
-.feature-modules,
-.feature-flows,
-.feature-trace {
-  background: var(--surface);
-  border-radius: var(--radius);
-  padding: 1.25rem 1.5rem;
-  margin-bottom: 1.25rem;
-  box-shadow: var(--shadow);
-}
-
-.atlas-summary h2,
-.atlas-legend h2,
-.atlas-diagram h2,
-.atlas-features h2,
-.feature-story h2,
-.feature-modules h2,
-.feature-flows h2,
-.feature-trace h2 {
-  font-family: var(--font-display);
-  font-size: 1.15rem;
-  margin: 0 0 0.75rem;
-}
-
-.atlas-legend ul {
-  margin: 0;
-  padding-left: 1.25rem;
-  color: var(--muted);
-}
-
-.arch-diagram {
-  margin: 0;
-  padding: 0;
-  background: transparent;
-  box-shadow: none;
-}
-
-.arch-canvas {
-  position: relative;
-  background: var(--surface-elevated);
-  border-radius: var(--radius);
-  padding: 1.25rem;
-  min-height: 280px;
-}
-
-.arch-nodes {
-  display: grid;
-  grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
-  gap: 1rem;
-  position: relative;
-  z-index: 1;
-}
-
-.arch-node {
-  background: var(--surface);
-  border: 1px solid var(--edge);
-  border-radius: calc(var(--radius) - 4px);
-  padding: 0.85rem 1rem;
-  transition: border-color 0.15s ease, transform 0.15s ease;
-}
-
-@media (prefers-reduced-motion: reduce) {
-  .arch-node {
-    transition: none;
-  }
-}
-
-.arch-node:hover {
-  border-color: var(--accent);
-  transform: translateY(-1px);
-}
-
-.arch-node--ui {
-  border-top: 3px solid var(--accent);
-}
-
-.arch-node--service {
-  border-top: 3px solid #7eb8da;
-}
-
-.arch-node--data {
-  border-top: 3px solid var(--ok);
-}
-
-.arch-node--external {
-  border-top: 3px solid #d4a837;
-  border-style: dashed;
-}
-
-.arch-node-title {
-  font-family: var(--font-display);
-  font-size: 1rem;
-  margin: 0 0 0.35rem;
-}
-
-.arch-node-body {
-  margin: 0;
-  font-size: 0.85rem;
-  color: var(--muted);
-}
-
-.arch-edge-list {
-  list-style: none;
-  margin: 1rem 0 0;
-  padding: 0;
-  font-size: 0.82rem;
-  color: var(--muted);
-}
-
-.arch-edge-list li {
-  padding: 0.35rem 0;
-  border-top: 1px solid var(--edge);
-}
-
-.arch-edge-list code {
-  color: var(--text);
-  background: var(--surface-elevated);
-  padding: 0.1rem 0.35rem;
-  border-radius: 4px;
-  font-size: 0.8em;
-}
-
-.arch-caption {
-  font-size: 0.85rem;
-  color: var(--muted);
-  margin-top: 0.75rem;
-}
-
-.atlas-features ul {
-  list-style: none;
-  margin: 0;
-  padding: 0;
-}
-
-.atlas-features li {
-  margin-bottom: 0.65rem;
-}
-
-.atlas-features a {
-  color: var(--accent);
-  font-weight: 600;
-  text-decoration: none;
-}
-
-.atlas-features a:hover {
-  text-decoration: underline;
-}
-
-.feature-modules table {
-  width: 100%;
-  border-collapse: collapse;
-  font-size: 0.9rem;
-}
-
-.feature-modules th,
-.feature-modules td {
-  text-align: left;
-  padding: 0.5rem 0.65rem;
-  border-bottom: 1px solid var(--edge);
-}
-
-.feature-modules th {
-  color: var(--muted);
-  font-weight: 500;
-}
-
-.breadcrumb {
-  font-size: 0.9rem;
-  margin: 0 0 1rem;
-}
-
-.breadcrumb a {
-  color: var(--accent);
-  text-decoration: none;
-}
-
-.breadcrumb a:hover {
-  text-decoration: underline;
-}
-
-/* --- Flowchart (flow-chart): macro / cross-module / internal --- */
-.flow-section h2 {
-  font-family: var(--font-display);
-  font-size: 1.25rem;
-  margin: 0 0 1rem;
-}
-
-.flow-chart {
-  margin: 0 0 1.25rem;
-}
-
-.flow-chart__body {
-  display: flex;
-  flex-direction: column;
-  align-items: center;
-  gap: 0;
-  padding: 1.25rem 1rem 1rem;
-  background: var(--surface-elevated);
-  border-radius: var(--radius);
-  max-width: 100%;
-}
-
-.flow-node {
-  width: 100%;
-  max-width: 420px;
-  background: var(--surface);
-  border: 1px solid var(--edge);
-  border-radius: calc(var(--radius) - 4px);
-  padding: 0.85rem 1.1rem;
-  border-top:3px solid #7eb8da;
-}
-
-.flow-node--module {
-  max-width: 520px;
-  border-top-color: #7eb8da;
-}
-
-.flow-node--process {
-  border-top-color: var(--accent);
-}
-
-.flow-node--decision {
-  border-top: 3px solid #d4a837;
-  border-left: 3px solid rgba(212, 168, 55, 0.45);
-  text-align: center;
-  position: relative;
-  max-width: 440px;
-}
-
-.flow-node--decision::before {
-  content: "Decision";
-  position: absolute;
-  top: 0.45rem;
-  right: 0.65rem;
-  font-size: 0.6rem;
-  letter-spacing: 0.1em;
-  text-transform: uppercase;
-  color: #d4a837;
-  font-weight: 600;
-}
-
-.flow-node--decision .flow-node__title {
-  display: block;
-  font-size: 0.95rem;
-  margin: 0.25rem 2.5rem 0.5rem 0.25rem;
-  text-align: left;
-}
-
-.flow-node__kicker {
-  display: block;
-  font-size: 0.65rem;
-  letter-spacing: 0.08em;
-  text-transform: uppercase;
-  color: var(--muted);
-  margin-bottom: 0.25rem;
-}
-
-.flow-node__title {
-  font-family: var(--font-display);
-  display: block;
-  font-size: 1rem;
-}
-
-.flow-node__body {
-  font-size: 0.82rem;
-  color: var(--muted);
-  margin: 0.4rem 0 0;
-}
-
-.flow-branch-row {
-  display: grid;
-  grid-template-columns: 1fr 1fr;
-  gap: 0.75rem;
-  margin-top: 0.5rem;
-  text-align: left;
-}
-
-.flow-branch {
-  background: var(--surface-elevated);
-  border-radius: 6px;
-  padding: 0.45rem 0.6rem;
-  border: 1px solid var(--edge);
-}
-
-.flow-branch__label {
-  font-size: 0.7rem;
-  font-weight: 600;
-  color: var(--accent);
-  text-transform: uppercase;
-  letter-spacing: 0.06em;
-}
-
-.flow-branch__note {
-  font-size: 0.78rem;
-  margin: 0.25rem 0 0;
-  color: var(--muted);
-}
-
-.flow-connector {
-  display: flex;
-  justify-content: center;
-  color: var(--accent);
-  margin: -0.1rem 0;
-}
-
-.flow-connector--dashed .flow-connector__svg line {
-  stroke-dasharray: 5 4;
-  opacity: 0.85;
-}
-
-.flow-connector--failure,
-.flow-connector--rollback {
-  color: #e07a5f;
-  opacity: 0.95;
-}
-
-.flow-connector--failure .flow-connector__svg line,
-.flow-connector--rollback .flow-connector__svg line {
-  stroke-dasharray: 6 5;
-  stroke-width: 2;
-}
-
-@media (prefers-color-scheme: light) {
-  .flow-connector--failure,
-  .flow-connector--rollback {
-    color: #b3472b;
-  }
-}
-
-.flow-node--failure {
-  border-top: 3px solid #e07a5f;
-  border-left: 2px solid rgba(224, 122, 95, 0.35);
-  background: var(--accent-soft);
-}
-
-.flow-node--failure .flow-node__kicker {
-  color: #e07a5f;
-}
-
-.flow-node--rollback {
-  border-top: 3px dashed #9aa7b2;
-  font-size: 0.9rem;
-}
-
-.flow-edge-rollback {
-  display: block;
-  margin-top: 0.35rem;
-  padding: 0.35rem 0.5rem;
-  background: var(--surface-elevated);
-  border-radius: 6px;
-  font-size: 0.82em;
-  border-left: 3px solid #e07a5f;
-}
-
-.flow-edge-rollback a {
-  color: var(--accent);
-  font-weight: 600;
-}
-
-.flow-edge-manifest {
-  margin: 0.75rem 0 0;
-  padding-left: 1.25rem;
-  font-size: 0.82rem;
-  color: var(--muted);
-}
-
-.flow-edge-manifest li {
-  margin-bottom: 0.45rem;
-}
-
-.flow-edge-from,
-.flow-edge-to {
-  font-family: ui-monospace, monospace;
-  font-size: 0.78em;
-  color: var(--text);
-}
-
-.flow-edge-label {
-  display: inline-block;
-  font-weight: 600;
-  color: var(--text);
-  margin: 0 0.25rem;
-}
-
-.flow-edge-note {
-  display: block;
-  font-size: 0.9em;
-  margin-top: 0.15rem;
-}
-
-.flow-caption {
-  font-size: 0.85rem;
-  color: var(--muted);
-  margin-top: 0.65rem;
-}
-
-.flow-glossary {
-  background: var(--surface);
-  border-radius: var(--radius);
-  padding: 1.25rem 1.5rem;
-  margin-bottom: 1.25rem;
-  box-shadow: var(--shadow);
-}
+/* architecture.css — styling for the declarative atlas. The CLI copies
+ * this file into <outDir>/assets/. Style hooks (class names) are owned
+ * by render.js so agents never need to touch HTML by hand. */
 
-.flow-glossary h2 {
-  font-family: var(--font-display);
-  font-size: 1.15rem;
-  margin: 0 0 0.75rem;
-}
-
-.flow-glossary h3 {
-  font-family: var(--font-display);
-  font-size: 1rem;
-  margin: 1.25rem 0 0.5rem;
-}
-
-.flow-glossary h3:first-of-type {
-  margin-top: 0;
-}
-
-.flow-glossary table {
-  width: 100%;
-  border-collapse: collapse;
-  font-size: 0.88rem;
-}
-
-.flow-glossary th,
-.flow-glossary td {
-  text-align: left;
-  padding: 0.45rem 0.55rem;
-  border-bottom: 1px solid var(--edge);
-  vertical-align: top;
-}
-
-.flow-glossary th {
-  color: var(--muted);
-  font-weight: 500;
-  width: 18%;
-}
-
-.flow-glossary td code {
-  font-size: 0.85em;
-  background: var(--surface-elevated);
-  padding: 0.1rem 0.3rem;
-  border-radius: 4px;
-}
-
-/* Page-level SVG marker defs (see TEMPLATE_SPEC.md) */
-.flow-defs {
-  position: absolute;
-  width: 0;
-  height: 0;
-  overflow: hidden;
-  pointer-events: none;
-}
-
-.flow-path-divider {
-  text-align: center;
-  font-size: 0.8rem;
-  letter-spacing: 0.06em;
-  color: var(--muted);
-  margin: 0.65rem 0 0.35rem;
-  width: 100%;
-  max-width: 420px;
-}
-
-/* Feature folder: submodule nav + rollback return strip */
-.submodule-nav {
-  background: var(--surface);
-  border-radius: var(--radius);
-  padding: 1.25rem 1.5rem;
-  margin-bottom: 1.25rem;
-  box-shadow: var(--shadow);
-}
-
-.submodule-nav h2 {
-  font-family: var(--font-display);
-  font-size: 1.15rem;
-  margin: 0 0 0.75rem;
-}
-
-.submodule-nav table {
-  width: 100%;
-  border-collapse: collapse;
-  font-size: 0.9rem;
-}
-
-.submodule-nav th,
-.submodule-nav td {
-  text-align: left;
-  padding: 0.5rem 0.65rem;
-  border-bottom: 1px solid var(--edge);
-}
-
-.submodule-nav th {
-  color: var(--muted);
-  font-weight: 500;
-}
-
-.flow-node--submodule .flow-node__title a {
-  color: var(--accent);
-  text-decoration: none;
-  font-weight: 600;
-}
-
-.flow-node--submodule .flow-node__title a:hover {
-  text-decoration: underline;
-}
-
-.flow-node--feature-cap {
-  border-top-color: #9b7ed9;
-  max-width: 480px;
-  text-align: center;
-}
-
-.flow-node--feature-cap .flow-node__title a {
-  color: var(--accent);
-  font-weight: 700;
-}
-
-.flow-return-row {
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  flex-wrap: wrap;
-  gap: 0.5rem 0.75rem;
-  width: 100%;
-  max-width: 520px;
-  margin: 0.35rem auto 0.75rem;
-  padding: 0.65rem 0.85rem;
-  background: var(--accent-soft);
-  border: 1px dashed var(--accent);
-  border-radius: var(--radius);
-  color: var(--text);
-}
-
-.flow-return-row__endpoint {
-  font-size: 0.82rem;
-  max-width: 200px;
-}
-
-.flow-return-row__label {
-  display: block;
-  font-size: 0.62rem;
-  letter-spacing: 0.08em;
-  text-transform: uppercase;
-  color: var(--accent);
-  font-weight: 600;
-}
-
-.flow-return-row__hint {
-  display: block;
-  font-size: 0.75rem;
-  color: var(--muted);
-  margin-top: 0.2rem;
-}
-
-.flow-return-row a {
-  color: var(--accent);
-  font-weight: 600;
-}
-
-.flow-return-arrow {
-  flex-shrink: 0;
-  color: #e07a5f;
-}
-
-@media (prefers-color-scheme: light) {
-  .flow-return-arrow {
-    color: #b3472b;
-  }
-}
-
-.submodule-role {
-  background: var(--surface);
-  border-radius: var(--radius);
-  padding: 1rem 1.25rem;
-  margin-bottom: 1.25rem;
-  box-shadow: var(--shadow);
-}
-
-.submodule-role h2 {
-  font-family: var(--font-display);
-  font-size: 1.05rem;
-  margin: 0 0 0.5rem;
-}
-
-/* ============================================================
-   Macro SVG graph (feature × submodule, many-to-many)
-   ============================================================ */
-.flow-chart--svg {
-  margin: 0 0 1.25rem;
-}
-
-.macro-svg__wrap {
-  background: var(--surface-elevated);
-  border-radius: var(--radius);
-  padding: 0.75rem;
-  overflow-x: auto;
-}
-
-.macro-svg {
-  display: block;
-  width: 100%;
-  height: auto;
-  min-width: 880px;
-  max-width: 1240px;
-  font-family: var(--font-body);
-}
-
-/* Actors */
-.macro-svg .m-actor rect {
-  fill: var(--surface);
-  stroke: var(--edge);
-  stroke-width: 1.4;
-}
-.macro-svg .m-actor text {
-  fill: var(--text);
-  font-size: 14px;
-  font-weight: 600;
-  font-family: var(--font-display);
-}
-
-/* Feature cluster (the big dashed box that contains submodules) */
-.macro-svg .m-cluster__rect {
-  fill: rgba(155, 126, 217, 0.06);
-  stroke: #9b7ed9;
-  stroke-width: 1.5;
-  stroke-dasharray: 8 5;
-}
-.macro-svg .m-cluster__title {
-  fill: var(--accent);
-  font-size: 14px;
-  font-weight: 700;
-  font-family: var(--font-display);
-  letter-spacing: 0.02em;
-}
-.macro-svg .m-cluster__title:hover {
-  text-decoration: underline;
-}
-.macro-svg .m-cluster__sub {
-  fill: var(--muted);
-  font-size: 11px;
-}
-
-/* Submodule node */
-.macro-svg .m-sub rect {
-  fill: var(--surface);
-  stroke: var(--edge);
-  stroke-width: 1.4;
-  transition: stroke 0.15s ease;
-}
-.macro-svg .m-sub:hover rect {
-  stroke: var(--accent);
-  stroke-width: 2;
-}
-.macro-svg .m-sub__title {
-  fill: var(--text);
-  font-size: 13px;
-  font-weight: 600;
-}
-.macro-svg .m-sub__kind {
-  fill: var(--muted);
-  font-size: 10.5px;
-}
-.macro-svg .m-sub--db rect {
-  fill: rgba(111, 207, 151, 0.08);
-  stroke: var(--ok);
-}
-
-/* Edges */
-.macro-svg .m-edge path {
-  fill: none;
-  stroke: var(--edge);
-  stroke-width: 1.4;
-}
-.macro-svg .m-edge--call {
-  color: var(--text);
-}
-.macro-svg .m-edge--call path {
-  stroke: currentColor;
-  stroke-width: 1.6;
-}
-.macro-svg .m-edge--return {
-  color: var(--muted);
-}
-.macro-svg .m-edge--return path {
-  stroke: currentColor;
-  stroke-width: 1.1;
-  stroke-dasharray: 5 4;
-}
-.macro-svg .m-edge--cross {
-  color: var(--accent);
-}
-.macro-svg .m-edge--cross path {
-  stroke: var(--accent);
-  stroke-width: 2.4;
-  stroke-dasharray: 10 5;
-  opacity: 0.9;
-}
-
-.macro-svg .m-edge__label {
-  fill: var(--muted);
-  font-size: 10.5px;
-}
-.macro-svg .m-edge__label--cross {
-  fill: var(--accent);
-  font-weight: 600;
-  font-size: 11.5px;
-}
-
-@media (prefers-color-scheme: light) {
-  .macro-svg .m-cluster__rect {
-    fill: rgba(155, 126, 217, 0.08);
-  }
-  .macro-svg .m-sub--db rect {
-    fill: rgba(111, 207, 151, 0.14);
-  }
-}
-
-/* ============================================================
-   Macro manifest list (under SVG)
-   ============================================================ */
-.flow-edge-manifest--macro {
-  margin-top: 1rem;
-}
-.flow-edge-manifest--macro li[data-edge-kind="call"] {
-  border-left: 3px solid var(--text);
-  padding-left: 0.6rem;
-}
-.flow-edge-manifest--macro li[data-edge-kind="return"] {
-  border-left: 3px solid var(--muted);
-  padding-left: 0.6rem;
-  font-style: italic;
-}
-.flow-edge-manifest--macro li[data-edge-kind="data-row"] {
-  border-left: 3px solid var(--accent);
-  padding-left: 0.6rem;
-  font-weight: 600;
-}
-
-/* ============================================================
-   Submodule page: I/O table + variables + internal data flow
-   ============================================================ */
-.sub-io,
-.sub-vars,
-.sub-dataflow,
-.sub-errors {
-  background: var(--surface);
-  border-radius: var(--radius);
-  padding: 1.1rem 1.35rem;
-  margin-bottom: 1.1rem;
-  box-shadow: var(--shadow);
-}
-
-.sub-io h2,
-.sub-vars h2,
-.sub-dataflow h2,
-.sub-errors h2 {
-  font-family: var(--font-display);
-  font-size: 1.1rem;
-  margin: 0 0 0.75rem;
-}
-
-.sub-vars__intro {
-  margin: 0 0 0.6rem;
-  color: var(--muted);
-  font-size: 0.86rem;
-}
-
-.sub-vars table {
-  width: 100%;
-  border-collapse: collapse;
-  font-size: 0.86rem;
-}
-.sub-vars th,
-.sub-vars td {
-  text-align: left;
-  padding: 0.55rem 0.65rem;
-  border-bottom: 1px solid var(--edge);
-  vertical-align: top;
-}
-.sub-vars th {
-  color: var(--muted);
-  font-weight: 500;
-  font-size: 0.78rem;
-  letter-spacing: 0.04em;
-  text-transform: uppercase;
-}
-.sub-vars code {
-  background: var(--surface-elevated);
-  padding: 0.08rem 0.3rem;
-  border-radius: 3px;
-  font-size: 0.8em;
-}
-.sub-vars__name {
-  font-family: ui-monospace, "SF Mono", Menlo, monospace;
-  font-weight: 600;
-  color: var(--text);
-  white-space: nowrap;
-}
-.sub-vars__type {
-  font-family: ui-monospace, "SF Mono", Menlo, monospace;
-  color: var(--muted);
-}
-.sub-vars__scope {
-  display: inline-block;
-  padding: 0.12rem 0.5rem;
-  border-radius: 999px;
-  font-size: 0.7rem;
-  letter-spacing: 0.05em;
-  text-transform: uppercase;
-  background: var(--surface-elevated);
-  color: var(--muted);
-  border: 1px solid var(--edge);
-}
-.sub-vars__scope--call {
-  border-color: rgba(126, 184, 218, 0.5);
-  color: #7eb8da;
-}
-.sub-vars__scope--tx {
-  border-color: rgba(212, 168, 55, 0.55);
-  color: #d4a837;
-}
-.sub-vars__scope--persist {
-  border-color: rgba(111, 207, 151, 0.55);
-  color: var(--ok);
-}
-.sub-vars__scope--instance {
-  border-color: rgba(155, 126, 217, 0.55);
-  color: #9b7ed9;
-}
-.sub-vars__scope--loop {
-  border-color: rgba(224, 122, 95, 0.55);
-  color: var(--accent);
-}
-
-.sub-io table {
-  width: 100%;
-  border-collapse: collapse;
-  font-size: 0.86rem;
-}
-.sub-io th,
-.sub-io td {
-  text-align: left;
-  padding: 0.55rem 0.65rem;
-  border-bottom: 1px solid var(--edge);
-  vertical-align: top;
-}
-.sub-io th {
-  color: var(--muted);
-  font-weight: 500;
-  font-size: 0.78rem;
-  letter-spacing: 0.04em;
-  text-transform: uppercase;
-}
-.sub-io code {
-  background: var(--surface-elevated);
-  padding: 0.08rem 0.3rem;
-  border-radius: 3px;
-  font-size: 0.8em;
-}
-
-.sub-io__signature {
-  font-family: ui-monospace, "SF Mono", Menlo, monospace;
-  font-size: 0.84rem;
-  color: var(--text);
-}
-.sub-io__side {
-  display: inline-block;
-  padding: 0.1rem 0.4rem;
-  border-radius: 4px;
-  font-size: 0.7rem;
-  letter-spacing: 0.05em;
-  text-transform: uppercase;
-  margin-right: 0.25rem;
-}
-.sub-io__side--pure {
-  background: rgba(111, 207, 151, 0.18);
-  color: var(--ok);
-}
-.sub-io__side--io {
-  background: rgba(212, 168, 55, 0.18);
-  color: #d4a837;
-}
-.sub-io__side--write {
-  background: rgba(224, 122, 95, 0.18);
-  color: var(--accent);
-}
-
-.sub-dataflow ol {
-  margin: 0;
-  padding-left: 1.2rem;
-  color: var(--text);
-}
-.sub-dataflow li {
-  margin-bottom: 0.5rem;
-  line-height: 1.55;
-}
-.sub-dataflow code {
-  background: var(--surface-elevated);
-  padding: 0.08rem 0.3rem;
-  border-radius: 3px;
-}
-
-/* tiny inline SVG graph for in-submodule data movement */
-.sub-dataflow__svg {
-  display: block;
-  width: 100%;
-  max-width: 720px;
-  height: auto;
-  margin-top: 0.75rem;
-  background: var(--surface-elevated);
-  border-radius: calc(var(--radius) - 4px);
-  padding: 0.5rem;
-}
-.sub-dataflow__svg .d-node rect {
-  fill: var(--surface);
-  stroke: var(--edge);
-}
-.sub-dataflow__svg .d-node text {
-  fill: var(--text);
-  font-size: 12px;
-}
-.sub-dataflow__svg .d-edge {
-  stroke: var(--text);
-  fill: none;
-  stroke-width: 1.4;
-}
-.sub-dataflow__svg .d-edge--side {
-  stroke: var(--accent);
-  stroke-dasharray: 4 3;
-}
-.sub-dataflow__svg .d-label {
-  fill: var(--muted);
-  font-size: 10.5px;
-}
-
-/* Submodule index list on macro page */
-.atlas-submodule-index {
-  background: var(--surface);
-  border-radius: var(--radius);
-  padding: 1.1rem 1.35rem;
-  margin-bottom: 1.25rem;
-  box-shadow: var(--shadow);
-}
-.atlas-submodule-index h2 {
-  font-family: var(--font-display);
-  font-size: 1.1rem;
-  margin: 0 0 0.6rem;
-}
-.atlas-submodule-index ul {
-  list-style: none;
-  margin: 0;
-  padding: 0;
-}
-.atlas-submodule-index li {
-  margin-bottom: 0.5rem;
-  font-size: 0.92rem;
-}
-.atlas-submodule-index strong {
-  color: var(--accent);
-  font-family: var(--font-display);
-  margin-right: 0.3rem;
-}
-.atlas-submodule-index a {
-  color: var(--text);
-  text-decoration: none;
-  border-bottom: 1px dotted var(--edge);
-}
-.atlas-submodule-index a:hover {
-  color: var(--accent);
-  border-bottom-color: var(--accent);
-}
+:root {
+  color-scheme: light dark;
+  --bg: #0f172a;
+  --panel: #111827;
+  --panel-soft: #1f2937;
+  --text: #e5e7eb;
+  --muted: #9ca3af;
+  --border: #334155;
+  --accent: #38bdf8;
+  --kind-ui: #38bdf8;
+  --kind-api: #818cf8;
+  --kind-service: #34d399;
+  --kind-db: #fbbf24;
+  --kind-pure-fn: #cbd5e1;
+  --kind-queue: #a78bfa;
+  --kind-external: #fb7185;
+  --edge-call: #60a5fa;
+  --edge-return: #94a3b8;
+  --edge-data-row: #fbbf24;
+  --edge-failure: #fb7185;
+}
+
+* { box-sizing: border-box; }
+html, body { margin: 0; padding: 0; background: var(--bg); color: var(--text); font-family: ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif; }
+
+a { color: var(--accent); text-decoration: none; }
+a:hover { text-decoration: underline; }
+
+h1, h2 { margin: 0 0 12px; font-weight: 600; letter-spacing: -0.01em; }
+h1 { font-size: 28px; }
+h2 { font-size: 18px; color: var(--muted); text-transform: uppercase; letter-spacing: 0.08em; font-size: 13px; }
+
+p { line-height: 1.55; color: var(--text); }
+
+/* ---- atlas (macro) ---- */
+.atlas-header { padding: 28px 40px 16px; border-bottom: 1px solid var(--border); background: var(--panel); }
+.atlas-summary { color: var(--muted); max-width: 80ch; margin: 8px 0 0; }
+
+.atlas-main { display: grid; grid-template-columns: minmax(0, 3fr) minmax(280px, 1fr); gap: 24px; padding: 24px 40px 48px; }
+
+.atlas-canvas { background: var(--panel); border: 1px solid var(--border); border-radius: 12px; padding: 16px; position: relative; }
+.atlas-canvas__toolbar { position: absolute; top: 16px; right: 16px; display: flex; gap: 4px; z-index: 2; }
+.atlas-canvas__toolbar button { background: var(--panel-soft); color: var(--text); border: 1px solid var(--border); padding: 4px 12px; border-radius: 6px; cursor: pointer; font-size: 13px; }
+.atlas-canvas__toolbar button:hover { border-color: var(--accent); color: var(--accent); }
+
+.atlas-canvas__viewport { width: 100%; max-height: 72vh; overflow: hidden; border-radius: 8px; background: #0b1220; }
+.atlas-canvas__viewport.is-grabbing { cursor: grabbing; }
+.atlas-canvas__viewport:not(.is-grabbing) { cursor: grab; }
+
+.atlas-svg { width: 100%; height: auto; max-height: 72vh; display: block; user-select: none; touch-action: none; }
+
+.atlas-legend { list-style: none; padding: 12px 4px 0; margin: 0; display: flex; gap: 18px; flex-wrap: wrap; font-size: 12px; color: var(--muted); }
+.atlas-legend li { display: inline-flex; align-items: center; gap: 6px; }
+.legend-swatch { display: inline-block; width: 18px; height: 4px; border-radius: 2px; }
+.legend-swatch--call { background: var(--edge-call); }
+.legend-swatch--return { background: var(--edge-return); }
+.legend-swatch--data-row { background: var(--edge-data-row); }
+.legend-swatch--failure { background: var(--edge-failure); }
+
+.atlas-index { background: var(--panel); border: 1px solid var(--border); border-radius: 12px; padding: 16px; max-height: 80vh; overflow: auto; }
+
+.atlas-submodule-index { list-style: none; padding: 0; margin: 0; display: flex; flex-direction: column; gap: 10px; }
+.atlas-submodule-index__item a { display: grid; grid-template-columns: minmax(0, 1fr) auto; align-items: center; gap: 4px 8px; padding: 8px 10px; background: var(--panel-soft); border: 1px solid var(--border); border-radius: 8px; color: inherit; }
+.atlas-submodule-index__item a:hover { border-color: var(--accent); }
+.atlas-submodule-index__feature { font-size: 11px; color: var(--muted); text-transform: uppercase; letter-spacing: 0.06em; grid-column: 1 / 3; }
+.atlas-submodule-index__sub { font-weight: 600; }
+.atlas-submodule-index__kind { font-size: 11px; padding: 1px 8px; border-radius: 999px; background: var(--panel); border: 1px solid var(--border); color: var(--muted); }
+.atlas-submodule-index__role { margin: 4px 10px 0; font-size: 12px; color: var(--muted); }
+
+/* ---- SVG macro ---- */
+.m-cluster__bg { fill: rgba(15, 23, 42, 0.55); stroke: var(--border); stroke-width: 1; }
+.m-cluster__title { font-family: ui-sans-serif, system-ui, sans-serif; font-size: 14px; fill: var(--text); font-weight: 600; letter-spacing: 0.04em; text-transform: uppercase; }
+.m-node { cursor: pointer; }
+.m-node rect { fill: var(--panel-soft); stroke: var(--border); stroke-width: 1; transition: stroke 120ms ease, fill 120ms ease; }
+.m-node:hover rect,
+.m-node:focus rect,
+.m-node:focus-visible rect { stroke: var(--accent); stroke-width: 1.6; fill: rgba(56, 189, 248, 0.08); }
+.m-node:focus { outline: none; }
+.m-node__title { font-size: 13px; font-weight: 600; fill: var(--text); }
+.m-node__kind { font-size: 11px; fill: var(--muted); }
+.m-node__role { font-size: 11px; fill: var(--muted); }
+.m-node:hover .m-node__title,
+.m-node:focus .m-node__title { fill: var(--accent); }
+
+.m-node--ui rect { stroke: var(--kind-ui); }
+.m-node--api rect { stroke: var(--kind-api); }
+.m-node--service rect { stroke: var(--kind-service); }
+.m-node--db rect { stroke: var(--kind-db); }
+.m-node--pure-fn rect { stroke: var(--kind-pure-fn); }
+.m-node--queue rect { stroke: var(--kind-queue); }
+.m-node--external rect { stroke: var(--kind-external); }
+
+.m-edge path { stroke-width: 1.6; }
+.m-edge--call path { stroke: var(--edge-call); }
+.m-edge--return path { stroke: var(--edge-return); stroke-dasharray: 6 4; }
+.m-edge--data-row path { stroke: var(--edge-data-row); }
+.m-edge--failure path { stroke: var(--edge-failure); }
+
+.m-arrow path { fill: currentColor; }
+.m-arrow--call { color: var(--edge-call); }
+.m-arrow--return { color: var(--edge-return); }
+.m-arrow--data-row { color: var(--edge-data-row); }
+.m-arrow--failure { color: var(--edge-failure); }
+
+.m-edge__label { fill: var(--muted); font-size: 11px; }
+
+/* ---- feature page ---- */
+.feature-header, .submodule-header { padding: 24px 40px 12px; border-bottom: 1px solid var(--border); background: var(--panel); }
+.feature-breadcrumb, .submodule-breadcrumb { font-size: 13px; color: var(--muted); margin-bottom: 8px; }
+.feature-depends { font-size: 13px; color: var(--muted); margin: 8px 0 0; }
+.feature-main, .submodule-main { padding: 24px 40px 48px; display: flex; flex-direction: column; gap: 32px; }
+.feature-story p { max-width: 80ch; }
+
+.submodule-nav { list-style: none; padding: 0; margin: 0; display: grid; gap: 12px; grid-template-columns: repeat(auto-fill, minmax(260px, 1fr)); }
+.submodule-card { background: var(--panel); border: 1px solid var(--border); border-radius: 10px; padding: 12px 14px; }
+.submodule-card__link { display: flex; align-items: center; justify-content: space-between; color: inherit; font-weight: 600; }
+.submodule-card__kind { font-size: 11px; padding: 2px 8px; border-radius: 999px; border: 1px solid var(--border); color: var(--muted); }
+.submodule-card__role { margin: 8px 0 0; font-size: 13px; color: var(--muted); }
+
+.feature-edges__list { list-style: none; padding: 0; margin: 0; display: flex; flex-direction: column; gap: 8px; }
+.feature-edges__item { display: grid; grid-template-columns: minmax(0, 1fr) auto minmax(0, 2fr); gap: 8px; padding: 8px 12px; background: var(--panel); border: 1px solid var(--border); border-radius: 8px; font-size: 13px; }
+.feature-edges__kind { font-size: 11px; color: var(--muted); text-transform: uppercase; letter-spacing: 0.06em; align-self: center; }
+.feature-edges__item--call { border-left: 4px solid var(--edge-call); }
+.feature-edges__item--return { border-left: 4px solid var(--edge-return); }
+.feature-edges__item--data-row { border-left: 4px solid var(--edge-data-row); }
+.feature-edges__item--failure { border-left: 4px solid var(--edge-failure); }
+
+/* ---- submodule page ---- */
+.submodule-kind { display: inline-block; font-size: 12px; padding: 2px 10px; border-radius: 999px; border: 1px solid var(--border); color: var(--muted); margin-left: 8px; vertical-align: middle; text-transform: uppercase; letter-spacing: 0.06em; }
+.submodule-role { color: var(--muted); margin: 8px 0 0; max-width: 80ch; }
+
+.sub-table { width: 100%; border-collapse: collapse; font-size: 13px; }
+.sub-table th, .sub-table td { padding: 8px 12px; border-bottom: 1px solid var(--border); text-align: left; vertical-align: top; }
+.sub-table th { font-size: 11px; color: var(--muted); text-transform: uppercase; letter-spacing: 0.06em; background: var(--panel); }
+
+.sub-section__empty { color: var(--muted); font-style: italic; font-size: 13px; }
+
+.sub-dataflow__canvas { position: relative; background: var(--panel); border: 1px solid var(--border); border-radius: 12px; padding: 16px; }
+.sub-dataflow__toolbar { position: absolute; top: 16px; right: 16px; display: flex; gap: 4px; z-index: 2; }
+.sub-dataflow__toolbar button { background: var(--panel-soft); color: var(--text); border: 1px solid var(--border); padding: 4px 12px; border-radius: 6px; cursor: pointer; font-size: 13px; }
+.sub-dataflow__toolbar button:hover { border-color: var(--accent); color: var(--accent); }
+.sub-dataflow__viewport { width: 100%; max-height: 60vh; overflow: hidden; border-radius: 8px; background: #0b1220; }
+.sub-dataflow__viewport.is-grabbing { cursor: grabbing; }
+.sub-dataflow__viewport:not(.is-grabbing) { cursor: grab; }
+.sub-dataflow__svg { width: 100%; height: auto; max-height: 60vh; display: block; user-select: none; touch-action: none; }
+.sub-dataflow__badge { fill: var(--panel-soft); stroke: var(--accent); stroke-width: 1.4; }
+.sub-dataflow__badge-text { font-family: ui-sans-serif, system-ui, sans-serif; font-size: 13px; font-weight: 600; fill: var(--accent); }
+.sub-dataflow__step .sub-dataflow__box { fill: var(--panel-soft); stroke: var(--border); stroke-width: 1; }
+.sub-dataflow__step:hover .sub-dataflow__box { stroke: var(--accent); }
+.sub-dataflow__text { font-family: ui-sans-serif, system-ui, sans-serif; font-size: 14px; fill: var(--text); }
+.sub-dataflow__arrow { stroke: var(--muted); stroke-width: 1.6; }
+.sub-dataflow__fn-bg { fill: rgba(56, 189, 248, 0.12); stroke: var(--accent); stroke-width: 1; }
+.sub-dataflow__fn-text { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 11px; font-weight: 600; fill: var(--accent); letter-spacing: 0.02em; }
+.sub-dataflow__chip { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 11px; font-weight: 500; }
+.sub-dataflow__chip--reads { fill: var(--kind-service); }
+.sub-dataflow__chip--writes { fill: var(--kind-db); }
+.sub-dataflow__empty { color: var(--muted); font-style: italic; }