/* EgyptAuth — Developer Documentation Hub (#/docs, #/r/docs, and public /docs).
   Designed for both human developers and AI coding assistants (/llms.txt & /docs.md).
   Strictly uses tokens.css roles across Light Paper, Dark Graphite, and all Accent themes. */

/* ---------- Standalone public chrome (when viewing /docs signed out) ---------- */
.docs-standalone {
  min-height: 100vh;
  display: flex;
  flex-direction: column;
  background: var(--surface-canvas);
  color: var(--ink-1);
}

.docs-pub-top {
  position: sticky;
  top: 0;
  z-index: 40;
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--s4);
  min-height: 58px;
  padding: var(--s2) var(--s6);
  background: var(--surface-1);
  border-bottom: 1px solid var(--line-1);
}

.docs-pub-brand {
  display: inline-flex;
  align-items: center;
  gap: 10px;
  text-decoration: none;
  color: var(--ink-1);
  font-weight: var(--fw-semibold);
  font-size: 17px;
  letter-spacing: -0.03em;
  flex-shrink: 0;
}

.docs-pub-brand img {
  width: 28px;
  height: 28px;
  object-fit: contain;
}

.docs-pub-badge {
  display: inline-flex;
  align-items: center;
  gap: 5px;
  height: 22px;
  padding-inline: 8px;
  border-radius: var(--r-pill);
  background: var(--accent-soft);
  border: 1px solid var(--accent-line);
  color: var(--accent-text);
  font-size: var(--fs-2xs);
  font-weight: var(--fw-medium);
  letter-spacing: 0;
}

.docs-pub-actions {
  display: flex;
  align-items: center;
  gap: var(--s2);
  flex-wrap: wrap;
}

.docs-standalone-body {
  flex: 1;
  width: 100%;
  max-width: 1460px;
  margin-inline: auto;
  padding: var(--s6);
}

/* ---------- Workspace & standalone shared shell ---------- */
.docs-hub {
  display: flex;
  flex-direction: column;
  gap: var(--s4);
  min-width: 0;
}

/* Top live context & AI bar */
.docs-context-bar {
  display: flex;
  align-items: center;
  justify-content: space-between;
  flex-wrap: wrap;
  gap: var(--s3);
  padding: var(--s3) var(--s4);
  background: var(--surface-1);
  border: 1px solid var(--line-1);
  border-radius: var(--r-lg);
}

.docs-context-left {
  display: flex;
  align-items: center;
  flex-wrap: wrap;
  gap: var(--s3);
  min-width: 0;
}

.docs-context-field {
  display: inline-flex;
  align-items: center;
  gap: var(--s2);
  min-width: 0;
}

.docs-context-label {
  font-size: var(--fs-xs);
  font-weight: var(--fw-medium);
  color: var(--ink-3);
  white-space: nowrap;
}

.docs-context-select,
.docs-context-input {
  height: 32px;
  padding-inline: 10px;
  font-size: var(--fs-xs);
  border-radius: var(--r);
  border: 1px solid var(--line-2);
  background: var(--surface-input);
  color: var(--ink-1);
}

.docs-context-select {
  min-width: 175px;
  max-width: 260px;
}

.docs-context-input {
  width: 220px;
  font-family: var(--font-mono);
}

.docs-context-select:focus-visible,
.docs-context-input:focus-visible {
  outline: none;
  box-shadow: var(--focus-ring);
  border-color: var(--accent);
}

.docs-context-pill {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  height: 26px;
  padding-inline: 9px;
  border-radius: var(--r-pill);
  background: var(--ok-soft);
  border: 1px solid var(--ok-line);
  color: var(--ok-text);
  font-size: var(--fs-2xs);
  font-weight: var(--fw-medium);
}

.docs-ai-tools {
  display: flex;
  align-items: center;
  flex-wrap: wrap;
  gap: var(--s2);
}

/* ---------- 3-Column Layout ---------- */
.docs-grid {
  display: grid;
  grid-template-columns: 256px minmax(0, 1fr) 212px;
  gap: var(--s6);
  align-items: start;
}

