breadcrumb-the-shire/web/css/pages/app-docs.css

@layer components {
  /* ─── Layout ─────────────────────────────────────────────────── */

  .app-docs-container {
    display: grid;
    grid-template-columns: 220px 1fr 200px;
    grid-template-areas: "nav content toc";
    align-items: start;
    gap: 0 2rem;
    min-height: 100%;
  }

  .app-docs-nav {
    grid-area: nav;
  }
  .app-docs-content {
    grid-area: content;
  }
  .app-docs-toc {
    grid-area: toc;
  }

  /* Stick nav and toc to viewport while scrolling */
  .app-docs-nav,
  .app-docs-toc {
    position: sticky;
    top: 70px;
    max-height: calc(100dvh - 6rem);
    overflow-y: auto;
    overscroll-behavior: contain;
  }

  @media (max-width: 1100px) {
    .app-docs-container {
      grid-template-columns: 220px 1fr;
      grid-template-areas: "nav content";
    }

    .app-docs-toc {
      display: none;
    }
  }

  @media (max-width: 768px) {
    .app-docs-container {
      grid-template-columns: 1fr;
      grid-template-areas:
        "nav"
        "content";
    }

    .app-docs-nav {
      position: static;
      max-height: none;
      overflow-y: visible;
      border-bottom: 1px solid var(--app-border);
      padding-bottom: 1rem;
      margin-bottom: 1rem;
    }
  }

  /* ─── Left navigation ─────────────────────────────────────────── */

  .app-docs-nav {
    --docs-nav-border-width: 2px;
    padding-block: 0.25rem;
  }

  .app-docs-nav-group {
    margin-bottom: 0.25rem;
  }

  .app-docs-nav-group details {
    border: 0;
    margin: 0;
    padding: 0;
  }

  .app-docs-nav-group summary {
    list-style: none;
    cursor: pointer;
    padding: 0;
  }

  .app-docs-nav-group summary small {
    font-size: var(--text-xs);
    letter-spacing: var(--tracking-wider);
    text-transform: uppercase;
    display: inline;
  }

  .app-docs-nav-group ul {
    margin-top: 0.1rem;
  }

  .app-docs-nav ul {
    list-style: none;
    margin: 0;
    padding: 0;
  }

  .app-docs-nav a {
    display: block;
    padding: 4px 0.75rem;
    color: inherit;
    border-left: var(--docs-nav-border-width) solid transparent;
    white-space: nowrap;
    overflow: hidden;
    text-overflow: ellipsis;
    font-size: var(--text-sm);
    border-radius: 0;
    text-decoration: none;
  }

  .app-docs-nav a:hover {
    color: var(--app-primary);
    border-left-color: var(--app-muted-border-color);
  }

  .app-docs-nav a.active {
    color: var(--app-primary);
    border-left-color: var(--app-primary);
    font-weight: var(--font-medium);
  }

  /* ─── TOC ─────────────────────────────────────────────────────── */

  .app-docs-toc {
    padding-block: 0.25rem;
  }

  .app-docs-toc > small {
    display: block;
    padding: 0 0 0.5rem;
    font-size: var(--text-xs);
    letter-spacing: var(--tracking-wider);
    text-transform: uppercase;
  }

  .app-docs-toc ul {
    margin: 0;
    padding: 0;
    list-style: none;
  }

  .app-docs-toc li {
    position: relative;
  }

  .app-docs-toc a {
    display: block;
    text-decoration: none;
    color: inherit;
    line-height: var(--leading-snug);
    padding-block: 0.12rem;
  }

  .app-docs-toc a:hover {
    color: var(--app-primary);
  }

  .app-docs-toc-level-2 {
    margin: 0;
    padding: 0 0 10px 0;
  }

  .app-docs-toc-level-3 {
    margin: 0;
    padding: 0;
    padding-left: 1rem;
  }

  .app-docs-toc-level-3 a {
    font-size: var(--text-xs);
    padding-left: 0.45rem;
  }

  .app-docs-toc-level-3::before {
    content: "";
    position: absolute;
    left: 0.2rem;
    top: 2px;
    width: 13px;
    height: 0.55rem;
    background: transparent;
    border-left: 1px solid var(--app-border);
    border-bottom: 1px solid var(--app-border);
    border-bottom-left-radius: 6px;
  }

  .app-docs-toc-level-3:has(+ .app-docs-toc-level-2) {
    margin-bottom: 1rem;
  }

  /* ─── Prose (rendered markdown) ────────────────────────────────── */

  .app-docs-content {
    max-width: 72ch;
    min-width: 0;
    background: transparent;
    box-shadow: none;
  }

  .app-docs-content h1,
  .app-docs-content h2,
  .app-docs-content h3,
  .app-docs-content h4,
  .app-docs-content h5,
  .app-docs-content h6 {
    scroll-margin-top: 1.5rem;
    line-height: var(--leading-snug);
  }

  .app-docs-content h1 {
    color: var(--app-h1-color);
    margin-top: 0;
    font-size: var(--text-4xl);
  }
  .app-docs-content h2 {
    color: var(--app-h2-color);
    font-size: var(--text-xl);
    margin-top: 2.5rem;
    padding-top: 1rem;
    border-top: 1px solid var(--app-border);
  }
  .app-docs-content h3 {
    color: var(--app-h3-color);
    font-size: var(--text-lg);
    margin-top: 1.75rem;
  }
  .app-docs-content h4 {
    color: var(--app-h4-color);
    font-size: var(--text-base);
    margin-top: 1.25rem;
  }
  .app-docs-content h5,
  .app-docs-content h6 {
    color: var(--app-h5-color);
    font-size: var(--text-sm);
    margin-top: 1rem;
  }

  .app-docs-content p {
    margin-block: 0.875rem;
    line-height: var(--leading-loose);
  }

  .app-docs-content a {
    color: var(--app-primary);
    text-decoration: underline;
    text-underline-offset: 0.15em;
  }

  .app-docs-content .app-breadcrumb a {
    text-decoration: none;
    color: inherit;
  }

  .app-docs-content a:hover {
    color: var(--app-primary-hover);
  }

  .app-docs-content ul,
  .app-docs-content ol {
    padding-left: 1.5rem;
    margin-block: 0.875rem;
  }

  .app-docs-content li {
    margin-block: 0.3rem;
    line-height: var(--leading-relaxed);
  }

  .app-docs-content li > ul,
  .app-docs-content li > ol {
    margin-block: 0.25rem;
  }

  .app-docs-content ul.contains-task-list,
  .app-docs-content ol.contains-task-list,
  .app-docs-content ul:has(> li > input[type="checkbox"]),
  .app-docs-content ol:has(> li > input[type="checkbox"]) {
    list-style: none;
    padding-left: 0;
  }

  .app-docs-content .task-list-item,
  .app-docs-content li:has(> input[type="checkbox"]) {
    list-style: none;
    position: relative;
    padding-left: 1.6rem;
  }

  .app-docs-content .task-list-item .task-list-item-checkbox,
  .app-docs-content .task-list-item > input[type="checkbox"] {
    position: absolute;
    left: 0;
    top: 0.3rem;
    width: 1rem;
    height: 1rem;
    margin: 0;
    accent-color: var(--app-primary);
  }

  .app-docs-content pre {
    background: var(--app-code-background-color);
    border: 1px solid var(--app-border);
    border-radius: var(--app-border-radius);
    padding: 1rem 1.25rem;
    overflow-x: auto;
    margin-block: 1.25rem;
  }

  .app-docs-content pre code {
    background: none;
    padding: 0;
    font-size: var(--text-sm);
    color: var(--app-color);
  }

  .app-docs-content blockquote {
    border-left: 3px solid var(--app-blockquote-border-color);
    margin-left: 0;
    margin-right: 0;
    padding: 0.5rem 1rem;
    background: var(--app-blockquote-background-color);
    border-radius: 0 var(--app-border-radius) var(--app-border-radius) 0;
    color: var(--app-muted-color);
  }

  .app-docs-content blockquote p {
    margin: 0;
  }

  .app-docs-content hr {
    border: 0;
    border-top: 1px solid var(--app-border);
    margin-block: 2rem;
  }

  .app-docs-content table {
    width: 100%;
    border-collapse: collapse;
    font-size: var(--text-sm);
    margin-block: 1.25rem;
    overflow-x: auto;
    display: block;
  }

  .app-docs-content th,
  .app-docs-content td {
    text-align: left;
    padding: 0.5rem 0.75rem;
    border: 1px solid var(--app-table-border-color);
  }

  .app-docs-content th {
    background: var(--app-code-background-color);
    font-weight: var(--font-semibold);
    color: var(--app-color);
  }

  .app-docs-content tbody tr:nth-child(odd) {
    background: var(--app-table-row-stripped-background-color);
  }

  .app-docs-content img {
    max-width: 100%;
    height: auto;
    border-radius: var(--app-border-radius);
  }

  /* HeadingPermalink anchors – keep invisible */
  .app-docs-content .docs-heading-anchor {
    display: none;
  }
}