/* SaydiVoice API docs — static, no-build styles. Tokens lifted from the studio
   (assets/styles.css) and frontend/data/saydi-brand-theme.ts so the docs read
   like the app they sit beside; component CSS replaces Astryx. */

:root {
  --color-bg: #fafafa;
  --color-surface: #ffffff;
  --color-background-muted: #f5f5f5;
  --color-border: #e5e7eb;
  --color-border-emph: #e5e7eb;
  --color-text: #111111;
  --color-text-secondary: #6b7280;
  --color-text-error: #dc2626;
  --color-primary: #fe655d;
  --color-primary-press: #ec4f47;
  --color-success: #16a34a;
  --color-warning: #b45309;
  --color-info: #2563eb;
  --color-blue: #2563eb;
  --color-green: #16a34a;
  --color-red: #dc2626;
  --color-orange: #ea580c;
  --color-purple: #7c3aed;
  --radius-element: 12px;
  --radius-container: 16px;
  --radius-card: 16px;
  --spacing-1: 4px;
  --spacing-2: 8px;
  --spacing-3: 12px;
  --spacing-4: 16px;
  --spacing-5: 24px;
  --spacing-6: 32px;
  --font: 'Plus Jakarta Sans', 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif;
  --font-mono: 'SF Mono', 'Monaco', 'Consolas', 'Liberation Mono', monospace;
  --docs-top: 56px;
  --docs-content: 1024px;
}

* { box-sizing: border-box; }
html { scroll-behavior: smooth; }
body {
  margin: 0;
  font-family: var(--font);
  color: var(--color-text);
  background: var(--color-bg);
  -webkit-font-smoothing: antialiased;
  text-rendering: optimizeLegibility;
}
#app { height: 100vh; height: 100dvh; }

a { color: var(--color-info); }
code, pre { font-family: var(--font-mono); }

.ov-visually-hidden {
  position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px;
  overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; border: 0;
}

/* --- shell — layout cloned from frontend/developers/assets/app.css (the
   developer console, itself the studio shell). Rules are cloned verbatim;
   docs-only panes and behaviour (the outline column, the 1024px reading
   measure, the 900px narrow breakpoint the shell JS matches) are adapted, and
   component styles (buttons, typography, nav items) stay the docs' own.
   Console rule → docs rule: `#app` → #app, `.ov-topnav*` → .docs-topnav*,
   `.layout` → .layout, `.app` + the outline column → .app, `.sidebar`/
   `.ov-sidenav` → .sidebar/.ov-sidenav, `.ov-main` → .ov-main, `.main` → .main. */
.layout {
  display: flex;
  height: 100vh;
  height: 100dvh;
  overflow: hidden;
  background: var(--color-bg);
}

.ov-skip {
  position: absolute; left: 12px; top: -48px; z-index: 80;
  background: var(--color-text); color: #fff; padding: 8px 14px; border-radius: 8px;
  text-decoration: none; transition: top .15s;
}
.ov-skip:focus { top: 12px; }

/* Top bar — cloned from the console's `.ov-topnav` block (`.ov-topnav`,
   `.ov-topnav-inner`, `.ov-topnav-actions`). The console's button tweak
   (`.ov-topnav-actions .ov-btn`) is component styling and stays out of scope. */
.docs-topnav {
  flex: none;
  display: flex; align-items: center; justify-content: space-between; gap: 10px;
  background: var(--color-bg);
  padding: 8px 22px 8px 8px;
}
.docs-topnav-inner {
  width: 100%;
  margin: 0 auto;
  display: flex; align-items: center; justify-content: space-between; gap: var(--spacing-3);
}
.docs-brand { font-size: 22px; font-weight: 900; color: var(--color-text); text-decoration: none; white-space: nowrap; }
.docs-topnav-actions { display: flex; align-items: center; gap: var(--spacing-2); }
.docs-topnav-actions .ov-segmented { background: var(--color-background-muted); }
@media (max-width: 560px) {
  .docs-topnav-inner { padding: 0 var(--spacing-4); gap: var(--spacing-2); }
}

