/*
 * NetScript docs site theme.
 *
 * Ports the @netscript/fresh-ui + netscript-start playground SidebarShell chrome
 * down to a static Lume docs site. All values key off the --ns-* tokens copied
 * verbatim from packages/fresh-ui/registry/theme/tokens.css (see tokens.css).
 *
 * No Tailwind, no Preact, no build step — plain CSS only.
 */

@import "./tokens.css";

/* ─── Base / reset ───────────────────────────────────────────── */

*,
*::before,
*::after {
  box-sizing: border-box;
}

html {
  background: var(--ns-bg);
  color: var(--ns-fg);
  scroll-behavior: smooth;
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  color-scheme: dark;
  min-height: 100%;
}

html[data-theme="light"] {
  color-scheme: light;
}

body {
  margin: 0;
  background: var(--ns-bg);
  color: var(--ns-fg);
  font-family: var(--ns-font-sans);
  font-size: var(--ns-text-base);
  line-height: var(--ns-leading-normal);
  min-height: 100vh;
  -webkit-tap-highlight-color: var(--ns-primary-border);
  transition: background-color 0.2s ease, color 0.2s ease;
}

a {
  color: var(--ns-primary);
  text-decoration: none;
  touch-action: manipulation;
}

a:hover {
  color: var(--ns-primary-hover);
  text-decoration: underline;
}

button {
  touch-action: manipulation;
  font-family: inherit;
}

h1,
h2,
h3,
h4 {
  letter-spacing: var(--ns-tracking-tight);
  line-height: var(--ns-leading-tight);
  text-wrap: balance;
  scroll-margin-top: 5rem;
}

/* ─── Skip link ──────────────────────────────────────────────── */

.ns-skip-link {
  position: absolute;
  left: -9999px;
  top: 0;
  z-index: var(--ns-z-toast);
  padding: var(--ns-space-2) var(--ns-space-4);
  background: var(--ns-primary);
  color: var(--ns-primary-fg);
  border-radius: 0 0 var(--ns-radius-md) 0;
  font-size: var(--ns-text-sm);
  font-weight: 600;
}

.ns-skip-link:focus {
  left: 0;
  text-decoration: none;
}

/* ─── Dashboard shell (ported from playground layouts.css) ───── */

.ns-dashboard {
  display: grid;
  grid-template-columns: var(--ns-sidebar-width, 280px) minmax(0, 1fr);
  min-height: 100vh;
}

.ns-dashboard__sidebar {
  position: sticky;
  top: 0;
  align-self: start;
  display: flex;
  flex-direction: column;
  min-height: 100vh;
  max-height: 100vh;
  overflow-y: auto;
  border-right: 1px solid var(--ns-border);
  background: linear-gradient(
    180deg,
    color-mix(in srgb, var(--ns-card) 100%, transparent) 0%,
    color-mix(in srgb, var(--ns-bg) 92%, var(--ns-card)) 100%
  );
  scrollbar-width: thin;
  scrollbar-color: var(--ns-border-hover) transparent;
}

.ns-dashboard__sidebar-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--ns-space-3);
  height: 52px;
  padding-inline: var(--ns-space-5);
  border-bottom: 1px solid var(--ns-border);
  flex-shrink: 0;
}

.ns-dashboard__sidebar-body {
  display: flex;
  flex-direction: column;
  gap: var(--ns-space-1);
  padding: var(--ns-space-4) var(--ns-space-2-5, 0.625rem);
  flex: 1;
}

.ns-dashboard__sidebar-footer {
  display: flex;
  flex-direction: column;
  gap: var(--ns-space-2);
  padding: var(--ns-space-3) var(--ns-space-2-5, 0.625rem);
  border-top: 1px solid var(--ns-border);
  flex-shrink: 0;
}

.ns-dashboard__sidebar-env {
  display: flex;
  align-items: center;
  gap: var(--ns-space-2);
  padding: var(--ns-space-1-5) var(--ns-space-3);
}

.ns-dashboard__sidebar-env-label {
  font-family: var(--ns-font-mono);
  font-size: 0.625rem;
  font-weight: 500;
  letter-spacing: 0.04em;
  color: var(--ns-muted-fg);
  opacity: 0.7;
}

.ns-dashboard__nav-divider {
  height: 1px;
  margin: var(--ns-space-2) var(--ns-space-3);
  background: var(--ns-border);
  border: none;
}

.ns-dashboard__nav-group {
  display: flex;
  flex-direction: column;
  gap: 2px;
}

.ns-dashboard__nav-group-label {
  padding: var(--ns-space-3) var(--ns-space-3) var(--ns-space-1-5);
  font-family: var(--ns-font-mono);
  font-size: 0.625rem;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.16em;
  color: var(--ns-muted-fg);
  opacity: 0.6;
  user-select: none;
}

.ns-dashboard__nav-item {
  position: relative;
  display: flex;
  align-items: center;
  gap: var(--ns-space-2-5, 0.625rem);
  padding: var(--ns-space-1-5) var(--ns-space-3);
  border-radius: var(--ns-radius-md);
  font-size: var(--ns-text-sm);
  font-weight: 500;
  color: var(--ns-muted-fg);
  text-decoration: none;
  transition: background-color 140ms ease, color 140ms ease;
  min-height: 34px;
}

.ns-dashboard__nav-item:hover {
  background: color-mix(in srgb, var(--ns-surface-raised) 50%, transparent);
  color: var(--ns-fg);
  text-decoration: none;
}

.ns-dashboard__nav-item[aria-current="page"],
.ns-dashboard__nav-item.is-active {
  background: color-mix(in srgb, var(--ns-surface-raised) 85%, transparent);
  color: var(--ns-fg);
  font-weight: 600;
}

.ns-dashboard__nav-item[aria-current="page"]::before,
.ns-dashboard__nav-item.is-active::before {
  content: "";
  position: absolute;
  left: 0;
  top: 6px;
  bottom: 6px;
  width: 3px;
  border-radius: 0 2px 2px 0;
  background: var(--ns-primary);
  opacity: 0.85;
}

