/* 文件站樣式。由 scripts/build_docs_site.py 複製到 sfapp/static/docs/assets/style.css。
   色彩、字型與字級尺度依設計規格；深淺兩套 token，支援系統偏好與手動切換。 */

:root {
  --bg: #FAFBFC;
  --surface: #FFFFFF;
  --surface-2: #F2F5F7;
  --ink: #14181C;
  --ink-2: #4B5563;
  --ink-3: #6B7A88;
  --rule: #E3E7EB;
  --accent: #0B6E6E;
  --accent-ink: #0A5C5C;
  --accent-soft: #DFEFEE;
  --get: #0B6E6E;
  --post: #2F6FDE;
  --patch: #B26B00;
  --delete: #B3261E;
  --ok: #1F6B3A;
  --warn: #B26B00;
  --bad: #B3261E;
  --code-bg: #0E1418;
  --code-surface: #16202A;
  --code-ink: #E6EDF3;
  --code-rule: #24313D;
  --code-str: #9ECE6A;
  --code-key: #7DCFFF;
  --code-com: #6B7A88;
  --shadow: 0 1px 2px rgba(20, 24, 28, .06), 0 8px 24px rgba(20, 24, 28, .05);
  --sans: "Noto Sans TC", -apple-system, "PingFang TC", "Microsoft JhengHei", sans-serif;
  --mono: "JetBrains Mono", "SF Mono", Menlo, monospace;
  --topbar-h: 56px;
}

@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) {
    --bg: #0F1316;
    --surface: #151A1E;
    --surface-2: #1B2227;
    --ink: #E6EDF3;
    --ink-2: #A7B3BD;
    --ink-3: #7E8B95;
    --rule: #242C33;
    --accent: #4FBFB4;
    --accent-ink: #7FD6CD;
    --accent-soft: #10312F;
    --get: #4FBFB4;
    --post: #7FA8F0;
    --patch: #E0A34A;
    --delete: #F08B85;
    --ok: #6FC58A;
    --warn: #E0A34A;
    --bad: #F08B85;
    --code-bg: #0B1013;
    --code-surface: #121A21;
    --code-rule: #1F2A33;
    --shadow: 0 1px 2px rgba(0, 0, 0, .4), 0 8px 24px rgba(0, 0, 0, .3);
  }
}

:root[data-theme="dark"] {
  --bg: #0F1316;
  --surface: #151A1E;
  --surface-2: #1B2227;
  --ink: #E6EDF3;
  --ink-2: #A7B3BD;
  --ink-3: #7E8B95;
  --rule: #242C33;
  --accent: #4FBFB4;
  --accent-ink: #7FD6CD;
  --accent-soft: #10312F;
  --get: #4FBFB4;
  --post: #7FA8F0;
  --patch: #E0A34A;
  --delete: #F08B85;
  --ok: #6FC58A;
  --warn: #E0A34A;
  --bad: #F08B85;
  --code-bg: #0B1013;
  --code-surface: #121A21;
  --code-rule: #1F2A33;
  --shadow: 0 1px 2px rgba(0, 0, 0, .4), 0 8px 24px rgba(0, 0, 0, .3);
}

* { box-sizing: border-box; }

html { scroll-behavior: smooth; scroll-padding-top: calc(var(--topbar-h) + 16px); }

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

a { color: var(--accent-ink); text-decoration-thickness: 1px; text-underline-offset: 3px; }

a:focus-visible,
button:focus-visible,
input:focus-visible,
summary:focus-visible {
  outline: 2px solid var(--accent);
  outline-offset: 2px;
  border-radius: 4px;
}

.skip-link {
  position: absolute;
  left: -9999px;
  top: 8px;
  background: var(--surface);
  color: var(--ink);
  padding: 8px 14px;
  border: 1px solid var(--rule);
  border-radius: 6px;
  z-index: 60;
}

.skip-link:focus { left: 16px; }

/* 頂列 */

.topbar {
  position: sticky;
  top: 0;
  z-index: 40;
  height: var(--topbar-h);
  display: flex;
  align-items: center;
  gap: 16px;
  padding: 0 20px;
  background: var(--surface);
  border-bottom: 1px solid var(--rule);
}

.brand {
  display: flex;
  align-items: baseline;
  gap: 8px;
  font-weight: 600;
  font-size: 16px;
  text-decoration: none;
  color: var(--ink);
  white-space: nowrap;
}