/* Sidebar + side nav — cloned from the console's `.sidebar` / `.ov-sidenav`:
   the 280px transparent rail scrolls as a whole, and the sidenav's 52px top
   inset clears the top bar (the docs rail has no head block — the brand lives
   in the top bar). */
.sidebar {
  width: 280px;
  flex: none;
  background: transparent;
  display: flex; flex-direction: column;
  overflow-y: auto;
}
.ov-sidenav {
  width: 100%;
  padding: 52px 12px 8px;
  min-height: 100%;
  display: flex; flex-direction: column;
}
.ov-sidenav nav { display: flex; flex-direction: column; gap: var(--spacing-4); }
.docs-sidenav-section { padding: var(--spacing-4) 0; }
.docs-sidenav-label {
  font-size: 11px; text-transform: uppercase; letter-spacing: .06em;
  color: var(--color-text-secondary); padding: 0 var(--spacing-3) var(--spacing-2);
}
.docs-navitem {
  display: flex; align-items: center; gap: var(--spacing-3);
  padding: var(--spacing-2) var(--spacing-3); margin: 2px var(--spacing-2);
  border-radius: var(--radius-element); color: var(--color-text-secondary);
  text-decoration: none; font-size: 14px; font-weight: 500;
}
.docs-navitem:hover { background: var(--color-background-muted); color: var(--color-text); }
.docs-navitem.is-active { background: color-mix(in srgb, var(--color-primary) 12%, transparent); color: var(--color-primary); font-weight: 600; }

/* App column — cloned from the console's `.app` / `.ov-main` / `.main`: a
   column that stacks the top bar over the scrollable pane, with every route's
   content framed in the rounded `.main` card (rendered by app.js). */
.app {
  display: flex;
  flex-direction: column;
  height: 100%;
  flex: 1;
  min-width: 0;
}
.ov-main {
  display: flex;
  flex-direction: column;
  flex: 1;
  min-height: 0;
  overflow-y: auto;
  padding: 4px 16px 8px 8px;
}
/* Content card — cloned from the console's `.main`. */
.main {
  background: #FEFEFE;
  border: 1px solid #f2f2f2;
  border-radius: 24px;
  box-shadow: 0 2px 6px #0000000d;
  overflow: visible;
  min-height: 100%;
  padding: 16px 20px;
}
.main.has-outline {
  display: flex;
  align-items: flex-start;
  gap: var(--spacing-5);
  padding-bottom: var(--spacing-6);
}
.main.has-outline > .docs-content {
  flex: 1;
  min-width: 0;
}
.main .docs-content > * + * { margin-top: var(--spacing-5); }
.docs-outline-mount {
  flex: none;
  width: 260px;
  position: sticky;
  top: var(--spacing-5);
  align-self: flex-start;
  max-height: calc(100vh - var(--spacing-5) - var(--spacing-5));
  overflow-y: auto;
}
/* Docs-only reading measure inside the card. */
.docs-content { max-width: var(--docs-content); margin: 0 auto; overflow-wrap: anywhere; word-break: break-word; overflow-y: auto; max-height: 100%;}
.docs-content a:not(.ov-btn) { color: var(--color-text-secondary); }
.docs-h1 { font-size: 26px; font-weight: 800; letter-spacing: -.02em; margin: 0 0 var(--spacing-3); }
.docs-summary { font-size: 16px; margin: 0 0 var(--spacing-2); }
.docs-metarow { margin-bottom: var(--spacing-5); }
.docs-metarow code { background: var(--color-background-muted); padding: 2px 6px; border-radius: 6px; font-size: 13px; }
.docs-prevnext { display: flex; justify-content: space-between; gap: var(--spacing-3); margin-top: var(--spacing-5); }
.docs-prevnext > .ov-btn-primary { margin-left: auto; }
.doc-blocks > * + * { margin-top: var(--spacing-5); }
.doc-blocks > .ov-banner { margin-top: var(--spacing-5); }