.ns-dashboard__nav-label {
  flex: 1;
  min-width: 0;
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}

.ns-dashboard__nav-icon {
  display: flex;
  align-items: center;
  justify-content: center;
  width: 24px;
  height: 24px;
  flex-shrink: 0;
  font-size: 0.75rem;
  line-height: 1;
  border-radius: var(--ns-radius-sm);
  background: color-mix(in srgb, var(--ns-surface-raised) 45%, transparent);
  border: 1px solid color-mix(in srgb, var(--ns-border) 70%, transparent);
  color: var(--ns-muted-fg);
  transition:
    background-color 140ms ease,
    border-color 140ms ease,
    color 140ms ease;
}

.ns-dashboard__nav-item:hover .ns-dashboard__nav-icon {
  border-color: var(--ns-border-hover);
  background: color-mix(in srgb, var(--ns-surface-raised) 70%, transparent);
  color: var(--ns-fg);
}

.ns-dashboard__nav-item[aria-current="page"] .ns-dashboard__nav-icon,
.ns-dashboard__nav-item.is-active .ns-dashboard__nav-icon {
  background: var(--ns-primary-subtle);
  border-color: color-mix(
    in srgb,
    var(--ns-primary) 25%,
    var(--ns-border-hover)
  );
  color: var(--ns-primary);
}

.ns-dashboard__main {
  display: flex;
  flex-direction: column;
  min-width: 0;
  min-height: 100vh;
  background: var(--ns-bg);
}

.ns-dashboard__topbar {
  position: sticky;
  top: 0;
  z-index: var(--ns-z-sticky);
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--ns-space-4);
  height: 52px;
  padding-inline: var(--ns-space-6);
  border-bottom: 1px solid var(--ns-border);
  background: color-mix(in srgb, var(--ns-bg) 82%, transparent);
  backdrop-filter: blur(12px);
  -webkit-backdrop-filter: blur(12px);
  flex-shrink: 0;
  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.04);
}

.ns-dashboard__content {
  flex: 1;
  min-width: 0;
  padding: var(--ns-space-5) var(--ns-space-6) var(--ns-space-12);
}

/* ─── Topbar brand + badge ───────────────────────────────────── */

.ns-topbar-brand {
  font-family: var(--ns-font-mono);
  font-size: var(--ns-text-sm);
  font-weight: 500;
  color: var(--ns-fg);
  letter-spacing: var(--ns-tracking-tight);
  text-decoration: none;
}

.ns-topbar-brand:hover {
  text-decoration: none;
  color: var(--ns-fg);
}

.ns-topbar-brand em {
  font-style: normal;
  color: var(--ns-accent);
}

.ns-cluster {
  display: flex;
  align-items: center;
  gap: var(--ns-space-3);
  min-width: 0;
}

.ns-cluster--end {
  gap: var(--ns-space-2);
}

.ns-badge {
  display: inline-flex;
  align-items: center;
  gap: var(--ns-space-1);
  white-space: nowrap;
}

.ns-badge--muted {
  border: 1px solid var(--ns-border);
  background: rgba(135, 132, 125, 0.06);
  padding: 0.125rem var(--ns-space-2);
  border-radius: var(--ns-radius-sm);
  font-family: var(--ns-font-mono);
  font-size: 0.67rem;
  font-weight: 500;
  text-transform: uppercase;
  letter-spacing: var(--ns-tracking-wide);
  color: var(--ns-muted-fg);
}

/* ─── Theme toggle + sidebar toggle buttons ──────────────────── */

.ns-icon-btn {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  height: 36px;
  width: 36px;
  border-radius: var(--ns-radius-md);
  border: 1px solid var(--ns-border);
  background: transparent;
  color: var(--ns-muted-fg);
  cursor: pointer;
  transition:
    border-color 150ms ease,
    background-color 150ms ease,
    color 150ms ease;
}

.ns-icon-btn:hover {
  border-color: var(--ns-border-hover);
  background: var(--ns-surface-raised);
  color: var(--ns-fg);
}

.ns-mobile-trigger {
  display: none;
}

/* Theme toggle: show the right icon per current theme. */
.ns-theme-toggle .ns-icon-sun {
  display: inline-flex;
}
.ns-theme-toggle .ns-icon-moon {
  display: none;
}
html[data-theme="light"] .ns-theme-toggle .ns-icon-sun {
  display: none;
}
html[data-theme="light"] .ns-theme-toggle .ns-icon-moon {
  display: inline-flex;
}

/* ─── Search box (pagefind UI lives in the topbar) ───────────── */

.ns-search {
  flex: 1;
  max-width: 360px;
  min-width: 0;
}

.ns-search .pagefind-ui {
  --pagefind-ui-scale: 0.8;
  --pagefind-ui-primary: var(--ns-primary);
  --pagefind-ui-text: var(--ns-fg);
  --pagefind-ui-background: var(--ns-surface);
  --pagefind-ui-border: var(--ns-input-border);
  --pagefind-ui-tag: var(--ns-surface-raised);
  --pagefind-ui-border-width: 1px;
  --pagefind-ui-border-radius: var(--ns-radius-md);
  --pagefind-ui-font: var(--ns-font-sans);
}

.ns-search .pagefind-ui__search-input {
  background: var(--ns-surface);
  color: var(--ns-fg);
  font-size: var(--ns-text-sm);
}

.ns-search .pagefind-ui__drawer {
  background: var(--ns-card);
  border: 1px solid var(--ns-border-hover);
  border-radius: var(--ns-radius-md);
  box-shadow: var(--ns-shadow-lg);
  position: absolute;
  z-index: var(--ns-z-dropdown);
  margin-top: var(--ns-space-2);
  width: min(420px, 90vw);
  padding: var(--ns-space-3);
}

