/* Public Sans is the brand sans (design/tokens.css). CJK fallbacks match
   what perxona.ai loads, so zh/ja pages stop depending on OS fonts. */
@import url('https://fonts.googleapis.com/css2?family=Public+Sans:wght@400;500;600;700&family=Noto+Sans+TC:wght@400;500;700&family=IBM+Plex+Sans+JP:wght@400;500;700&family=IBM+Plex+Mono:wght@400;500&display=swap');

/* ------------------------------------------------------------------------
   Design tokens.

   PRIMITIVES below are copied verbatim from design/tokens.css (provided by
   the frontend team, exported from Figma; Minimal UI grey channel
   145 158 171). Do not tweak these values here — update design/tokens.css
   first, then mirror it.

   SEMANTIC tokens map this site's needs onto those primitives. The callout
   scale (warning / success / ai / developer) has no counterpart in the
   design system yet and remains INTERIM pending design.
   ------------------------------------------------------------------------ */
:root {
  /* -- primitives (design/tokens.css) -- */
  --color-common-white: #ffffff;
  --color-common-black: #000000;
  --color-primary-light: #6cadff;
  --color-primary-main: #0b65ff;
  --color-info-dark: #006c9c;
  --color-grey-200: #f4f6f8;
  --color-grey-300: #dfe3e8;
  --color-grey-500: #919eab;
  --color-grey-600: #637381;
  --color-grey-800: #1c252e;
  --color-grey-900: #141a21;
  --color-grey-alpha-8: rgba(145, 158, 171, 0.08);
  --color-grey-alpha-12: rgba(145, 158, 171, 0.12);
  --color-grey-alpha-20: rgba(145, 158, 171, 0.2);
  --shadow-color-24: rgba(0, 0, 0, 0.24);
  --shadow-color-10: rgba(0, 0, 0, 0.1);
  --shadow-color-07: rgba(0, 0, 0, 0.07);
  --font-family-sans: 'Public Sans', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
  --shadow-card: 0 0 2px 0 var(--shadow-color-24), 0 12px 24px -4px var(--shadow-color-07);
  --shadow-dropdown: 0 0 2px 0 var(--shadow-color-24), 0 20px 40px -4px var(--shadow-color-10);

  /* -- semantic mapping -- */
  --brand: var(--color-primary-main);
  --brand-rgb: 11 101 255;
  --brand-2: var(--color-primary-light);
  --brand-ink: color-mix(in srgb, var(--color-primary-main) 78%, var(--color-grey-900));
  --brand-soft: rgb(var(--brand-rgb) / 0.08);

  --bg: var(--color-common-white);
  --paper: var(--color-common-white);
  --surface: var(--color-grey-200);
  --surface-2: var(--color-grey-300);
  --bg-accent: var(--color-grey-200);
  --paper-strong: var(--color-grey-200);
  --ink: var(--color-grey-800);
  --muted: var(--color-grey-600);
  --subtle: var(--color-grey-500);
  --line: var(--color-grey-alpha-20);
  --line-soft: var(--color-grey-alpha-12);

  /* callout scale (INTERIM, pending design tokens) */
  --action: var(--brand);
  --action-soft: rgb(var(--brand-rgb) / 0.06);
  --warning: #b45309;
  --warning-soft: #fff8ed;
  --success: #047857;
  --success-soft: #edfbf4;
  --ai: #6d28d9;
  --ai-soft: #f6f3ff;
  --developer: var(--color-grey-600);
  --developer-soft: var(--color-grey-200);

  /* code */
  --code-bg: var(--color-grey-200);
  --code-ink: var(--color-grey-800);

  --shadow: var(--shadow-card);
  --radius-lg: 12px;
  --radius-md: 12px;
  --radius-sm: 8px;
  --content-width: 78rem;
}

* {
  box-sizing: border-box;
}

html {
  scroll-behavior: smooth;
}

body {
  margin: 0;
  font-family: var(--font-family-sans);
  color: var(--ink);
  background: var(--bg);
  line-height: 1.7;
  -webkit-font-smoothing: antialiased;
}

/* Per-language CJK stack, keyed off the <html lang> each page carries. */
html[lang='zh-TW'] body {
  font-family: 'Public Sans', 'Noto Sans TC', -apple-system, sans-serif;
}

html[lang='ja'] body {
  font-family: 'Public Sans', 'IBM Plex Sans JP', -apple-system, sans-serif;
}

a {
  color: var(--action);
  text-decoration-thickness: 0.08em;
  text-underline-offset: 0.18em;
}