/* --- outline (right column) ---------------------------------------------- */
.docs-outline { align-self: start; }
.docs-outline-title { font-size: 12px; font-weight: 700; text-transform: uppercase; letter-spacing: .05em; color: var(--color-text-secondary); margin-bottom: var(--spacing-2); }
.docs-outline-list { list-style: none; margin: 0; padding: 0; border-left: 1px solid var(--color-border); }
.docs-outline-item .docs-outline-link {
  display: block; padding: 4px 0 4px 12px; margin-left: -1px;
  border-left: 2px solid transparent; text-decoration: none;
  font-size: 13px; color: var(--color-text-secondary); line-height: 1.4;
}
.docs-outline-item.level-3 .docs-outline-link { padding-left: 24px; }
.docs-outline-link:hover { color: var(--color-text); }
.docs-outline-link.is-current { color: var(--color-primary); border-left-color: var(--color-primary); font-weight: 600; }

/* --- typography helpers ---------------------------------------------------- */
.ov-h1 { font-size: 28px; font-weight: 800; margin: 0; letter-spacing: -.01em; }
.ov-h2 { font-size: 22px; font-weight: 800; margin: 0; }
.ov-h3 { font-size: 18px; font-weight: 700; margin: 0 0 var(--spacing-2); }
.ov-text { margin: 0; overflow-wrap: anywhere; word-break: break-word; }
.ov-text-body { font-size: 15px; line-height: 1.6; }
.ov-text-secondary { color: var(--color-text-secondary); }
.ov-text-supporting { font-size: 13px; }
.ov-text-semibold { font-weight: 600; }
.ov-divider { border: 0; border-top: 1px solid var(--color-border); margin: 0; }

/* --- layout helpers ------------------------------------------------------- */
.ov-stack { display: flex; flex-direction: column; }
.ov-gap-1 { gap: var(--spacing-1); } .ov-gap-2 { gap: var(--spacing-2); }
.ov-gap-3 { gap: var(--spacing-3); } .ov-gap-4 { gap: var(--spacing-4); } .ov-gap-5 { gap: var(--spacing-5); }
.ov-row { display: flex; align-items: center; }
.ov-row-center { align-items: center; }
.ov-row-end { align-items: flex-end; }
.ov-wrap { flex-wrap: wrap; }
.ov-fill { flex: 1 1 auto; min-width: 0; }
.ov-icon-accent { display: inline-flex; color: var(--color-primary); }

/* --- card / banner / badge ------------------------------------------------ */
.ov-card { background: var(--color-surface); border: 1px solid var(--color-border); border-radius: var(--radius-card); padding: var(--spacing-5); min-width: 0; }
.ov-banner { display: flex; align-items: flex-start; gap: var(--spacing-3); padding: var(--spacing-3) var(--spacing-4); border-radius: var(--radius-element); border: 1px solid var(--color-border); background: var(--color-background-muted); margin: 0; }
.ov-banner-body { flex: 1; }
.ov-banner-title { font-weight: 700; font-size: 14px; }
.ov-banner-desc { font-size: 13px; color: var(--color-text-secondary); margin-top: 2px; overflow-wrap: anywhere; word-break: break-word; }
.ov-banner-error { border-color: color-mix(in srgb, var(--color-text-error) 30%, var(--color-border)); background: color-mix(in srgb, var(--color-text-error) 6%, transparent); }
.ov-banner-warning { border-color: color-mix(in srgb, var(--color-warning) 35%, var(--color-border)); background: color-mix(in srgb, var(--color-warning) 8%, transparent); }
.ov-banner-info { border-color: color-mix(in srgb, var(--color-info) 30%, var(--color-border)); background: color-mix(in srgb, var(--color-info) 6%, transparent); }
.ov-banner-action { margin-left: var(--spacing-3); }
.ov-badge { display: inline-flex; align-items: center; padding: 2px 8px; border-radius: 999px; font-size: 12px; font-weight: 600; }
.ov-badge-success { background: color-mix(in srgb, var(--color-success) 14%, transparent); color: var(--color-success); }
.ov-badge-neutral { background: var(--color-background-muted); color: var(--color-text-secondary); }
.ov-badge-warning { background: color-mix(in srgb, var(--color-warning) 16%, transparent); color: var(--color-warning); }
.ov-badge-error { background: color-mix(in srgb, var(--color-text-error) 14%, transparent); color: var(--color-text-error); }
.ov-badge-info, .ov-badge-blue { background: color-mix(in srgb, var(--color-blue) 14%, transparent); color: var(--color-blue); }
.ov-badge-green { background: color-mix(in srgb, var(--color-green) 14%, transparent); color: var(--color-green); }
.ov-badge-red { background: color-mix(in srgb, var(--color-red) 14%, transparent); color: var(--color-red); }
.ov-badge-orange { background: color-mix(in srgb, var(--color-orange) 16%, transparent); color: var(--color-orange); }
.ov-badge-purple { background: color-mix(in srgb, var(--color-purple) 14%, transparent); color: var(--color-purple); }