.ns-search .pagefind-ui__result-link {
  color: var(--ns-fg);
}

/* ─── In-page TOC (right rail) ───────────────────────────────── */

.ns-content-rail {
  display: grid;
  gap: var(--ns-space-8);
}

@media (min-width: 1100px) {
  .ns-content-rail {
    grid-template-columns: minmax(0, 1fr) 15rem;
    align-items: start;
  }
}

.ns-toc {
  position: sticky;
  top: calc(52px + var(--ns-space-6));
  display: none;
  font-size: var(--ns-text-sm);
}

@media (min-width: 1100px) {
  .ns-toc {
    display: block;
  }
}

.ns-toc__title {
  font-family: var(--ns-font-mono);
  font-size: 0.625rem;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.16em;
  color: var(--ns-muted-fg);
  opacity: 0.7;
  margin-bottom: var(--ns-space-3);
}

.ns-toc ul {
  list-style: none;
  margin: 0;
  padding: 0;
  display: flex;
  flex-direction: column;
  gap: var(--ns-space-1);
}

.ns-toc a {
  color: var(--ns-muted-fg);
  text-decoration: none;
  display: block;
  padding: 2px 0;
  border-left: 2px solid transparent;
  padding-left: var(--ns-space-3);
  line-height: var(--ns-leading-snug);
}

.ns-toc a:hover {
  color: var(--ns-fg);
}

.ns-toc__level-3 {
  padding-left: var(--ns-space-5) !important;
  font-size: var(--ns-text-xs);
}

/* ─── Prose / markdown content ───────────────────────────────── */

.ns-prose {
  max-width: 80ch;
  font-size: 0.95rem;
  line-height: var(--ns-leading-relaxed);
  color: var(--ns-fg);
  overflow-x: auto;
  scrollbar-width: thin;
  scrollbar-color: var(--ns-border-strong) transparent;
}

.ns-prose > :first-child {
  margin-top: 0;
}

.ns-prose h1 {
  font-size: var(--ns-text-3xl);
  font-weight: 700;
  margin: 0 0 var(--ns-space-5);
  padding-bottom: var(--ns-space-4);
  border-bottom: 1px solid var(--ns-border);
}

.ns-prose h2 {
  font-size: var(--ns-text-2xl);
  font-weight: 700;
  margin: var(--ns-space-10) 0 var(--ns-space-4);
  padding-bottom: var(--ns-space-2);
  border-bottom: 1px solid var(--ns-border);
}

.ns-prose h3 {
  font-size: var(--ns-text-xl);
  font-weight: 600;
  margin: var(--ns-space-8) 0 var(--ns-space-3);
}

.ns-prose h4 {
  font-size: var(--ns-text-lg);
  font-weight: 600;
  margin: var(--ns-space-6) 0 var(--ns-space-2);
}

.ns-prose p {
  margin: 0 0 var(--ns-space-4);
}

.ns-prose ul,
.ns-prose ol {
  margin: 0 0 var(--ns-space-4);
  padding-left: var(--ns-space-6);
}

.ns-prose li {
  margin-bottom: var(--ns-space-2);
}

.ns-prose li > ul,
.ns-prose li > ol {
  margin-top: var(--ns-space-2);
  margin-bottom: 0;
}

.ns-prose strong {
  color: var(--ns-fg);
  font-weight: 600;
}

.ns-prose hr {
  border: none;
  border-top: 1px solid var(--ns-border);
  margin: var(--ns-space-8) 0;
}

/* Heading anchor links (markdown-it-anchor) */
.ns-prose :is(h1, h2, h3, h4) > a[href^="#"] {
  color: inherit;
  text-decoration: none;
}

.ns-prose :is(h1, h2, h3, h4) > a[href^="#"]:hover {
  color: var(--ns-primary);
}

/* ─── Inline + block code ────────────────────────────────────── */

.ns-prose code {
  font-family: var(--ns-font-mono);
  font-size: 0.85em;
  background: color-mix(in srgb, var(--ns-surface-raised) 70%, transparent);
  border: 1px solid var(--ns-border);
  border-radius: var(--ns-radius-sm);
  padding: 0.15em 0.4em;
  color: var(--ns-copper-3);
  overflow-wrap: anywhere;
  word-break: break-word;
}

.ns-prose pre {
  font-family: var(--ns-font-mono);
  font-size: var(--ns-text-sm);
  line-height: var(--ns-leading-normal);
  background: color-mix(in srgb, var(--ns-gray-11) 94%, var(--ns-copper-8));
  border: 1px solid var(--ns-border-strong);
  border-radius: var(--ns-radius-lg);
  padding: var(--ns-space-4) var(--ns-space-5);
  overflow-x: auto;
  margin: 0 0 var(--ns-space-5);
  box-shadow: var(--ns-shadow-sm);
  scrollbar-width: thin;
  scrollbar-color: var(--ns-border-strong) transparent;
}

[data-theme="light"] .ns-prose pre {
  background: color-mix(in srgb, var(--ns-gray-2) 88%, var(--ns-slate-1));
}

.ns-prose pre code {
  background: none;
  border: none;
  padding: 0;
  color: var(--ns-gray-2);
  font-size: inherit;
  white-space: pre;
  overflow-wrap: normal;
  word-break: normal;
}

[data-theme="light"] .ns-prose pre code {
  color: var(--ns-gray-11);
}

.ns-prose pre code.hljs {
  display: block;
}

.ns-prose pre .hljs-comment,
.ns-prose pre .hljs-quote {
  color: var(--ns-slate-4);
  font-style: italic;
}

.ns-prose pre .hljs-keyword,
.ns-prose pre .hljs-selector-tag,
.ns-prose pre .hljs-built_in,
.ns-prose pre .hljs-literal,
.ns-prose pre .hljs-type {
  color: var(--ns-copper-3);
}

.ns-prose pre .hljs-string,
.ns-prose pre .hljs-regexp,
.ns-prose pre .hljs-template-variable {
  color: var(--ns-teal-2);
}