.brand .brand-sub {
  font-size: 13px;
  font-weight: 400;
  color: var(--ink-3);
}

.search-wrap { flex: 1; max-width: 460px; margin-left: auto; position: relative; }

.search-wrap input {
  width: 100%;
  height: 34px;
  padding: 0 12px;
  font: 14px var(--sans);
  color: var(--ink);
  background: var(--surface-2);
  border: 1px solid var(--rule);
  border-radius: 8px;
}

.search-wrap input::placeholder { color: var(--ink-3); }

.search-count { font-size: 13px; color: var(--ink-3); white-space: nowrap; }

.icon-btn {
  height: 34px;
  min-width: 34px;
  padding: 0 10px;
  font: 13px var(--sans);
  color: var(--ink-2);
  background: var(--surface-2);
  border: 1px solid var(--rule);
  border-radius: 8px;
  cursor: pointer;
}

.icon-btn:hover { color: var(--ink); }

.menu-btn { display: none; }

/* 版面：桌機三欄（導覽＋內容＋程式碼） */

.layout {
  display: grid;
  grid-template-columns: 260px minmax(0, 1fr);
  align-items: start;
  max-width: 1560px;
  margin: 0 auto;
}

.sidebar {
  position: sticky;
  top: var(--topbar-h);
  height: calc(100vh - var(--topbar-h));
  overflow-y: auto;
  padding: 24px 12px 64px 20px;
  border-right: 1px solid var(--rule);
  font-size: 14px;
  line-height: 1.5;
}

.sidebar ul { list-style: none; margin: 0; padding: 0; }

.sidebar .nav-root > li { margin: 0 0 18px; }

.sidebar a {
  display: block;
  padding: 3px 8px;
  color: var(--ink-2);
  text-decoration: none;
  border-radius: 6px;
}

.sidebar a:hover { color: var(--ink); background: var(--surface-2); }

.sidebar summary.nav-l1 {
  cursor: pointer;
  padding: 3px 8px;
  font-weight: 600;
  font-size: 13px;
  letter-spacing: .06em;
  color: var(--ink-3);
  text-transform: uppercase;
  border-radius: 6px;
}

.sidebar summary.nav-l1:hover { color: var(--ink); background: var(--surface-2); }

.sidebar .nav-sub { margin: 4px 0 0; padding-left: 8px; border-left: 1px solid var(--rule); }

.sidebar .nav-sub li { margin: 1px 0; }

.sidebar .nav-inner { margin: 2px 0 8px; padding-left: 10px; border-left: 1px solid var(--rule); }

.sidebar a.nav-l3 { font-size: 13px; color: var(--ink-3); }

.sidebar a.active,
.sidebar a[aria-current] { color: var(--accent-ink); background: var(--accent-soft); font-weight: 600; }

.sidebar a.nav-ep { display: flex; align-items: center; gap: 8px; font-family: var(--mono); font-size: 13px; }

/* 頂列搜尋結果 */

.search-results {
  position: absolute;
  top: calc(100% + 6px);
  left: 0;
  right: 0;
  z-index: 55;
  max-height: 70vh;
  overflow-y: auto;
  padding: 6px;
  background: var(--surface);
  border: 1px solid var(--rule);
  border-radius: 10px;
  box-shadow: var(--shadow);
}

.search-hit {
  display: grid;
  grid-template-columns: minmax(0, auto) minmax(0, 1fr);
  align-items: baseline;
  gap: 4px 10px;
  padding: 7px 10px;
  color: var(--ink);
  text-decoration: none;
  border-radius: 8px;
}

.search-hit:hover,
.search-hit.is-active { background: var(--accent-soft); }

.hit-page { font-size: 13px; color: var(--ink-3); }

.hit-section { font-size: 14px; font-weight: 500; }

.hit-meta {
  grid-column: 2;
  font-family: var(--mono);
  font-size: 13px;
  color: var(--ink-3);
}

.search-empty { margin: 0; padding: 10px; font-size: 13px; color: var(--ink-3); }

/* 內容 */

main { min-width: 0; padding: 8px 28px 120px; }

article.page { padding-top: 28px; }

h1.page-title {
  font-size: 34px;
  line-height: 1.25;
  font-weight: 600;
  margin: 24px 0 8px;
  text-wrap: balance;
}