/* ---------- Left Category Sidebar ---------- */
.docs-nav-rail {
  position: sticky;
  top: 74px;
  display: flex;
  flex-direction: column;
  gap: var(--s3);
  max-height: calc(100vh - 96px);
  overflow-y: auto;
  padding: var(--s3);
  background: var(--surface-1);
  border: 1px solid var(--line-1);
  border-radius: var(--r-lg);
  scrollbar-width: thin;
  scrollbar-color: var(--scrollbar) transparent;
}

.page-host .docs-nav-rail,
.page-host .docs-toc-rail {
  top: 16px;
  max-height: calc(100vh - 36px);
}

.docs-search-box {
  position: relative;
  display: flex;
  align-items: center;
}

.docs-search-box > .icon {
  position: absolute;
  inset-inline-start: 10px;
  width: 14px;
  height: 14px;
  color: var(--ink-3);
  pointer-events: none;
}

.docs-search-input {
  width: 100%;
  height: 34px;
  padding-inline: 30px 32px;
  border-radius: var(--r);
  border: 1px solid var(--line-2);
  background: var(--surface-input);
  color: var(--ink-1);
  font-size: var(--fs-sm);
}

.docs-search-input:focus-visible {
  outline: none;
  border-color: var(--accent);
  box-shadow: var(--focus-ring);
}

.docs-search-kbd {
  position: absolute;
  inset-inline-end: 8px;
  display: inline-grid;
  place-items: center;
  min-width: 18px;
  height: 18px;
  padding-inline: 4px;
  border-radius: var(--r-xs);
  border: 1px solid var(--line-1);
  background: var(--surface-2);
  color: var(--ink-3);
  font-family: var(--font-mono);
  font-size: 10px;
  pointer-events: none;
}

.docs-nav-groups {
  display: flex;
  flex-direction: column;
  gap: var(--s4);
}

.docs-nav-group {
  display: flex;
  flex-direction: column;
  gap: 2px;
}

.docs-nav-group-title {
  padding: 2px 8px 4px;
  font-size: 11px;
  font-weight: var(--fw-semibold);
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--ink-3);
}

.docs-nav-btn {
  position: relative;
  display: flex;
  align-items: center;
  gap: 9px;
  width: 100%;
  min-height: 34px;
  padding: 6px 10px;
  border-radius: var(--r);
  border: 0;
  background: transparent;
  color: var(--ink-2);
  font-size: var(--fs-sm);
  font-weight: var(--fw-regular);
  text-align: start;
  cursor: pointer;
  transition: background-color var(--t-fast), color var(--t-fast);
}

.docs-nav-btn > .icon {
  width: 15px;
  height: 15px;
  flex-shrink: 0;
  color: var(--ink-3);
}

.docs-nav-btn:hover {
  background: var(--state-hover);
  color: var(--ink-1);
}

.docs-nav-btn:hover > .icon {
  color: var(--ink-1);
}

.docs-nav-btn.is-active {
  background: var(--state-selected);
  color: var(--accent-text);
  font-weight: var(--fw-medium);
}

.docs-nav-btn.is-active::before {
  content: "";
  position: absolute;
  inset-inline-start: 0;
  inset-block: 7px;
  width: 2.5px;
  border-radius: 2px;
  background: var(--accent);
}

.docs-nav-btn.is-active > .icon {
  color: var(--accent-text);
}

/* Mobile topic picker */
.docs-mobile-picker {
  display: none;
  gap: var(--s2);
  align-items: center;
  padding: var(--s3);
  background: var(--surface-1);
  border: 1px solid var(--line-1);
  border-radius: var(--r-lg);
}

.docs-mobile-picker select {
  flex: 1;
  height: 36px;
  padding-inline: 10px;
  border-radius: var(--r);
  border: 1px solid var(--line-2);
  background: var(--surface-input);
  color: var(--ink-1);
  font-size: var(--fs-base);
}

/* ---------- Center Article Surface ---------- */
.docs-article-wrap {
  min-width: 0;
  display: flex;
  flex-direction: column;
  gap: var(--s4);
}