a:hover {
  color: var(--brand-ink);
}

code,
pre,
kbd {
  font-family: 'IBM Plex Mono', monospace;
}

.site-shell {
  width: min(calc(100% - 2rem), var(--content-width));
  margin: 0 auto;
  padding: 1.1rem 0 3rem;
}

.topbar {
  position: sticky;
  top: 0;
  z-index: 30;
  backdrop-filter: blur(12px);
  background: rgb(255 255 255 / 0.85);
  border-bottom: 1px solid var(--line);
}

.topbar-inner {
  width: min(calc(100% - 2rem), var(--content-width));
  margin: 0 auto;
  padding: 0.75rem 0 0.9rem;
  display: flex;
  flex-direction: column;
  gap: 0.75rem;
}

.brand-row {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 1rem;
  flex-wrap: wrap;
}

.brand {
  display: inline-flex;
  align-items: center;
  gap: 0.75rem;
  color: var(--ink);
  text-decoration: none;
  font-weight: 700;
  letter-spacing: 0.01em;
}

.brand-mark {
  width: 2.2rem;
  height: 2.2rem;
  display: inline-grid;
  place-items: center;
  border-radius: 0.9rem;
  color: white;
  background: linear-gradient(135deg, var(--brand), var(--brand-2));
  box-shadow: 0 10px 22px rgb(var(--brand-rgb) / 0.2);
  font-weight: 700;
}

.brand-copy small {
  display: block;
  color: var(--muted);
  font-weight: 500;
  letter-spacing: 0.03em;
  text-transform: uppercase;
  font-size: 0.73rem;
}

.brand-copy span {
  display: block;
  font-size: 1rem;
}

.guide-nav {
  display: flex;
  gap: 0.55rem;
  overflow-x: auto;
  padding-bottom: 0.2rem;
  scrollbar-width: thin;
}

.guide-nav a {
  white-space: nowrap;
  text-decoration: none;
  padding: 0.62rem 0.92rem;
  border-radius: 999px;
  border: 1px solid var(--line);
  background: var(--paper);
  color: var(--ink);
  font-size: 0.92rem;
  font-weight: 600;
  transition: transform 140ms ease, background 140ms ease, border-color 140ms ease;
}

.guide-nav a:hover {
  transform: translateY(-1px);
  background: var(--paper);
  border-color: rgb(var(--brand-rgb) / 0.24);
}

.guide-nav a.is-active {
  background: rgb(var(--brand-rgb) / 0.1);
  border-color: rgb(var(--brand-rgb) / 0.26);
  color: var(--brand-ink);
}

.page-grid {
  display: grid;
  grid-template-columns: minmax(0, 1fr) 18rem;
  gap: 1.5rem;
  align-items: start;
  margin-top: 1.6rem;
}

.page {
  min-width: 0;
}

.hero {
  position: relative;
  overflow: hidden;
  padding: 2rem;
  border: 1px solid var(--line);
  border-radius: var(--radius-lg);
  background:
    radial-gradient(circle at top right, rgb(var(--brand-rgb) / 0.08), transparent 30%),
    radial-gradient(circle at left center, rgb(var(--brand-rgb) / 0.1), transparent 26%),
    var(--paper);
  box-shadow: var(--shadow);
}

.hero::after {
  content: '';
  position: absolute;
  inset: auto -2rem -2rem auto;
  width: 12rem;
  height: 12rem;
  border-radius: 50%;
  background: rgb(var(--brand-rgb) / 0.05);
  filter: blur(10px);
}

.eyebrow {
  display: inline-flex;
  align-items: center;
  gap: 0.5rem;
  padding: 0.38rem 0.78rem;
  border-radius: 999px;
  background: rgb(var(--brand-rgb) / 0.08);
  color: var(--brand-ink);
  font-size: 0.82rem;
  font-weight: 700;
  letter-spacing: 0.05em;
  text-transform: uppercase;
}

.hero h1 {
  margin: 1rem 0 0.7rem;
  font-size: clamp(2rem, 4vw, 3.3rem);
  line-height: 1.1;
  letter-spacing: -0.01em;
}

.hero .subtitle {
  margin: 0 0 1.2rem;
  font-size: clamp(1.05rem, 1.8vw, 1.35rem);
  color: var(--muted);
  max-width: 48rem;
}

.hero-meta {
  display: flex;
  gap: 0.75rem;
  flex-wrap: wrap;
  margin-top: 1rem;
}