h2.section-title {
  font-size: 26px;
  line-height: 1.3;
  font-weight: 600;
  margin: 48px 0 12px;
  text-wrap: balance;
}

.prose h4 { font-size: 14px; font-weight: 600; color: var(--ink-2); margin: 24px 0 6px; }

.prose p, .prose li { max-width: 72ch; }

.prose ul, .prose ol { padding-left: 1.4em; }

.prose li { margin: 4px 0; }

.prose blockquote {
  margin: 16px 0;
  padding: 10px 16px;
  border-left: 3px solid var(--accent);
  background: var(--accent-soft);
  border-radius: 0 8px 8px 0;
}

/* 端點：中欄內容 ＋ 右欄 sticky 程式碼 */

.endpoint {
  display: grid;
  grid-template-columns: minmax(0, 72ch) minmax(340px, 1fr);
  gap: 40px;
  align-items: start;
  margin: 40px 0 0;
  padding-top: 32px;
  border-top: 1px solid var(--rule);
}

.endpoint-body { min-width: 0; }

h3.endpoint-title {
  display: flex;
  align-items: center;
  flex-wrap: wrap;
  gap: 10px;
  font-size: 20px;
  font-weight: 600;
  margin: 0 0 10px;
  text-wrap: balance;
}

h3.endpoint-title .path { font-family: var(--mono); font-size: 16px; background: none; padding: 0; }

h3.endpoint-title .endpoint-name { color: var(--ink-2); font-weight: 500; }

.method {
  display: inline-block;
  font: 600 13px/1 var(--mono);
  letter-spacing: .06em;
  padding: 5px 8px;
  border-radius: 5px;
  color: #fff;
}

.m-GET { background: var(--get); }
.m-POST { background: var(--post); }
.m-PATCH { background: var(--patch); }
.m-PUT { background: var(--patch); }
.m-DELETE { background: var(--delete); }

.sidebar .method { font-size: 13px; padding: 3px 5px; min-width: 52px; text-align: center; }

.scope-line { display: flex; align-items: center; gap: 8px; margin: 12px 0 18px; }

.scope-label { font-size: 13px; color: var(--ink-3); }

.scope {
  font-family: var(--mono);
  font-size: 13px;
  padding: 3px 8px;
  border-radius: 999px;
  color: var(--accent-ink);
  background: var(--accent-soft);
  border: 1px solid var(--accent-soft);
}

.status {
  display: inline-block;
  font: 600 13px/1 var(--mono);
  padding: 4px 7px;
  border-radius: 5px;
  border: 1px solid currentColor;
}

.s-2xx { color: var(--ok); }
.s-3xx { color: var(--ink-2); }
.s-4xx { color: var(--warn); }
.s-5xx { color: var(--bad); }

/* 表格 */

.table-wrap {
  overflow-x: auto;
  margin: 14px 0 22px;
  border: 1px solid var(--rule);
  border-radius: 10px;
  background: var(--surface);
}

table { border-collapse: collapse; width: 100%; font-size: 14px; line-height: 1.6; }

th, td { text-align: left; vertical-align: top; padding: 10px 13px; border-bottom: 1px solid var(--rule); }

thead th {
  font-size: 13px;
  letter-spacing: .05em;
  color: var(--ink-3);
  background: var(--surface-2);
  font-weight: 600;
  white-space: nowrap;
}

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

td code, th code { white-space: nowrap; }

/* 程式碼 */

code {
  font-family: var(--mono);
  font-size: .88em;
  background: var(--surface-2);
  color: var(--ink);
  padding: .1em .38em;
  border-radius: 4px;
}

pre {
  position: relative;
  margin: 14px 0 20px;
  padding: 16px 18px;
  background: var(--code-bg);
  color: var(--code-ink);
  border: 1px solid var(--code-rule);
  border-radius: 10px;
  overflow-x: auto;
  font-size: 13px;
  line-height: 1.65;
}

pre code { background: transparent; color: inherit; padding: 0; font-size: inherit; }

pre .tok-str { color: var(--code-str); }
pre .tok-key { color: var(--code-key); }
pre .tok-com { color: var(--code-com); }

.copy {
  position: absolute;
  top: 8px;
  right: 8px;
  font: 13px var(--mono);
  color: var(--code-com);
  background: var(--code-surface);
  border: 1px solid var(--code-rule);
  border-radius: 6px;
  padding: 3px 9px;
  cursor: pointer;
}

.copy:hover { color: var(--code-ink); }