.docs-article {
  background: var(--surface-1);
  border: 1px solid var(--line-1);
  border-radius: var(--r-lg);
  padding: var(--s7) var(--s8);
  min-width: 0;
}

.docs-article-head {
  display: flex;
  flex-direction: column;
  gap: var(--s3);
  padding-bottom: var(--s5);
  margin-bottom: var(--s6);
  border-bottom: 1px solid var(--line-1);
}

.docs-article-toprow {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--s3);
  flex-wrap: wrap;
}

.docs-eyebrow {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  font-size: var(--fs-xs);
  font-weight: var(--fw-semibold);
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--accent-text);
}

.docs-article-title {
  margin: 0;
  font-size: 26px;
  line-height: 1.2;
  letter-spacing: var(--tracking-title);
  font-weight: var(--fw-semibold);
  color: var(--ink-1);
}

.docs-article-lead {
  margin: 0;
  font-size: 15px;
  line-height: 1.55;
  color: var(--ink-2);
  max-width: 74ch;
}

/* Prose typography inside docs */
.docs-prose {
  display: flex;
  flex-direction: column;
  gap: var(--s5);
  color: var(--ink-1);
  font-size: var(--fs-base);
  line-height: 1.62;
}

.docs-section-block {
  display: flex;
  flex-direction: column;
  gap: var(--s3);
  scroll-margin-top: 84px;
}

.docs-section-block + .docs-section-block {
  padding-top: var(--s5);
  border-top: 1px solid var(--line-1);
}

.docs-h2 {
  display: flex;
  align-items: center;
  gap: var(--s2);
  margin: 0;
  font-size: 19px;
  font-weight: var(--fw-semibold);
  letter-spacing: var(--tracking-heading);
  color: var(--ink-1);
}

.docs-anchor-btn {
  display: inline-grid;
  place-items: center;
  width: 24px;
  height: 24px;
  border-radius: var(--r-sm);
  border: 0;
  background: transparent;
  color: var(--ink-3);
  opacity: 0;
  cursor: pointer;
  transition: opacity var(--t-fast), background-color var(--t-fast), color var(--t-fast);
}

.docs-h2:hover .docs-anchor-btn,
.docs-anchor-btn:focus-visible {
  opacity: 1;
}

.docs-anchor-btn:hover {
  background: var(--state-hover);
  color: var(--accent-text);
}

.docs-h3 {
  margin: var(--s2) 0 0;
  font-size: 15px;
  font-weight: var(--fw-semibold);
  color: var(--ink-1);
}

.docs-prose p {
  margin: 0;
  color: var(--ink-2);
  max-width: 78ch;
}

.docs-prose ul,
.docs-prose ol {
  margin: 0;
  padding-inline-start: 20px;
  display: flex;
  flex-direction: column;
  gap: 6px;
  color: var(--ink-2);
}

.docs-prose li strong {
  color: var(--ink-1);
  font-weight: var(--fw-medium);
}

.docs-prose code:not(pre code) {
  font-family: var(--font-mono);
  font-size: 12.5px;
  padding: 2px 6px;
  border-radius: var(--r-sm);
  background: var(--surface-sunken);
  border: 1px solid var(--line-1);
  color: var(--ink-1);
}

/* ---------- Feature & Architecture Cards Grid ---------- */
.docs-cards {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(230px, 1fr));
  gap: var(--s3);
}

.docs-feature-card {
  display: flex;
  flex-direction: column;
  gap: 6px;
  padding: var(--s4);
  border-radius: var(--r-lg);
  border: 1px solid var(--line-1);
  background: var(--surface-2);
  text-align: start;
  transition: border-color var(--t-fast), background-color var(--t-fast);
}

button.docs-feature-card {
  cursor: pointer;
}

button.docs-feature-card:hover {
  border-color: var(--accent-line);
  background: var(--state-hover);
}

.docs-feature-head {
  display: flex;
  align-items: center;
  gap: 8px;
  font-weight: var(--fw-semibold);
  font-size: var(--fs-base);
  color: var(--ink-1);
}

.docs-feature-head > .icon {
  color: var(--accent-text);
  flex-shrink: 0;
}

.docs-feature-desc {
  font-size: var(--fs-sm);
  line-height: 1.45;
  color: var(--ink-2);
}