.ns-prose pre .hljs-number,
.ns-prose pre .hljs-attr,
.ns-prose pre .hljs-variable,
.ns-prose pre .hljs-property {
  color: var(--ns-amber-4);
}

.ns-prose pre .hljs-title,
.ns-prose pre .hljs-title.function_,
.ns-prose pre .hljs-title.class_,
.ns-prose pre .hljs-function,
.ns-prose pre .hljs-params {
  color: var(--ns-slate-2);
}

.ns-prose pre .hljs-punctuation,
.ns-prose pre .hljs-operator,
.ns-prose pre .hljs-subst {
  color: var(--ns-gray-4);
}

.ns-prose pre .hljs-meta,
.ns-prose pre .hljs-doctag,
.ns-prose pre .hljs-section,
.ns-prose pre .hljs-name {
  color: var(--ns-red-4);
}

[data-theme="light"] .ns-prose pre .hljs-comment,
[data-theme="light"] .ns-prose pre .hljs-quote {
  color: var(--ns-slate-6);
}

[data-theme="light"] .ns-prose pre .hljs-keyword,
[data-theme="light"] .ns-prose pre .hljs-selector-tag,
[data-theme="light"] .ns-prose pre .hljs-built_in,
[data-theme="light"] .ns-prose pre .hljs-literal,
[data-theme="light"] .ns-prose pre .hljs-type {
  color: var(--ns-copper-7);
}

[data-theme="light"] .ns-prose pre .hljs-string,
[data-theme="light"] .ns-prose pre .hljs-regexp,
[data-theme="light"] .ns-prose pre .hljs-template-variable {
  color: var(--ns-teal-7);
}

[data-theme="light"] .ns-prose pre .hljs-number,
[data-theme="light"] .ns-prose pre .hljs-attr,
[data-theme="light"] .ns-prose pre .hljs-variable,
[data-theme="light"] .ns-prose pre .hljs-property {
  color: var(--ns-amber-6);
}

[data-theme="light"] .ns-prose pre .hljs-title,
[data-theme="light"] .ns-prose pre .hljs-title.function_,
[data-theme="light"] .ns-prose pre .hljs-title.class_,
[data-theme="light"] .ns-prose pre .hljs-function,
[data-theme="light"] .ns-prose pre .hljs-params {
  color: var(--ns-slate-7);
}

[data-theme="light"] .ns-prose pre .hljs-punctuation,
[data-theme="light"] .ns-prose pre .hljs-operator,
[data-theme="light"] .ns-prose pre .hljs-subst {
  color: var(--ns-gray-7);
}

[data-theme="light"] .ns-prose pre .hljs-meta,
[data-theme="light"] .ns-prose pre .hljs-doctag,
[data-theme="light"] .ns-prose pre .hljs-section,
[data-theme="light"] .ns-prose pre .hljs-name {
  color: var(--ns-red-6);
}

/* ─── Tables ─────────────────────────────────────────────────── */

.ns-prose table {
  width: 100%;
  min-width: 42rem;
  border-collapse: separate;
  border-spacing: 0;
  margin: 0 0 var(--ns-space-5);
  font-size: var(--ns-text-sm);
  display: block;
  overflow-x: auto;
  border: 1px solid var(--ns-border-strong);
  border-radius: var(--ns-radius-lg);
  line-height: var(--ns-leading-normal);
  scrollbar-width: thin;
  scrollbar-color: var(--ns-border-strong) transparent;
}

.ns-prose th {
  border-bottom: 1px solid var(--ns-border-strong);
  border-right: 1px solid var(--ns-border);
  background: color-mix(in srgb, var(--ns-surface-raised) 82%, var(--ns-primary-subtle));
  padding: var(--ns-space-3) var(--ns-space-4);
  text-align: left;
  font-size: var(--ns-text-xs);
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: var(--ns-tracking-wide);
  color: var(--ns-fg);
  white-space: nowrap;
}

.ns-prose td {
  border-bottom: 1px solid var(--ns-border);
  border-right: 1px solid var(--ns-border);
  padding: var(--ns-space-3) var(--ns-space-4);
  color: var(--ns-fg);
  vertical-align: top;
}

.ns-prose th:last-child,
.ns-prose td:last-child {
  border-right: 0;
}

.ns-prose tbody tr:nth-child(even) td {
  background: color-mix(in srgb, var(--ns-surface-raised) 34%, transparent);
}

.ns-prose tbody tr:last-child td {
  border-bottom: 0;
}

.ns-prose tbody tr:hover td {
  background: color-mix(in srgb, var(--ns-primary-subtle) 70%, transparent);
}

/* ─── Blockquotes ────────────────────────────────────────────── */

.ns-prose blockquote {
  margin: 0 0 var(--ns-space-5);
  padding: var(--ns-space-3) var(--ns-space-5);
  border-left: 3px solid var(--ns-primary);
  background: var(--ns-primary-subtle);
  border-radius: 0 var(--ns-radius-md) var(--ns-radius-md) 0;
  color: var(--ns-muted-fg);
}

.ns-prose blockquote > :last-child {
  margin-bottom: 0;
}

/* ─── Documentation components ──────────────────────────────── */

.ns-breadcrumb {
  margin: 0 0 1rem;
  font-size: 0.85rem;
}

.ns-breadcrumb__list {
  list-style: none;
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: 0.35rem;
  margin: 0;
  padding: 0;
}

.ns-breadcrumb__item {
  display: inline-flex;
  align-items: center;
  gap: 0.35rem;
  color: var(--ns-text-muted, rgba(255, 255, 255, 0.6));
}

.ns-breadcrumb__sep {
  color: var(--ns-border, rgba(255, 255, 255, 0.3));
}

.ns-breadcrumb a {
  color: var(--ns-text-muted, rgba(255, 255, 255, 0.6));
  text-decoration: none;
}