/* 右欄程式碼面板 */

aside.code-pane {
  position: sticky;
  top: calc(var(--topbar-h) + 20px);
  min-width: 0;
  display: flex;
  flex-direction: column;
  gap: 18px;
}

.pane-block {
  background: var(--code-bg);
  border: 1px solid var(--code-rule);
  border-radius: 12px;
  overflow: hidden;
  box-shadow: var(--shadow);
}

.pane-head {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 12px;
  padding: 8px 12px;
  background: var(--code-surface);
  border-bottom: 1px solid var(--code-rule);
}

.pane-title { font-size: 13px; color: var(--code-com); letter-spacing: .04em; }

.tablist { display: flex; gap: 4px; }

.tablist button {
  font: 13px var(--mono);
  color: var(--code-com);
  background: transparent;
  border: 1px solid transparent;
  border-radius: 6px;
  padding: 3px 9px;
  cursor: pointer;
}

.tablist button:hover { color: var(--code-ink); }

.tablist button[aria-selected="true"] {
  color: var(--code-ink);
  background: var(--code-bg);
  border-color: var(--code-rule);
}

.pane-block pre {
  margin: 0;
  border: 0;
  border-radius: 0;
  background: var(--code-bg);
  max-height: 60vh;
}

.pane-block .pane-body + .pane-body { border-top: 1px solid var(--code-rule); }

.pane-body .pane-caption {
  padding: 8px 12px 0;
  font: 13px var(--mono);
  color: var(--code-com);
}

.pane-body[data-state="off"] { display: none; }

/* 上一頁／下一頁 */

.pager {
  display: flex;
  flex-wrap: wrap;
  gap: 12px;
  justify-content: space-between;
  max-width: 72ch;
  margin: 56px 0 0;
  padding-top: 24px;
  border-top: 1px solid var(--rule);
}

.pager-link {
  display: flex;
  flex-direction: column;
  gap: 2px;
  min-width: 180px;
  padding: 10px 14px;
  color: var(--ink);
  text-decoration: none;
  background: var(--surface);
  border: 1px solid var(--rule);
  border-radius: 10px;
}

.pager-link:hover { border-color: var(--accent); }

.pager-next { margin-left: auto; text-align: right; }

.pager-label { font-size: 13px; color: var(--ink-3); }

.pager-title { font-weight: 600; }

footer.page-footer {
  max-width: 72ch;
  margin: 32px 0 0;
  padding-top: 20px;
  border-top: 1px solid var(--rule);
  font-size: 13px;
  color: var(--ink-3);
}

/* 平板：兩欄，程式碼落到內容下方 */

@media (max-width:1180px) {
  .endpoint { grid-template-columns: minmax(0, 1fr); gap: 20px; }
  aside.code-pane { position: static; top: auto; max-width: 72ch; }
  .pane-block pre { max-height: none; }
}

/* 手機：單欄，導覽收成抽屜 */

@media (max-width:860px) {
  .layout { grid-template-columns: minmax(0, 1fr); }
  /* 中文可以逐字斷行，欄位會被壓成一字一行而永遠不觸發捲動；給表格一個最小寬度，
     窄螢幕改由 .table-wrap 水平捲動。 */
  .table-wrap table { min-width: 520px; }
  .menu-btn { display: inline-block; }
  .brand .brand-sub { display: none; }
  main { padding: 8px 18px 96px; }
  h1.page-title { font-size: 26px; }
  h2.section-title { font-size: 20px; }
  /* 抽屜用 left 位移而不是 transform：position:fixed 元素的 transform 會建立
     新的包含塊，行為在各家瀏覽器與內嵌檢視器裡不一致，left 沒有這個問題。 */
  .sidebar {
    position: fixed;
    top: var(--topbar-h);
    left: -320px;
    width: 280px;
    max-width: 86vw;
    z-index: 50;
    background: var(--surface);
    transition: left .18s ease;
  }
  .sidebar.drawer-open { left: 0; box-shadow: var(--shadow); }
  .drawer-scrim {
    position: fixed;
    inset: var(--topbar-h) 0 0;
    z-index: 45;
    background: rgba(10, 14, 18, .45);
  }
  .drawer-scrim[data-state="off"] { display: none; }
}

@media (prefers-reduced-motion: reduce) {
  html { scroll-behavior: auto; }
  * { transition: none !important; animation: none !important; }
}