/* ---------- Numbered Step Flows ---------- */
.docs-steps {
  display: flex;
  flex-direction: column;
  gap: var(--s3);
}

.docs-step {
  display: grid;
  grid-template-columns: 28px minmax(0, 1fr);
  gap: var(--s3);
  align-items: start;
  padding: var(--s3) var(--s4);
  border-radius: var(--r-lg);
  border: 1px solid var(--line-1);
  background: var(--surface-2);
}

.docs-step-num {
  display: grid;
  place-items: center;
  width: 26px;
  height: 26px;
  border-radius: var(--r-pill);
  background: var(--accent-soft);
  border: 1px solid var(--accent-line);
  color: var(--accent-text);
  font-family: var(--font-mono);
  font-size: var(--fs-xs);
  font-weight: var(--fw-semibold);
}

.docs-step-body {
  display: flex;
  flex-direction: column;
  gap: 4px;
  min-width: 0;
}

.docs-step-title {
  font-weight: var(--fw-semibold);
  color: var(--ink-1);
  font-size: var(--fs-base);
}

.docs-step-text {
  font-size: var(--fs-sm);
  color: var(--ink-2);
  line-height: 1.5;
}

/* ---------- Callouts ---------- */
.docs-callout {
  display: flex;
  align-items: flex-start;
  gap: var(--s3);
  padding: var(--s3) var(--s4);
  border-radius: var(--r-lg);
  border: 1px solid var(--info-line);
  background: var(--info-soft);
  color: var(--ink-1);
  font-size: var(--fs-sm);
  line-height: 1.5;
}

.docs-callout > .icon {
  width: 17px;
  height: 17px;
  flex-shrink: 0;
  margin-top: 2px;
  color: var(--info-text);
}

.docs-callout.is-ok {
  border-color: var(--ok-line);
  background: var(--ok-soft);
}
.docs-callout.is-ok > .icon { color: var(--ok-text); }

.docs-callout.is-warn {
  border-color: var(--warn-line);
  background: var(--warn-soft);
}
.docs-callout.is-warn > .icon { color: var(--warn-text); }

.docs-callout-title {
  font-weight: var(--fw-semibold);
  color: var(--ink-1);
  margin-bottom: 2px;
}

/* ---------- Multi-Language Tabbed Code Workbench ---------- */
.docs-codebox {
  border: 1px solid var(--line-1);
  border-radius: var(--r-lg);
  overflow: hidden;
  background: var(--surface-sunken);
}

.docs-codebox-head {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--s2);
  flex-wrap: wrap;
  padding: 7px 12px;
  background: var(--surface-2);
  border-bottom: 1px solid var(--line-1);
}

.docs-codebox-title {
  display: inline-flex;
  align-items: center;
  gap: 7px;
  font-family: var(--font-mono);
  font-size: var(--fs-xs);
  font-weight: var(--fw-medium);
  color: var(--ink-2);
}

.docs-lang-tabs {
  display: flex;
  align-items: center;
  gap: 3px;
  flex-wrap: wrap;
}

.docs-lang-tab {
  height: 26px;
  padding-inline: 9px;
  border-radius: var(--r-sm);
  border: 1px solid transparent;
  background: transparent;
  color: var(--ink-3);
  font-size: var(--fs-xs);
  font-weight: var(--fw-medium);
  cursor: pointer;
  transition: background-color var(--t-fast), color var(--t-fast), border-color var(--t-fast);
}

.docs-lang-tab:hover {
  background: var(--state-hover);
  color: var(--ink-1);
}

.docs-lang-tab.is-active {
  background: var(--surface-1);
  border-color: var(--line-2);
  color: var(--accent-text);
  font-weight: var(--fw-semibold);
}

.docs-codebox .code-block {
  border: 0;
  border-radius: 0;
  margin: 0;
}

.docs-codebox pre.code {
  margin: 0;
  padding: 14px 44px 14px 16px;
  font-family: var(--font-mono);
  font-size: 12.5px;
  line-height: 1.58;
  overflow-x: auto;
  white-space: pre;
}