.hero-chip {
  display: inline-flex;
  align-items: center;
  gap: 0.45rem;
  border-radius: 999px;
  background: var(--paper);
  border: 1px solid var(--line);
  padding: 0.48rem 0.75rem;
  font-size: 0.9rem;
  color: var(--muted);
}

.reading-legend {
  display: grid;
  grid-template-columns: repeat(4, minmax(0, 1fr));
  gap: 0.75rem;
  margin-top: 1.2rem;
}

.legend-card {
  padding: 0.85rem 0.95rem;
  border-radius: var(--radius-md);
  border: 1px solid var(--line);
  background: var(--paper);
}

.legend-card strong {
  display: block;
  margin-bottom: 0.2rem;
  font-size: 0.94rem;
}

.legend-card span {
  display: block;
  color: var(--muted);
  font-size: 0.87rem;
}

.legend-card.action strong { color: var(--action); }
.legend-card.warning strong { color: var(--warning); }
.legend-card.success strong { color: var(--success); }
.legend-card.ai strong { color: var(--ai); }

.content-card,
.toc-card,
.index-card,
.index-hero {
  border-radius: var(--radius-lg);
  border: 1px solid var(--line);
  background: var(--paper);
  box-shadow: var(--shadow);
}

.content-card {
  padding: 2rem;
  margin-top: 1.25rem;
}

.content-card h2,
.content-card h3,
.content-card h4 {
  scroll-margin-top: 8rem;
  letter-spacing: -0.01em;
}

.content-card h2 {
  margin-top: 2.6rem;
  margin-bottom: 0.8rem;
  font-size: clamp(1.55rem, 2.4vw, 2rem);
  padding-bottom: 0.45rem;
  border-bottom: 2px solid rgb(var(--brand-rgb) / 0.1);
}

.content-card h3 {
  margin-top: 2rem;
  margin-bottom: 0.7rem;
  font-size: clamp(1.22rem, 2vw, 1.45rem);
  color: var(--ink);
}

.content-card h4 {
  margin-top: 1.6rem;
  margin-bottom: 0.45rem;
  font-size: 1.05rem;
  color: var(--ink);
}

.content-card p,
.content-card li,
.content-card td,
.content-card th {
  font-size: 1.02rem;
}

.content-card ul,
.content-card ol {
  padding-left: 1.4rem;
}

.content-card li + li {
  margin-top: 0.42rem;
}

.content-card hr {
  border: 0;
  height: 1px;
  margin: 2rem 0;
  background: linear-gradient(90deg, transparent, rgb(var(--brand-rgb) / 0.28), transparent);
}

.content-card code {
  padding: 0.14rem 0.34rem;
  border-radius: 0.45rem;
  background: var(--bg-accent);
  color: var(--code-ink);
  font-size: 0.93em;
}

.content-card pre {
  overflow-x: auto;
  margin: 1rem 0 1.4rem;
  padding: 1rem 1.1rem;
  border-radius: var(--radius-md);
  background: var(--code-bg);
  border: 1px solid var(--line);
}

.content-card pre code {
  background: transparent;
  padding: 0;
  color: var(--code-ink);
}

.callout {
  margin: 1.1rem 0 1.3rem;
  padding: 1rem 1.1rem 1rem 1.2rem;
  border-radius: var(--radius-md);
  border-left: 6px solid var(--brand);
  background: var(--brand-soft);
}

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

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

.callout.warning {
  border-left-color: var(--warning);
  background: var(--warning-soft);
}

.callout.success {
  border-left-color: var(--success);
  background: var(--success-soft);
}

.callout.action {
  border-left-color: var(--action);
  background: var(--action-soft);
}

.callout.ai {
  border-left-color: var(--ai);
  background: var(--ai-soft);
}

.callout.developer {
  border-left-color: var(--developer);
  background: var(--developer-soft);
}

.table-wrap {
  overflow-x: auto;
  margin: 1rem 0 1.35rem;
  padding-bottom: 0.2rem;
}

table {
  width: 100%;
  border-collapse: collapse;
  min-width: 34rem;
  border-radius: 1rem;
  overflow: hidden;
  background: white;
  border: 1px solid var(--line);
}

th,
td {
  text-align: left;
  vertical-align: top;
  padding: 0.85rem 0.9rem;
  border-bottom: 1px solid var(--line-soft);
}

th {
  background: var(--surface-2);
  color: var(--ink);
  font-weight: 700;
}

tr:nth-child(even) td {
  background: var(--surface);
}

