/* Native diagrams for selected guides. All rules stay inside their own component. */
.guide-diagram {
  --gd-bg: var(--doc-surface, #ffffff);
  --gd-soft: var(--doc-accent-soft, #eaf3fd);
  --gd-ink: var(--doc-text, #263c50);
  --gd-muted: var(--doc-text-muted, #596b7c);
  --gd-border: var(--doc-border-strong, #c5d2de);
  --gd-accent: var(--doc-accent-strong, #28649b);
  --gd-warning: var(--doc-warn-accent, #986c1b);
  --gd-warning-bg: var(--doc-warn-bg, #fbf3e0);
  container: guide-figure / inline-size;
  min-width: 0;
  margin: 2rem 0;
  padding: clamp(1.1rem, 2.5vw, 1.75rem);
  border: 1px solid var(--gd-border);
  border-radius: 10px;
  background: var(--gd-bg);
  color: var(--gd-ink);
  font-family: Inter, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
  font-size: 1rem;
  line-height: 1.6;
  scroll-margin-top: 6rem;
}
.guide-diagram.gd-dark {
  --gd-bg: #111d29;
  --gd-soft: #1c344a;
  --gd-ink: #e2edf7;
  --gd-muted: #aabfd2;
  --gd-border: #415b72;
  --gd-accent: #a0cdf4;
  --gd-warning: #e3b463;
  --gd-warning-bg: #312719;
}
.guide-diagram figcaption { display: block; margin: 0 0 1.5rem; }
.guide-diagram figcaption > strong { display: block; font-size: clamp(1.15rem, 2vw, 1.5rem); font-weight: 600; line-height: 1.3; letter-spacing: -.025em; text-wrap: balance; }
.guide-diagram .gd-kicker { display: block; margin-bottom: .65rem; color: var(--gd-accent); font-size: .6875rem; line-height: 1.5; text-transform: uppercase; letter-spacing: .1em; font-weight: 600; }
.guide-diagram strong { color: var(--gd-ink); font-weight: 600; }
.guide-diagram p { margin: .65rem 0 0; color: var(--gd-muted); font-size: .875rem; line-height: 1.65; }
.guide-diagram .gd-note { margin: 1.25rem 0 0; padding-top: 1rem; border-top: 1px solid var(--gd-border); color: var(--gd-muted); font-size: .8125rem; line-height: 1.7; }
.guide-diagram ul, .guide-diagram ol { list-style: none; padding: 0; margin: 0; }
.guide-diagram li { margin: 0; min-width: 0; }
.guide-diagram code { padding: 0; border: 0; border-radius: 0; background: none; color: inherit; font: .8125rem/1.6 Consolas, 'Courier New', monospace; white-space: normal; overflow-wrap: anywhere; }
.guide-diagram svg { display: block; width: 32px; height: 32px; fill: none; stroke: var(--gd-accent); stroke-width: 1.5; stroke-linecap: round; stroke-linejoin: round; }
.guide-diagram svg * { vector-effect: non-scaling-stroke; }
.guide-diagram .gd-label { display: block; margin-bottom: .4rem; color: var(--gd-muted); font-size: .6875rem; text-transform: uppercase; letter-spacing: .06em; line-height: 1.6; }

/* File/folder pairs stay attached to the tree; an entity stands on its own. */
@media (max-width: 768px) {
  /* The manual switches to a column flex layout with start alignment on mobile. */
  .doc-illustrated .docs-content { width: 100%; }
}
.guide-diagram .gd-project-root { display: flex; align-items: center; gap: .75rem; padding: .85rem 1rem; border: 1px solid var(--gd-border); border-radius: 7px; background: var(--gd-soft); }
.guide-diagram .gd-project-root svg { width: 22px; height: 22px; }
.guide-diagram .gd-project-root code { font-size: .9375rem; font-weight: 600; }
.guide-diagram .gd-resource-tree { padding: 1.25rem 0 0 1.25rem; margin-left: .75rem; border-left: 1px solid var(--gd-border); }
.guide-diagram .gd-resource-tree > li { position: relative; margin-bottom: 1.25rem; }
.guide-diagram .gd-resource-tree > li::before { content: ''; position: absolute; left: -1.25rem; top: 2rem; width: 1rem; border-top: 1px solid var(--gd-border); }
.guide-diagram .gd-resource-pair { display: grid; grid-template-columns: minmax(0, .8fr) 1.75rem minmax(0, 1.3fr); gap: .5rem; align-items: center; }
.guide-diagram .gd-resource-child { padding-left: 1rem; }
.guide-diagram .gd-resource-child::before { width: 2rem; }
.guide-diagram .gd-resource { padding: .5rem 0; }
.guide-diagram .gd-pair-link { text-align: center; color: var(--gd-accent); font-size: 1.5rem; }
.guide-diagram .gd-context { padding: .85rem 1rem; border: 1px solid var(--gd-border); border-radius: 7px; background: var(--gd-soft); }
.guide-diagram .gd-context strong { display: block; font-size: .875rem; }
.guide-diagram .gd-context code { display: block; margin: .2rem 0 .35rem; color: var(--gd-accent); font-size: .75rem; }
.guide-diagram .gd-context > span, .guide-diagram .gd-standalone > span:last-child { display: block; font-size: .8125rem; line-height: 1.6; color: var(--gd-muted); }
.guide-diagram .gd-standalone { padding: .85rem 1rem; border: 1px solid var(--gd-border); border-radius: 7px; }
.guide-diagram .gd-standalone code { display: block; margin-bottom: .35rem; color: var(--gd-accent); }
.guide-diagram .gd-resource-tree > li:last-child { margin-bottom: 0; }
.guide-diagram .gd-block-strip { padding-top: 1.3rem; font-size: .8125rem; color: var(--gd-muted); }
.guide-diagram .gd-block-strip ul { display: flex; flex-wrap: wrap; gap: .5rem; margin-top: .6rem; }
.guide-diagram .gd-block-strip li { padding: .25rem .6rem; border: 1px solid var(--gd-border); border-radius: 4px; color: var(--gd-accent); }

/* Highlighted sections are the endpoints, not the surrounding resource cards. */
.guide-diagram .gd-block-relation { display: grid; grid-template-columns: minmax(0, 1fr) 72px minmax(0, 1fr); gap: .65rem; align-items: center; }
.guide-diagram .gd-block-container { min-width: 0; padding: .9rem; border: 1px solid var(--gd-border); border-radius: 8px; }
.guide-diagram .gd-block-container > strong { display: block; font-size: .9375rem; }
.guide-diagram .gd-section-stack { display: flex; flex-direction: column; gap: .65rem; margin-top: 1.1rem; }
.guide-diagram .gd-section-stack li { padding: .5rem .65rem; border: 1px solid var(--gd-border); border-radius: 4px; color: var(--gd-muted); }
.guide-diagram .gd-section-stack .gd-selected-block { display: flex; flex-direction: column; justify-content: center; gap: .4rem; min-height: 8rem; border-color: var(--gd-accent); background: var(--gd-soft); color: var(--gd-ink); font-size: .875rem; line-height: 1.45; }
.guide-diagram .gd-selected-block code, .guide-diagram .gd-selected-block small { color: var(--gd-accent); }
.guide-diagram .gd-selected-block small { font-size: .6875rem; }
.guide-diagram .gd-relation-link { padding-top: 3rem; color: var(--gd-accent); text-align: center; font-size: .6875rem; }
.guide-diagram .gd-relation-link svg { width: 100%; height: 24px; margin-top: .35rem; }

/* Quick Start doubles as keyboard-accessible in-page navigation. */
.guide-diagram .gd-start-steps { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); gap: .8rem; margin-top: 1.25rem; }
.guide-diagram .gd-start-steps li { position: relative; }
.guide-diagram .gd-start-steps li:not(:last-child)::after { content: '→'; position: absolute; right: -.68rem; top: 3.25rem; color: var(--gd-accent); font-size: .8rem; }
.guide-diagram .gd-start-steps a { display: grid; grid-template-rows: auto 34px minmax(3rem, auto) 1fr; gap: .65rem; height: 100%; padding: .85rem .7rem; border: 1px solid var(--gd-border); border-radius: 7px; background: var(--gd-soft); color: var(--gd-ink); text-decoration: none; }
.guide-diagram .gd-start-steps a:hover { border-color: var(--gd-accent); background: #24425d; }
.guide-diagram .gd-start-steps a:focus-visible { outline: 2px solid var(--gd-accent); outline-offset: 4px; }
.guide-diagram .gd-step-number { color: var(--gd-accent); font: .75rem/1.5 Consolas, monospace; }
.guide-diagram .gd-start-steps strong { align-self: end; font-size: .9375rem; line-height: 1.45; font-weight: 500; }
.guide-diagram .gd-start-steps a > span:last-child { color: var(--gd-muted); font-size: .75rem; line-height: 1.5; }
.gd-quickstart ~ .qs-section-title[id] { scroll-margin-top: 5rem; }

/* Two independent setup requirements join one working session. */
.guide-diagram .gd-setup-pieces { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 1.5rem; }
.guide-diagram .gd-setup-piece { position: relative; padding: 1.15rem; border: 1px solid var(--gd-border); border-radius: 8px; }
.guide-diagram .gd-setup-piece::after { content: ''; position: absolute; top: 100%; left: 50%; height: 1rem; border-left: 1px solid var(--gd-accent); }
.guide-diagram .gd-setup-piece svg { width: 36px; height: 36px; margin-bottom: 1.1rem; }
.guide-diagram .gd-setup-piece > strong { display: block; font-size: 1.05rem; line-height: 1.5; }
.guide-diagram .gd-setup-join { position: relative; display: flex; align-items: center; justify-content: center; height: 76px; }
.guide-diagram .gd-setup-join::before { content: ''; position: absolute; left: calc((100% - 1.5rem) / 4); right: calc((100% - 1.5rem) / 4); top: 1rem; border-top: 1px solid var(--gd-accent); }
.guide-diagram .gd-setup-join::after { content: ''; position: absolute; top: 1rem; bottom: 0; left: 50%; border-left: 1px solid var(--gd-accent); }
.guide-diagram .gd-setup-join > span { position: relative; z-index: 1; width: 28px; height: 28px; border: 1px solid var(--gd-accent); border-radius: 50%; background: var(--gd-bg); color: var(--gd-accent); font-size: 1.2rem; line-height: 25px; text-align: center; }
.guide-diagram .gd-setup-result { display: flex; align-items: center; gap: 1rem; padding: 1.1rem; border: 1px solid var(--gd-accent); border-radius: 8px; background: var(--gd-soft); }
.guide-diagram .gd-setup-result svg { flex-shrink: 0; }
.guide-diagram .gd-setup-result strong { display: block; font-size: 1rem; }
.guide-diagram .gd-setup-result span { display: block; margin-top: .3rem; color: var(--gd-muted); font-size: .8125rem; line-height: 1.6; }

/* Illustrative sync states supplement, rather than replace, the ordered issue list. */
.guide-diagram .gd-issue-examples > li { padding: 1.25rem 0; border-top: 1px solid var(--gd-border); }
.guide-diagram .gd-issue-examples > li:first-child { padding-top: 0; border-top: 0; }
.guide-diagram .gd-issue-examples > li:last-child { padding-bottom: 0; }
.guide-diagram .gd-issue-heading strong { display: block; font-size: .9375rem; }
.guide-diagram .gd-issue-heading > span { display: block; margin-top: .25rem; color: var(--gd-muted); font-size: .8125rem; line-height: 1.6; }
.guide-diagram .gd-issue-pair { display: grid; grid-template-columns: minmax(0, 1fr) 1.75rem minmax(0, 1fr); align-items: stretch; gap: .5rem; margin-top: .8rem; }
.guide-diagram .gd-file-state { display: flex; flex-direction: column; justify-content: center; min-width: 0; gap: .35rem; padding: .75rem .85rem; border: 1px solid var(--gd-border); border-radius: 6px; background: var(--gd-soft); }
.guide-diagram .gd-file-state > strong { font-size: .8125rem; }
.guide-diagram .gd-file-state > span { color: var(--gd-muted); font-size: .75rem; line-height: 1.6; }
.guide-diagram .gd-issue-symbol { align-self: center; text-align: center; color: var(--gd-warning); font-size: 1.5rem; }
.guide-diagram .gd-review-state { background: var(--gd-warning-bg); border-color: var(--gd-warning); }
.guide-diagram .gd-ghost-state { background: #f3edf9; border-color: #9168b4; }
html[data-doc-theme="dark"] .guide-diagram .gd-ghost-state { background: #282036; border-color: #b499d1; }
.guide-diagram .gd-missing-state { background: none; border-style: dashed; }

/* About: many attempts leave reusable lessons that form a coherent product. */
.guide-diagram.gd-origin { clear: both; margin-block: 2.5rem; }
.guide-diagram .gd-origin-drawing { width: 100%; height: auto; margin-block: 1rem 1.5rem; }
.guide-diagram .gd-svg-muted { stroke: var(--gd-border); fill: none; }
.guide-diagram .gd-svg-line { stroke: var(--gd-accent); fill: none; }
.guide-diagram .gd-svg-selected { stroke: var(--gd-accent); fill: var(--gd-soft); }
.guide-diagram .gd-svg-node { stroke: var(--gd-accent); fill: var(--gd-bg); }
.guide-diagram .gd-origin-stages { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 1.25rem; }
.guide-diagram .gd-origin-stages strong { display: block; font-size: .9375rem; font-weight: 500; }
.guide-diagram .gd-origin-stages span { display: block; margin-top: .35rem; color: var(--gd-muted); font-size: .8125rem; line-height: 1.6; }

@container guide-figure (max-width: 520px) {
  .guide-diagram .gd-start-steps { grid-template-columns: minmax(0, 1fr); gap: 1rem; }
  .guide-diagram .gd-start-steps a { grid-template-columns: 1.5rem 32px minmax(0, 1fr); grid-template-rows: auto auto; align-items: center; gap: .2rem .85rem; padding: .85rem; }
  .guide-diagram .gd-step-number, .guide-diagram .gd-start-steps svg { grid-row: 1 / span 2; }
  .guide-diagram .gd-start-steps strong { align-self: auto; }
  .guide-diagram .gd-start-steps a > span:last-child { grid-column: 3; }
  .guide-diagram .gd-start-steps li:not(:last-child)::after { content: '↓'; left: 1.35rem; right: auto; top: 100%; line-height: 1rem; }
}
@container guide-figure (max-width: 480px) {
  .guide-diagram .gd-resource-pair { grid-template-columns: minmax(0, 1fr); gap: .2rem; }
  .guide-diagram .gd-resource-child { padding-left: 0; }
  .guide-diagram .gd-resource-child::before { width: 1rem; }
  .guide-diagram .gd-pair-link { transform: rotate(90deg); font-size: 1.25rem; line-height: 1.5; }
  .guide-diagram .gd-resource { padding-bottom: 0; }
  .guide-diagram .gd-block-relation { grid-template-columns: minmax(0, 1fr); gap: 1rem; }
  .guide-diagram .gd-relation-link { display: flex; align-items: center; justify-content: center; gap: .75rem; padding: 0; }
  .guide-diagram .gd-relation-link svg { width: 36px; height: 36px; margin: 0; transform: rotate(90deg); }
  .guide-diagram .gd-section-stack .gd-selected-block { min-height: 0; }
  .guide-diagram .gd-setup-pieces { grid-template-columns: minmax(0, 1fr); gap: 2rem; }
  .guide-diagram .gd-setup-piece::after { display: none; }
  .guide-diagram .gd-setup-piece + .gd-setup-piece::before { content: '+'; position: absolute; top: -2rem; left: calc(50% - .5rem); font-size: 1.25rem; line-height: 2rem; color: var(--gd-accent); }
  .guide-diagram .gd-setup-join { height: 2rem; }
  .guide-diagram .gd-setup-join::before, .guide-diagram .gd-setup-join > span { display: none; }
  .guide-diagram .gd-setup-join::after { top: 0; }
  .guide-diagram .gd-setup-result { align-items: flex-start; gap: .75rem; }
  .guide-diagram .gd-setup-result svg { width: 24px; height: 24px; }
  .guide-diagram .gd-origin-stages { gap: .75rem; }
  .guide-diagram .gd-origin-stages strong { font-size: .8125rem; }
  .guide-diagram .gd-origin-stages span { font-size: .75rem; }
  .guide-diagram .gd-file-state { padding: .65rem .55rem; }
}
@container guide-figure (max-width: 260px) {
  .guide-diagram .gd-issue-pair { grid-template-columns: minmax(0, 1fr); gap: .25rem; }
  .guide-diagram .gd-issue-symbol { font-size: 1.2rem; line-height: 1.3; }
}