/* --- button / segmented ---------------------------------------------------- */
.ov-btn {
  display: inline-flex; align-items: center; gap: 6px; justify-content: center;
  font-family: var(--font); font-size: 14px; font-weight: 600;
  padding: 8px 14px; border-radius: var(--radius-element); border: 1px solid transparent;
  cursor: pointer; transition: background .12s, border-color .12s, opacity .12s; line-height: 1.2; text-decoration: none; color: var(--color-text); background: transparent; white-space: nowrap;
}
.ov-btn-ico { display: inline-flex; }
.ov-btn:disabled { opacity: .5; cursor: not-allowed; }
.ov-btn-icononly { padding: 8px; }
.ov-btn-icononly .ov-btn-label { display: none; }
.ov-btn-primary { background: var(--color-primary); color: #fff; }
.ov-btn-primary:hover:not(:disabled) { background: var(--color-primary-press); }
.ov-btn-secondary { background: var(--color-surface); color: var(--color-text); border-color: var(--color-border); }
.ov-btn-secondary:hover:not(:disabled) { background: var(--color-background-muted); }
.ov-btn-ghost { background: transparent; color: var(--color-text-secondary); }
.ov-btn-ghost:hover:not(:disabled) { background: var(--color-background-muted); color: var(--color-text); }
.ov-btn-destructive { background: transparent; color: var(--color-text-error); border-color: color-mix(in srgb, var(--color-text-error) 40%, var(--color-border)); }
.ov-btn-sm { padding: 6px 10px; font-size: 13px; }
.ov-btn-sm.ov-btn-icononly { padding: 6px; }

.ov-segmented { display: inline-flex; background: var(--color-background-muted); border-radius: var(--radius-element); padding: 2px; }
.ov-seg-item { border: 0; background: transparent; padding: 4px 12px; border-radius: 8px; font-family: var(--font); font-size: 13px; font-weight: 600; color: var(--color-text-secondary); cursor: pointer; }
.ov-seg-item.is-active { background: var(--color-surface); color: var(--color-text); box-shadow: 0 1px 2px rgba(0,0,0,.08); }

/* --- inputs / listbox ------------------------------------------------------ */
.ov-field { display: inline-flex; flex-direction: column; gap: 4px; }
.ov-field-label { font-size: 13px; font-weight: 600; color: var(--color-text); }
.ov-textarea {
  width: 100%; font-family: var(--font); font-size: 14px; color: var(--color-text);
  background: var(--color-surface); border: 1px solid var(--color-border); border-radius: var(--radius-element); padding: 9px 12px; line-height: 1.5; resize: vertical;
}
.ov-textarea:focus, .ov-select:focus { outline: 2px solid color-mix(in srgb, var(--color-primary) 40%, transparent); border-color: var(--color-primary); }

.ov-select {
  display: inline-flex; align-items: center; justify-content: space-between; gap: 8px;
  width: 100%; font-family: var(--font); font-size: 14px; color: var(--color-text);
  background: var(--color-surface); border: 1px solid var(--color-border); border-radius: var(--radius-element); padding: 8px 12px; cursor: pointer;
}
.ov-select-caret { display: inline-flex; color: var(--color-text-secondary); }
.ov-listbox {
  position: absolute; z-index: 30; margin-top: 4px; min-width: 180px; list-style: none;
  background: var(--color-surface); border: 1px solid var(--color-border); border-radius: var(--radius-element);
  box-shadow: 0 8px 28px rgba(0,0,0,.12); padding: 4px; max-height: 260px; overflow-y: auto;
}
.ov-listbox[hidden] { display: none; }
.ov-listbox [role="option"] { padding: 7px 10px; border-radius: 8px; font-size: 14px; cursor: pointer; }
.ov-listbox li + li { margin-top: var(--spacing-1); }
.ov-listbox [role="option"]:hover { background: var(--color-background-muted); }
.ov-listbox [role="option"][aria-selected="true"] { background: color-mix(in srgb, var(--color-primary) 12%, transparent); color: var(--color-primary); font-weight: 600; }

.ov-dropdown { position: relative; display: inline-flex; }
.ov-dropdown .ov-listbox { right: 0; top: calc(100% + 6px); min-width: 220px; margin-top: 0; }
.ov-listbox [role="menuitem"] { display: flex; align-items: center; gap: 8px; width: 100%; padding: 7px 10px; border: 0; background: transparent; border-radius: 8px; font-family: var(--font); font-size: 14px; color: var(--color-text); text-decoration: none; cursor: pointer; text-align: left; box-sizing: border-box; }
.ov-listbox [role="menuitem"]:hover { background: var(--color-background-muted); }

/* --- lists / steps / params ------------------------------------------------ */
.ov-list { margin: 0; padding-left: 20px; display: flex; flex-direction: column; gap: 6px; }
.ov-step { display: flex; gap: var(--spacing-3); align-items: flex-start; }
.ov-step-num { flex: 0 0 auto; width: 22px; height: 22px; border-radius: 999px; background: var(--color-background-muted); color: var(--color-text-secondary); font-size: 12px; font-weight: 700; display: inline-flex; align-items: center; justify-content: center; margin-top: 2px; }
.ov-step-title { font-weight: 600; }
.ov-param { padding: var(--spacing-3) 0; border-top: 1px solid var(--color-border); }
.ov-param:first-child { border-top: 0; padding-top: 0; }
.ov-param-head { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
.ov-param-type { font-size: 12px; color: var(--color-text-secondary); }
.ov-param-desc { margin-top: 4px; color: var(--color-text-secondary); font-size: 14px; }
.ov-code-inline { font-family: var(--font-mono); font-size: 13px; background: var(--color-background-muted); padding: 1px 6px; border-radius: 6px; }

/* --- endpoint card --------------------------------------------------------- */
.ov-endpoint { border-color: var(--color-border-emph); }
.ov-endpoint-head { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; }
.ov-endpoint-path { font-size: 15px; }

/* --- code blocks ----------------------------------------------------------- */
.ov-codeblock { position: relative; }
.ov-code-head { display: flex; align-items: center; justify-content: space-between; padding: 8px 12px; border: 1px solid var(--color-border); border-bottom: 0; border-radius: var(--radius-element) var(--radius-element) 0 0; background: var(--color-background-muted); }
.ov-code-title { font-size: 13px; font-weight: 600; }
.ov-code-lang { font-size: 11px; color: var(--color-text-secondary); text-transform: uppercase; }
.ov-code-wrap { position: relative; }
.ov-code { background: #1e1e24; color: #f5f5f7; padding: var(--spacing-4); border-radius: var(--radius-element); overflow-x: auto; margin: 0; font-size: 13px; line-height: 1.6; white-space: pre; }
.ov-code code { font-family: var(--font-mono); white-space: pre; }
.ov-code-lined { display: flex; background: #1e1e24; color: #f5f5f7; border-radius: var(--radius-element); overflow-x: auto; font-size: 13px; line-height: 1.6; }
.ov-code-head + .ov-code-wrap > .ov-code-lined { border-radius: 0 0 12px 12px; }
.ov-code-lined .ov-code { border-radius: 0; padding: var(--spacing-4) 0; min-width: 0; }
.ov-code-lined .ov-code-gutter { margin: 0; padding: var(--spacing-4) 0; border-radius: 0; color: #6b7280; text-align: right; background: transparent; user-select: none; }
.ov-code-lined .ov-code-gutter code { display: flex; flex-direction: column; }
.ov-code-lined .ov-code-gutter span { padding: 0 12px; }
.ov-code-lined .ov-code { padding-left: var(--spacing-4); }
.ov-code-copy { position: absolute; top: 8px; right: 8px; display: inline-flex; align-items: center; gap: 4px; padding: 4px 8px; background: rgba(255,255,255,.1); color: #f5f5f7; border: 1px solid rgba(255,255,255,.18); border-radius: 8px; font-size: 12px; cursor: pointer; }
.ov-code-copy:hover { background: rgba(255,255,255,.18); }
.ov-code-panels > .ov-code-panel { display: none; }
.ov-code-panels > .ov-code-panel.is-active { display: block; }

/* --- responsive documentation table --------------------------------------- */
.doc-grid { border: 1px solid var(--color-border); border-radius: var(--radius-element); overflow: hidden; }
.doc-grid-row { display: grid; grid-template-columns: repeat(var(--doc-cols, 2), minmax(0, 1fr)); }
.doc-grid-row + .doc-grid-row { border-top: 1px solid var(--color-border); }
.doc-grid-cell { padding: var(--spacing-2) var(--spacing-3); overflow-wrap: anywhere; }
.doc-grid-head { background: var(--color-background-muted); font-weight: 600; }
.doc-grid [role="cell"] a { color: var(--color-info); }
[role="table"] { --doc-cols: 2; }

/* --- try it ---------------------------------------------------------------- */
.ov-tryit-card { background: var(--color-surface); }
.ov-tryit-sub { font-size: 14px; }
.ov-tryit-voice { min-width: 220px; }
.ov-tryit-error:empty, .ov-tryit-result:empty { display: none; }
.ov-tryit-note { font-size: 13px; }
.ov-tryit-result audio { display: block; }

/* --- AI card --------------------------------------------------------------- */
.ov-ai-card .ov-ai-hint a { color: var(--color-text-secondary); }

/* --- deep-link anchors ----------------------------------------------------- */
[data-doc-anchor] { scroll-margin-top: calc(var(--docs-top) + 16px); }

/* --- responsive: stack the shell, drop the outline column. Cloned from the
   console's `@media (max-width: 767.5px)` block, but kept at the docs' 900px
   narrow breakpoint (the shell JS flips to narrow mode at `max-width: 900px`).
   Docs-only: the nav wraps into a strip (labels hidden) and the top bar sticks
   while the page scrolls. */
@media (max-width: 900px) {
  .layout { flex-direction: column; height: auto; min-height: 100vh; min-height: 100dvh; overflow: visible; }
  .app { min-height: 0; height: auto; }
  .sidebar { width: 100%; height: auto; border-right: 0; border-bottom: 1px solid var(--color-border); }
  .docs-topnav { position: sticky; top: 0; z-index: 40; padding: 8px 16px; }
  .ov-sidenav { padding: 8px 12px; }
  .ov-main { padding: 8px 12px; }
  .main { border-radius: 18px; }
  .ov-sidenav nav { flex-direction: row; flex-wrap: wrap; gap: var(--spacing-2); }
  .docs-sidenav-section { flex-direction: row; flex-wrap: wrap; gap: 2px; }
  .docs-sidenav-label { display: none; }
  .docs-outline-mount { display: none; }
  .docs-content { max-width: none; }
}

/* Coarse-pointer touch targets: grow hit area on phones/tablets only, so
   desktop density is unchanged. */
@media (pointer: coarse) {
  .ov-btn, .ov-seg-item, [role="combobox"], .ov-navitem, [role="option"], .ov-listbox [role="option"], .ov-listbox [role="menuitem"] { min-height: 44px; }
  .ov-seg-item, .ov-navitem { min-width: 44px; }
  .docs-navitem { display: flex; align-items: center; }
}