.toc-card {
  position: sticky;
  top: 7.6rem;
  padding: 1.2rem 1rem;
}

.toc-card h2 {
  margin: 0 0 0.85rem;
  font-size: 1rem;
  letter-spacing: 0.02em;
  text-transform: uppercase;
  color: var(--muted);
}

.toc-card .toc {
  font-size: 0.95rem;
}

.toc-card ul {
  list-style: none;
  padding-left: 0;
  margin: 0;
}

.toc-card li + li {
  margin-top: 0.45rem;
}

.toc-card ul ul {
  margin-top: 0.4rem;
  padding-left: 0.9rem;
  border-left: 1px solid var(--line);
}

.toc-card a {
  text-decoration: none;
  color: var(--muted);
}

.toc-card a:hover {
  color: var(--brand);
}

.footer-note {
  margin-top: 1rem;
  color: var(--muted);
  font-size: 0.92rem;
  text-align: center;
}

.mermaid {
  margin: 1rem 0 1.35rem;
  padding: 1rem;
  border-radius: var(--radius-md);
  background: var(--paper);
  border: 1px solid var(--line);
  overflow-x: auto;
}

.index-layout {
  display: grid;
  gap: 1.3rem;
  margin-top: 1.6rem;
}

.index-hero {
  padding: 2rem;
  background:
    radial-gradient(circle at top right, rgb(var(--brand-rgb) / 0.1), transparent 28%),
    radial-gradient(circle at bottom left, rgb(var(--brand-rgb) / 0.04), transparent 26%),
    linear-gradient(150deg, var(--paper), var(--surface));
}

.index-hero h1 {
  margin: 0 0 0.7rem;
  font-size: clamp(2rem, 4vw, 3.1rem);
  line-height: 1.08;
  letter-spacing: -0.01em;
}

.index-hero p {
  max-width: 48rem;
  font-size: 1.06rem;
  color: var(--muted);
  margin: 0;
}

.index-group {
  display: grid;
  gap: 1rem;
}

.index-group h2 {
  margin: 0;
  font-size: 1.25rem;
  color: var(--ink);
}

.index-group-head {
  display: grid;
  gap: 0.3rem;
}

.index-group-head p {
  margin: 0;
  color: var(--muted);
  font-size: 0.97rem;
  max-width: 46rem;
}

/* ---- journey map: the Start -> Guide -> Resources path ---- */
.journey {
  display: grid;
  grid-template-columns: repeat(3, minmax(0, 1fr));
  gap: 0.9rem;
  align-items: stretch;
  list-style: none;
  margin: 0;
  padding: 0;
}

.journey-stage {
  position: relative;
  padding: 1.1rem 1.15rem;
  border-radius: var(--radius-lg);
  border: 1px solid var(--line);
  background: var(--paper);
  box-shadow: var(--shadow);
}

/* Connector chevron between stages. translate(-50%, -50%) puts the
   element's centre exactly at (left, top), i.e. centred in the 0.9rem
   column gap and vertically centred on the (equal-height) cards. The glyph itself is the
   box's top+right borders, whose strokes sit toward that corner — the
   trailing local translate(-25%, 25%) pulls the visible chevron back onto
   the box centre (in pre-rotation axes, so it also holds for the 135°
   stacked variant below). */
.journey-stage + .journey-stage::before {
  content: '';
  position: absolute;
  left: -0.45rem;
  top: 50%;
  width: 0.55rem;
  height: 0.55rem;
  border-top: 2px solid rgb(var(--brand-rgb) / 0.4);
  border-right: 2px solid rgb(var(--brand-rgb) / 0.4);
  transform: translate(-50%, -50%) rotate(45deg) translate(-25%, 25%);
}

.journey-stage .stage-label {
  display: inline-flex;
  align-items: center;
  gap: 0.4rem;
  padding: 0.28rem 0.6rem;
  border-radius: 999px;
  font-size: 0.74rem;
  font-weight: 700;
  letter-spacing: 0.05em;
  text-transform: uppercase;
  background: rgb(var(--brand-rgb) / 0.08);
  color: var(--brand-ink);
}

.journey-stage[data-tier='guide'] .stage-label {
  background: rgb(var(--brand-rgb) / 0.08);
  color: var(--brand-ink);
}

.journey-stage[data-tier='resources'] .stage-label {
  background: var(--ai-soft);
  color: var(--ai);
}

.journey-stage h3 {
  margin: 0.6rem 0 0.3rem;
  font-size: 1.05rem;
  line-height: 1.3;
}