/* ---------- HTTP Endpoint Reference Cards ---------- */
.docs-endpoint {
  display: flex;
  flex-direction: column;
  gap: var(--s3);
  padding: var(--s4);
  border-radius: var(--r-lg);
  border: 1px solid var(--line-1);
  background: var(--surface-2);
}

.docs-endpoint-bar {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--s2);
  flex-wrap: wrap;
}

.docs-endpoint-route {
  display: inline-flex;
  align-items: center;
  gap: 9px;
  flex-wrap: wrap;
  min-width: 0;
}

.docs-method {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  min-width: 52px;
  height: 22px;
  padding-inline: 8px;
  border-radius: var(--r-sm);
  font-family: var(--font-mono);
  font-size: 11px;
  font-weight: var(--fw-semibold);
  letter-spacing: 0.03em;
  text-transform: uppercase;
}

.docs-method.is-get { background: var(--info-soft); border: 1px solid var(--info-line); color: var(--info-text); }
.docs-method.is-post { background: var(--ok-soft); border: 1px solid var(--ok-line); color: var(--ok-text); }
.docs-method.is-put,
.docs-method.is-patch { background: var(--warn-soft); border: 1px solid var(--warn-line); color: var(--warn-text); }
.docs-method.is-delete { background: var(--danger-soft); border: 1px solid var(--danger-line); color: var(--danger-text); }

.docs-endpoint-path {
  font-family: var(--font-mono);
  font-size: 13px;
  font-weight: var(--fw-medium);
  color: var(--ink-1);
  word-break: break-all;
}

.docs-endpoint-auth {
  display: inline-flex;
  align-items: center;
  gap: 5px;
  height: 22px;
  padding-inline: 8px;
  border-radius: var(--r-pill);
  border: 1px solid var(--line-2);
  background: var(--surface-1);
  color: var(--ink-2);
  font-size: var(--fs-2xs);
  font-weight: var(--fw-medium);
}

/* ---------- Reference Tables ---------- */
.docs-table-wrap {
  width: 100%;
  overflow-x: auto;
  border: 1px solid var(--line-1);
  border-radius: var(--r-lg);
  background: var(--surface-1);
}

.docs-table {
  width: 100%;
  border-collapse: collapse;
  font-size: var(--fs-sm);
  text-align: start;
}

.docs-table th {
  padding: 10px 12px;
  background: var(--surface-2);
  border-bottom: 1px solid var(--line-1);
  color: var(--ink-2);
  font-size: var(--fs-xs);
  font-weight: var(--fw-semibold);
  white-space: nowrap;
  text-align: start;
}

.docs-table td {
  padding: 10px 12px;
  border-bottom: 1px solid var(--line-1);
  color: var(--ink-2);
  vertical-align: top;
  line-height: 1.48;
}

.docs-table tr:last-child td {
  border-bottom: 0;
}

.docs-table td:first-child {
  color: var(--ink-1);
  font-weight: var(--fw-medium);
}

/* ---------- Prev / Next Footer Navigation ---------- */
.docs-pager {
  display: grid;
  grid-template-columns: repeat(2, minmax(0, 1fr));
  gap: var(--s3);
}

.docs-pager-btn {
  display: flex;
  flex-direction: column;
  gap: 4px;
  padding: var(--s4);
  border-radius: var(--r-lg);
  border: 1px solid var(--line-1);
  background: var(--surface-1);
  color: var(--ink-1);
  text-align: start;
  cursor: pointer;
  transition: border-color var(--t-fast), background-color var(--t-fast);
}

.docs-pager-btn.is-next {
  text-align: end;
  align-items: flex-end;
}

.docs-pager-btn:hover {
  border-color: var(--accent-line);
  background: var(--state-hover);
}

.docs-pager-dir {
  display: inline-flex;
  align-items: center;
  gap: 5px;
  font-size: var(--fs-xs);
  color: var(--ink-3);
}

.docs-pager-title {
  font-size: var(--fs-base);
  font-weight: var(--fw-semibold);
  color: var(--accent-text);
}

/* ---------- Search Results View ---------- */
.docs-search-results {
  display: flex;
  flex-direction: column;
  gap: var(--s3);
}