.ns-breadcrumb a:hover {
  color: var(--ns-accent, #5b8def);
  text-decoration: underline;
}

.ns-breadcrumb__item[aria-current="page"] {
  color: var(--ns-text, inherit);
  font-weight: 500;
}

.ns-hero {
  display: flex;
  flex-direction: column;
  gap: 1rem;
  padding: 2.5rem 0 2rem;
  border-bottom: 1px solid var(--ns-border, rgba(255, 255, 255, 0.12));
  margin: 0 0 2rem;
}

.ns-hero__tagline {
  margin: 0;
  font-size: var(--ns-text-3xl, 2.25rem);
  font-weight: 700;
  line-height: var(--ns-leading-tight, 1.15);
  letter-spacing: var(--ns-tracking-tight, -0.02em);
  color: var(--ns-fg, inherit);
  max-width: 24ch;
}

.ns-hero__subhead {
  margin: 0;
  max-width: 60ch;
  font-size: var(--ns-text-lg, 1.15rem);
  line-height: var(--ns-leading-relaxed, 1.6);
  color: var(--ns-muted-fg, rgba(255, 255, 255, 0.7));
}

.ns-hero__ctas {
  display: flex;
  flex-wrap: wrap;
  gap: 0.75rem;
  margin-top: 0.5rem;
}

.ns-hero__cta {
  display: inline-flex;
  align-items: center;
  gap: 0.4rem;
  padding: 0.6rem 1.1rem;
  border-radius: var(--ns-radius-md, 8px);
  font-weight: 600;
  text-decoration: none;
  font-size: var(--ns-text-sm, 0.95rem);
  border: 1px solid var(--ns-border, rgba(255, 255, 255, 0.14));
  color: var(--ns-fg, inherit);
  background: transparent;
  transition: border-color 0.15s ease, background 0.15s ease;
}

.ns-hero__cta:hover {
  border-color: var(--ns-border-hover, var(--ns-accent, #5b8def));
}

.ns-hero__cta:focus-visible {
  outline: 2px solid var(--ns-accent, #5b8def);
  outline-offset: 2px;
}

.ns-hero__cta--primary {
  background: var(--ns-primary, #8957e5);
  border-color: var(--ns-primary-border, var(--ns-primary, #8957e5));
  color: var(--ns-primary-fg, #fff);
}

.ns-hero__cta--primary:hover {
  background: var(--ns-primary-hover, #7a48d6);
  border-color: var(--ns-primary-hover, #7a48d6);
}

.ns-card {
  display: flex;
  flex-direction: column;
  gap: 0.4rem;
  padding: 1.1rem 1.15rem;
  border: 1px solid var(--ns-border, rgba(255, 255, 255, 0.12));
  border-radius: var(--ns-radius-md, 8px);
  background: var(--ns-card, var(--ns-surface, rgba(255, 255, 255, 0.02)));
  height: 100%;
  color: inherit;
  text-decoration: none;
  transition: border-color 0.15s ease, transform 0.15s ease;
}

a.ns-card:hover,
a.ns-card:focus-visible {
  border-color: var(--ns-border-hover, var(--ns-accent, #5b8def));
}

a.ns-card:focus-visible {
  outline: 2px solid var(--ns-accent, #5b8def);
  outline-offset: 2px;
}

.ns-card__head {
  display: flex;
  align-items: center;
  gap: 0.55rem;
}

.ns-card__icon {
  flex: 0 0 auto;
  font-size: 1.15rem;
  line-height: 1;
}

.ns-card__title {
  margin: 0;
  font-size: var(--ns-text-base, 1rem);
  font-weight: 600;
  color: var(--ns-fg, inherit);
}

.ns-card__body {
  margin: 0;
  color: var(--ns-muted-fg, rgba(255, 255, 255, 0.7));
  font-size: var(--ns-text-sm, 0.92rem);
  line-height: var(--ns-leading-relaxed, 1.6);
}

.ns-feature-grid {
  display: grid;
  gap: 1rem;
  margin: 1.5rem 0;
  grid-template-columns: repeat(auto-fit, minmax(15rem, 1fr));
}

.ns-callout {
  display: flex;
  gap: 0.75rem;
  padding: 1rem 1.1rem;
  border-radius: var(--ns-radius-md, 8px);
  border: 1px solid var(--ns-border, rgba(255, 255, 255, 0.12));
  margin: 1.25rem 0;
  background: var(--ns-surface-2, var(--ns-card, rgba(255, 255, 255, 0.03)));
}

.ns-callout__icon {
  flex: 0 0 auto;
  font-weight: 600;
  line-height: var(--ns-leading-normal, 1.5);
}

.ns-callout__title {
  font-weight: 600;
  margin: 0 0 0.25rem;
}

.ns-callout__body {
  min-width: 0;
}

.ns-callout__body > :first-child {
  margin-top: 0;
}

.ns-callout__body > :last-child {
  margin-bottom: 0;
}

.ns-callout--note {
  border-left: 3px solid var(--ns-accent, #5b8def);
}

.ns-callout--tip {
  border-left: 3px solid var(--ns-success, #3fb950);
}

.ns-callout--important {
  border-left: 3px solid var(--ns-primary, #8957e5);
}

.ns-callout--warning {
  border-left: 3px solid var(--ns-warning, #d29922);
}

.ns-learning-path {
  display: flex;
  flex-wrap: wrap;
  gap: 0.5rem;
  align-items: stretch;
  list-style: none;
  counter-reset: ns-step;
  padding: 0;
  margin: 1.5rem 0;
}

.ns-learning-path__step {
  display: flex;
}

.ns-learning-path__link {
  counter-increment: ns-step;
  display: inline-flex;
  align-items: center;
  gap: 0.55rem;
  padding: 0.55rem 0.9rem;
  border-radius: var(--ns-radius-md, 8px);
  border: 1px solid var(--ns-border, rgba(255, 255, 255, 0.12));
  background: var(--ns-card, var(--ns-surface, rgba(255, 255, 255, 0.02)));
  color: inherit;
  text-decoration: none;
  font-size: var(--ns-text-sm, 0.92rem);
  font-weight: 500;
  transition: border-color 0.15s ease;
}

.ns-learning-path__link:hover {
  border-color: var(--ns-border-hover, var(--ns-accent, #5b8def));
}

.ns-learning-path__link:focus-visible {
  outline: 2px solid var(--ns-accent, #5b8def);
  outline-offset: 2px;
}

.ns-learning-path__link::before {
  content: counter(ns-step);
  flex: 0 0 auto;
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 1.4rem;
  height: 1.4rem;
  border-radius: 999px;
  font-size: var(--ns-text-xs, 0.75rem);
  font-weight: 700;
  background: var(--ns-primary-subtle, rgba(137, 87, 229, 0.15));
  color: var(--ns-primary, #8957e5);
}

.ns-api-table-wrap {
  overflow-x: auto;
  margin: 1.5rem 0;
  border: 1px solid var(--ns-border-strong, rgba(255, 255, 255, 0.18));
  border-radius: var(--ns-radius-lg, 8px);
  background: color-mix(in srgb, var(--ns-surface) 90%, transparent);
  scrollbar-width: thin;
  scrollbar-color: var(--ns-border-strong) transparent;
}

.ns-api-table {
  width: 100%;
  min-width: 44rem;
  border-collapse: separate;
  border-spacing: 0;
  font-size: var(--ns-text-sm, 0.92rem);
  line-height: var(--ns-leading-normal, 1.5);
}

.ns-api-table caption {
  caption-side: top;
  text-align: left;
  padding: 0.75rem 1rem;
  font-weight: 600;
  color: var(--ns-fg, inherit);
  border-bottom: 1px solid var(--ns-border-strong, rgba(255, 255, 255, 0.18));
  background: color-mix(in srgb, var(--ns-card) 70%, transparent);
}

.ns-api-table th,
.ns-api-table td {
  text-align: left;
  padding: 0.75rem 1rem;
  vertical-align: top;
  border-bottom: 1px solid var(--ns-border, rgba(255, 255, 255, 0.08));
  border-right: 1px solid var(--ns-border, rgba(255, 255, 255, 0.08));
}

.ns-api-table thead th {
  font-weight: 700;
  color: var(--ns-fg, inherit);
  background: color-mix(in srgb, var(--ns-surface-raised) 82%, var(--ns-primary-subtle));
  font-size: var(--ns-text-xs, 0.78rem);
  text-transform: uppercase;
  letter-spacing: var(--ns-tracking-wide, 0.04em);
}

.ns-api-table th:last-child,
.ns-api-table td:last-child {
  border-right: 0;
}

.ns-api-table tbody tr:nth-child(even) td {
  background: color-mix(in srgb, var(--ns-surface-raised) 34%, transparent);
}

.ns-api-table tbody tr:last-child td {
  border-bottom: 0;
}

.ns-api-table__name {
  font-family: var(--ns-font-mono, ui-monospace, monospace);
  font-weight: 600;
  color: var(--ns-fg, inherit);
  white-space: nowrap;
}

.ns-prose .ns-api-table__name code,
.ns-prose .ns-api-table__type code {
  display: inline-block;
  background: color-mix(
    in srgb,
    var(--ns-surface-raised) 88%,
    var(--ns-primary-subtle)
  );
  border-color: var(--ns-border-strong, rgba(255, 255, 255, 0.18));
  color: var(--ns-gray-1);
}

.ns-api-table__type {
  font-family: var(--ns-font-mono, ui-monospace, monospace);
  color: var(--ns-accent, #5b8def);
}

.ns-prose .ns-api-table__type code {
  color: var(--ns-teal-2);
}

.ns-api-table__desc {
  color: var(--ns-fg, inherit);
  line-height: var(--ns-leading-normal, 1.5);
}

[data-theme="light"] .ns-prose .ns-api-table__name code,
[data-theme="light"] .ns-prose .ns-api-table__type code {
  background: color-mix(
    in srgb,
    var(--ns-surface-raised) 82%,
    var(--ns-primary-subtle)
  );
  border-color: var(--ns-border-strong, rgba(0, 0, 0, 0.22));
  color: var(--ns-gray-12);
}

[data-theme="light"] .ns-prose .ns-api-table__type code {
  color: var(--ns-teal-7);
}

.ns-tabbed {
  margin: 1.5rem 0;
  border: 1px solid var(--ns-border, rgba(255, 255, 255, 0.12));
  border-radius: var(--ns-radius-md, 8px);
  overflow: hidden;
}

.ns-tabbed__tablist {
  display: flex;
  flex-wrap: wrap;
  gap: 0.15rem;
  padding: 0.35rem 0.35rem 0;
  background: var(--ns-surface-2, var(--ns-surface, rgba(255, 255, 255, 0.02)));
  border-bottom: 1px solid var(--ns-border, rgba(255, 255, 255, 0.12));
}

.ns-tabbed__tab {
  appearance: none;
  cursor: pointer;
  border: 0;
  background: transparent;
  padding: 0.45rem 0.85rem;
  border-radius: var(--ns-radius-sm, 6px) var(--ns-radius-sm, 6px) 0 0;
  font: inherit;
  font-size: var(--ns-text-sm, 0.9rem);
  font-weight: 500;
  color: var(--ns-muted-fg, rgba(255, 255, 255, 0.7));
}

.ns-tabbed__tab:hover {
  color: var(--ns-fg, inherit);
}

.ns-tabbed__tab:focus-visible {
  outline: 2px solid var(--ns-accent, #5b8def);
  outline-offset: -2px;
}

.ns-tabbed__tab.is-active {
  color: var(--ns-fg, inherit);
  background: var(--ns-card, var(--ns-bg, rgba(0, 0, 0, 0.2)));
  box-shadow: inset 0 -2px 0 0 var(--ns-primary, #8957e5);
}

.ns-tabbed__panel {
  margin: 0;
}

.ns-tabbed__panel pre {
  margin: 0;
}

.ns-tabbed.is-enhanced .ns-tabbed__panel[hidden] {
  display: none;
}

.ns-tabbed.is-enhanced .ns-tabbed__panel:not([hidden]) {
  display: block;
}

.ns-nextprev {
  display: flex;
  gap: 1rem;
  justify-content: space-between;
  margin: 2.5rem 0 0;
  padding-top: 1.5rem;
  border-top: 1px solid var(--ns-border, rgba(255, 255, 255, 0.12));
}

.ns-nextprev__link {
  display: flex;
  flex-direction: column;
  gap: 0.2rem;
  flex: 1 1 0;
  min-width: 0;
  padding: 0.75rem 1rem;
  border-radius: var(--ns-radius-md, 8px);
  border: 1px solid var(--ns-border, rgba(255, 255, 255, 0.12));
  background: var(--ns-surface-2, rgba(255, 255, 255, 0.03));
  text-decoration: none;
  color: var(--ns-text, inherit);
  transition: border-color 0.15s ease;
}

.ns-nextprev__link:hover {
  border-color: var(--ns-accent, #5b8def);
}

.ns-nextprev__link--next {
  text-align: right;
  align-items: flex-end;
}

.ns-nextprev__dir {
  font-size: 0.75rem;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--ns-text-muted, rgba(255, 255, 255, 0.55));
}

.ns-nextprev__label {
  font-weight: 600;
}

/* ─── Mobile / responsive (ported from playground) ──────────── */

.ns-dashboard__sidebar-backdrop {
  display: none;
}

@media (max-width: 1024px) {
  .ns-dashboard {
    grid-template-columns: minmax(0, 1fr);
  }

  .ns-mobile-trigger {
    display: inline-flex;
  }

  .ns-dashboard__sidebar {
    position: fixed;
    top: 0;
    left: 0;
    z-index: var(--ns-z-overlay);
    width: 280px;
    transform: translateX(-100%);
    transition: transform 200ms cubic-bezier(0.4, 0, 0.2, 1);
    box-shadow: none;
  }

  .ns-dashboard__sidebar.is-open {
    transform: translateX(0);
    box-shadow: 16px 0 48px rgba(0, 0, 0, 0.3), 4px 0 12px rgba(0, 0, 0, 0.15);
  }

  .ns-dashboard__sidebar-backdrop {
    position: fixed;
    inset: 0;
    z-index: calc(var(--ns-z-overlay) - 1);
    background: rgba(0, 0, 0, 0.4);
    opacity: 0;
    pointer-events: none;
    transition: opacity 200ms ease;
    display: block;
  }

  .ns-dashboard__sidebar-backdrop.is-visible {
    opacity: 1;
    pointer-events: auto;
  }

  .ns-dashboard__content {
    padding-inline: var(--ns-space-5);
  }

  .ns-dashboard__topbar {
    padding-inline: var(--ns-space-4);
  }
}

@media (max-width: 640px) {
  .ns-dashboard__content {
    padding-inline: var(--ns-space-4);
    padding-top: var(--ns-space-4);
  }

  .ns-hide-mobile {
    display: none !important;
  }

  .ns-search {
    max-width: 160px;
  }
}

/* ═══════════════════════════════════════════════════════════════════
   Docs v3 foundation components (S01–S03). All rules key off the
   fresh-ui --ns-* token palette and are additive / backward-compatible.
   ═══════════════════════════════════════════════════════════════════ */

/* ─── comp.diagram (S01): committed-SVG figure ───────────────────── */
.ns-diagram {
  margin: var(--ns-space-6) 0;
  padding: var(--ns-space-4);
  border: 1px solid var(--ns-border);
  border-radius: var(--ns-radius-lg);
  background: var(--ns-surface);
  text-align: center;
}

.ns-diagram__img {
  display: block;
  max-width: 100%;
  height: auto;
  margin: 0 auto;
}

.ns-diagram__caption {
  margin-top: var(--ns-space-3);
  font-size: var(--ns-text-sm);
  color: var(--ns-muted-fg);
  line-height: var(--ns-leading-snug);
}

/* ─── comp.xref (S02): resolved cross-reference link ─────────────── */
.ns-xref {
  color: var(--ns-primary);
  text-decoration: underline;
  text-underline-offset: 2px;
  text-decoration-thickness: 1px;
}

.ns-xref:hover,
.ns-xref:focus-visible {
  color: var(--ns-primary-hover);
}

/* ─── comp.badge (S03): status badges ────────────────────────────── */
.ns-badge--stable,
.ns-badge--alpha,
.ns-badge--partial {
  padding: 0.125rem var(--ns-space-2);
  border-radius: var(--ns-radius-sm);
  border: 1px solid var(--ns-border);
  font-family: var(--ns-font-mono);
  font-size: 0.67rem;
  font-weight: 500;
  text-transform: uppercase;
  letter-spacing: var(--ns-tracking-wide);
}

.ns-badge--stable {
  color: var(--ns-success);
  background: var(--ns-success-subtle);
  border-color: var(--ns-success-border);
}

.ns-badge--alpha {
  color: var(--ns-warning);
  background: var(--ns-warning-subtle);
  border-color: var(--ns-warning-border);
}

.ns-badge--partial {
  color: var(--ns-secondary);
  background: var(--ns-secondary-subtle);
  border-color: var(--ns-secondary-border);
}

/* ─── comp.cardsGrid (S03): Learn/Do/Reference triplet grid ──────── */
.ns-cards-grid {
  display: grid;
  grid-template-columns: 1fr;
  gap: var(--ns-space-4);
  margin: var(--ns-space-6) 0;
}

@media (min-width: 720px) {
  .ns-cards-grid[data-columns="2"] {
    grid-template-columns: repeat(2, 1fr);
  }
  .ns-cards-grid[data-columns="3"],
  .ns-cards-grid[data-columns="4"] {
    grid-template-columns: repeat(2, 1fr);
  }
}

@media (min-width: 1024px) {
  .ns-cards-grid[data-columns="3"] {
    grid-template-columns: repeat(3, 1fr);
  }
  .ns-cards-grid[data-columns="4"] {
    grid-template-columns: repeat(4, 1fr);
  }
}

.ns-cards-grid__card {
  display: flex;
  flex-direction: column;
  gap: var(--ns-space-2);
  padding: var(--ns-space-4);
  border: 1px solid var(--ns-border);
  border-radius: var(--ns-radius-lg);
  background: var(--ns-card);
  color: var(--ns-card-fg);
  text-decoration: none;
}

a.ns-cards-grid__card:hover,
a.ns-cards-grid__card:focus-visible {
  border-color: var(--ns-border-hover);
  box-shadow: var(--ns-shadow-sm);
}

a.ns-cards-grid__card:focus-visible {
  outline: 2px solid var(--ns-ring);
  outline-offset: 2px;
}

.ns-cards-grid__eyebrow {
  font-family: var(--ns-font-mono);
  font-size: 0.625rem;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: var(--ns-tracking-wide);
  color: var(--ns-primary);
}

.ns-cards-grid__head {
  display: inline-flex;
  align-items: center;
  gap: var(--ns-space-2);
}

.ns-cards-grid__icon {
  color: var(--ns-muted-fg);
}

.ns-cards-grid__title {
  font-weight: 600;
  color: var(--ns-fg);
}

.ns-cards-grid__body {
  margin: 0;
  font-size: var(--ns-text-sm);
  color: var(--ns-muted-fg);
  line-height: var(--ns-leading-snug);
}

/* ─── comp.fileTree (S03): project file tree ─────────────────────── */
.ns-file-tree {
  list-style: none;
  margin: var(--ns-space-4) 0;
  padding: 0;
  font-family: var(--ns-font-mono);
  font-size: var(--ns-text-sm);
  line-height: var(--ns-leading-relaxed);
}

.ns-file-tree--root {
  padding: var(--ns-space-4);
  border: 1px solid var(--ns-border);
  border-radius: var(--ns-radius-lg);
  background: var(--ns-surface);
}

.ns-file-tree .ns-file-tree {
  margin: 0;
  padding: 0 0 0 var(--ns-space-4);
  border: 0;
  background: transparent;
  border-left: 1px solid var(--ns-border);
  margin-left: var(--ns-space-2);
}

.ns-file-tree__row {
  display: flex;
  align-items: baseline;
  gap: var(--ns-space-2);
}

.ns-file-tree__icon {
  color: var(--ns-muted-fg);
  flex: none;
}

.ns-file-tree__item--dir > .ns-file-tree__row > .ns-file-tree__name {
  color: var(--ns-fg);
  font-weight: 500;
}

.ns-file-tree__name {
  color: var(--ns-card-fg);
}

.ns-file-tree__comment {
  color: var(--ns-muted-fg);
  font-style: italic;
  opacity: 0.85;
}

/* ─── On-page TOC (S03): scroll-spy right rail / collapsible mobile ─ */
.ns-toc__summary {
  appearance: none;
  cursor: pointer;
  border: 0;
  background: transparent;
  padding: 0;
  font-family: var(--ns-font-mono);
  font-size: 0.625rem;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.16em;
  color: var(--ns-muted-fg);
  opacity: 0.7;
  margin-bottom: var(--ns-space-3);
}

.ns-toc__list {
  list-style: none;
  margin: 0;
  padding: 0;
  display: flex;
  flex-direction: column;
  gap: var(--ns-space-1);
}

.ns-toc.is-collapsed .ns-toc__list {
  display: none;
}

.ns-toc__item--h3 {
  padding-left: var(--ns-space-3);
  font-size: var(--ns-text-xs);
}

.ns-toc__link {
  color: var(--ns-muted-fg);
  text-decoration: none;
  display: block;
  padding: 2px 0 2px var(--ns-space-3);
  border-left: 2px solid transparent;
  line-height: var(--ns-leading-snug);
}

.ns-toc__link:hover {
  color: var(--ns-fg);
}

.ns-toc__link.is-active {
  color: var(--ns-primary);
  border-left-color: var(--ns-primary);
}

/* On mobile the TOC renders as a collapsible block above the article
   (the base .ns-toc rule hides at <1100px; override for the data-toc variant). */
@media (max-width: 1099px) {
  .ns-toc[data-toc]:not([hidden]) {
    display: block;
    position: static;
    margin: 0 0 var(--ns-space-4);
    padding: var(--ns-space-3) var(--ns-space-4);
    border: 1px solid var(--ns-border);
    border-radius: var(--ns-radius-md);
    background: var(--ns-surface);
  }
}

/* ─── Code-copy buttons (S03) ─────────────────────────────────────── */
.ns-pre--copyable {
  position: relative;
}

.ns-copy-btn {
  position: absolute;
  top: var(--ns-space-2);
  right: var(--ns-space-2);
  appearance: none;
  cursor: pointer;
  border: 1px solid var(--ns-border);
  border-radius: var(--ns-radius-sm);
  background: var(--ns-surface-raised);
  color: var(--ns-muted-fg);
  font-family: var(--ns-font-mono);
  font-size: 0.67rem;
  padding: 0.125rem var(--ns-space-2);
  opacity: 0;
  transition: opacity var(--ns-ease-normal), color var(--ns-ease-normal);
}

.ns-pre--copyable:hover .ns-copy-btn,
.ns-copy-btn:focus-visible {
  opacity: 1;
}

.ns-copy-btn:hover {
  color: var(--ns-fg);
  border-color: var(--ns-border-hover);
}

.ns-copy-btn.is-copied {
  color: var(--ns-success);
  border-color: var(--ns-success-border);
  opacity: 1;
}