.journey-stage > p {
  margin: 0 0 0.75rem;
  color: var(--muted);
  font-size: 0.9rem;
}

.journey-stops {
  list-style: none;
  margin: 0;
  padding: 0;
  display: grid;
  gap: 0.32rem;
}

.journey-stops a {
  display: flex;
  align-items: baseline;
  gap: 0.5rem;
  text-decoration: none;
  color: var(--ink);
  font-size: 0.92rem;
  padding: 0.24rem 0.35rem;
  border-radius: 0.55rem;
}

.journey-stops a:hover {
  background: rgb(var(--brand-rgb) / 0.06);
  color: var(--brand);
}

.journey-stops .stop-num {
  flex: none;
  min-width: 1.4rem;
  font-family: 'IBM Plex Mono', monospace;
  font-size: 0.78rem;
  color: var(--muted);
}

.index-card .step-chip {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  min-width: 1.7rem;
  height: 1.7rem;
  padding: 0 0.4rem;
  border-radius: 999px;
  background: rgb(var(--brand-rgb) / 0.08);
  color: var(--brand-ink);
  font-family: 'IBM Plex Mono', monospace;
  font-size: 0.8rem;
  font-weight: 600;
}

.index-card .card-head {
  display: flex;
  align-items: center;
  gap: 0.55rem;
  flex-wrap: wrap;
}

/* ---- language switcher (multilingual manuals) ---- */
.lang-switch {
  display: flex;
  align-items: center;
  gap: 0.35rem;
  flex-wrap: wrap;
}

.lang-switch .lang-globe {
  font-size: 1rem;
  opacity: 0.65;
  margin-right: 0.05rem;
}

.lang-switch a {
  text-decoration: none;
  padding: 0.32rem 0.72rem;
  border-radius: 999px;
  border: 1px solid var(--line);
  background: var(--paper);
  color: var(--muted);
  font-size: 0.85rem;
  font-weight: 600;
  line-height: 1.2;
}

.lang-switch a:hover {
  background: var(--paper);
  border-color: rgb(var(--brand-rgb) / 0.26);
  color: var(--ink);
}

.lang-switch a.is-active {
  background: rgb(var(--brand-rgb) / 0.1);
  border-color: rgb(var(--brand-rgb) / 0.28);
  color: var(--brand-ink);
}

.index-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(17rem, 1fr));
  gap: 1rem;
}

.index-card {
  padding: 1.25rem;
  display: flex;
  flex-direction: column;
  gap: 0.8rem;
  text-decoration: none;
  color: var(--ink);
  transition: transform 150ms ease, border-color 150ms ease;
}

.index-card:hover {
  transform: translateY(-2px);
  border-color: rgb(var(--brand-rgb) / 0.26);
}

.index-card .kicker {
  display: inline-flex;
  align-items: center;
  align-self: flex-start;
  padding: 0.34rem 0.62rem;
  border-radius: 999px;
  background: rgb(var(--brand-rgb) / 0.08);
  color: var(--brand-ink);
  font-size: 0.78rem;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  font-weight: 700;
}

.index-card h3 {
  margin: 0;
  font-size: 1.25rem;
  line-height: 1.24;
}

.index-card p {
  margin: 0;
  color: var(--muted);
  font-size: 0.98rem;
}

.index-card .audience {
  margin-top: auto;
  color: var(--muted);
  font-size: 0.88rem;
  font-weight: 600;
}

@media (max-width: 70rem) {
  .page-grid {
    grid-template-columns: 1fr;
  }

  .toc-card {
    position: static;
    order: -1;
  }
}

@media (max-width: 52rem) {
  .reading-legend {
    grid-template-columns: repeat(2, minmax(0, 1fr));
  }

  .journey {
    grid-template-columns: 1fr;
  }

  /* stacked: centre in the row gap and point down instead of right */
  .journey-stage + .journey-stage::before {
    left: 50%;
    top: -0.45rem;
    transform: translate(-50%, -50%) rotate(135deg) translate(-25%, 25%);
  }

  .hero,
  .content-card,
  .index-hero {
    padding: 1.3rem;
  }
}

@media (max-width: 36rem) {
  .site-shell {
    width: min(calc(100% - 1rem), var(--content-width));
  }

  .topbar-inner {
    width: min(calc(100% - 1rem), var(--content-width));
  }

  .reading-legend {
    grid-template-columns: 1fr;
  }

  .guide-nav a {
    font-size: 0.88rem;
  }

  table {
    min-width: 28rem;
  }
}