.docs-search-hit {
  display: flex;
  flex-direction: column;
  gap: 4px;
  padding: var(--s4);
  border-radius: var(--r-lg);
  border: 1px solid var(--line-1);
  background: var(--surface-2);
  text-align: start;
  cursor: pointer;
  transition: border-color var(--t-fast), background-color var(--t-fast);
}

.docs-search-hit:hover {
  border-color: var(--accent-line);
  background: var(--state-hover);
}

/* ---------- Right "On This Page" TOC Rail ---------- */
.docs-toc-rail {
  position: sticky;
  top: 74px;
  display: flex;
  flex-direction: column;
  gap: var(--s2);
  padding: var(--s3);
  background: var(--surface-1);
  border: 1px solid var(--line-1);
  border-radius: var(--r-lg);
  max-height: calc(100vh - 96px);
  overflow-y: auto;
}

.docs-toc-title {
  display: flex;
  align-items: center;
  gap: 6px;
  font-size: 11px;
  font-weight: var(--fw-semibold);
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--ink-3);
  padding-bottom: 4px;
}

.docs-toc-list {
  display: flex;
  flex-direction: column;
  gap: 2px;
  border-inline-start: 1px solid var(--line-1);
}

.docs-toc-link {
  display: block;
  padding: 5px 10px;
  margin-inline-start: -1px;
  border-inline-start: 2px solid transparent;
  background: transparent;
  border-top: 0;
  border-right: 0;
  border-bottom: 0;
  color: var(--ink-3);
  font-size: var(--fs-xs);
  line-height: 1.35;
  text-align: start;
  cursor: pointer;
  transition: color var(--t-fast), border-color var(--t-fast);
}

.docs-toc-link:hover {
  color: var(--ink-1);
}

.docs-toc-link.is-active {
  color: var(--accent-text);
  border-inline-start-color: var(--accent);
  font-weight: var(--fw-medium);
}

.docs-toc-ai-box {
  margin-top: var(--s3);
  padding-top: var(--s3);
  border-top: 1px solid var(--line-1);
  display: flex;
  flex-direction: column;
  gap: 6px;
}

.docs-toc-ai-link {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  font-size: var(--fs-xs);
  color: var(--ink-2);
  text-decoration: none;
  padding: 4px 6px;
  border-radius: var(--r-sm);
}

.docs-toc-ai-link:hover {
  background: var(--state-hover);
  color: var(--accent-text);
}

.docs-nav-empty {
  padding: var(--s2);
  margin: 0;
}

.docs-search-hit-title {
  font-size: 16px;
  color: var(--ink-1);
}

.docs-search-hit-subs {
  color: var(--accent-text);
}

/* ---------- Responsive Breakpoints ---------- */
@media (max-width: 1320px) {
  .docs-grid {
    grid-template-columns: 244px minmax(0, 1fr);
  }
  .docs-toc-rail {
    display: none;
  }
}

@media (max-width: 980px) {
  .docs-grid {
    grid-template-columns: minmax(0, 1fr);
  }
  .docs-nav-rail {
    display: none;
  }
  .docs-mobile-picker {
    display: flex;
  }
  .docs-article {
    padding: var(--s5);
  }
  .docs-standalone-body {
    padding: var(--s3);
  }
  .docs-pub-top {
    padding: var(--s2) var(--s3);
  }
  .docs-pager {
    grid-template-columns: 1fr;
  }
  .docs-pager-btn.is-next {
    text-align: start;
    align-items: flex-start;
  }
}

/* The authenticated shell consumes width too; adapt to the article's available space. */
.docs-hub { container-type: inline-size; }
@container (max-width: 1080px) {
  .docs-grid { grid-template-columns: 224px minmax(0, 1fr); }
  .docs-nav-rail { display: flex; }
  .docs-mobile-picker { display: none; }
  .docs-toc-rail { display: none; }
}
@container (max-width: 720px) {
  .docs-grid { grid-template-columns: minmax(0, 1fr); }
  .docs-nav-rail { display: none; }
  .docs-mobile-picker { display: flex; }
}