/* ==========================================================================
   SecretHarbor Documentation Stylesheet (docs.css)
   Pairs with styles.css & accessibility.css for Apple/Stripe-grade cybernetic aesthetic
   ========================================================================== */

/* Layout Grid for Documentation */
.docs-page {
  display: flex;
  flex-direction: column;
  min-height: 100vh;
}

.docs-header {
  position: sticky;
  top: 0;
  z-index: 50;
  background: rgba(6, 11, 17, 0.88);
  backdrop-filter: blur(16px);
  -webkit-backdrop-filter: blur(16px);
  border-bottom: 1px solid var(--line);
}

.docs-header-inner {
  width: min(1440px, calc(100% - 48px));
  height: 72px;
  margin: 0 auto;
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 20px;
}

.docs-brand-group {
  display: flex;
  align-items: center;
  gap: 16px;
}

.docs-breadcrumb {
  display: flex;
  align-items: center;
  gap: 8px;
  color: var(--muted-2);
  font: 10px var(--mono);
  letter-spacing: 0.06em;
  padding-left: 16px;
  border-left: 1px solid var(--line);
}

.docs-breadcrumb a {
  color: var(--muted);
  transition: color 0.2s;
}

.docs-breadcrumb a:hover {
  color: var(--signal);
}

.docs-breadcrumb .crumb-sep {
  color: var(--muted-2);
  font-size: 8px;
}

.docs-breadcrumb .crumb-active {
  color: var(--paper-2);
}

.docs-header-tools {
  display: flex;
  align-items: center;
  gap: 14px;
}

/* Quick Search in Header */
.docs-search-bar {
  position: relative;
  width: 280px;
}

.docs-search-input {
  width: 100%;
  padding: 8px 36px 8px 32px;
  background: rgba(13, 27, 38, 0.75);
  border: 1px solid var(--line);
  border-radius: 4px;
  color: var(--paper);
  font: 11px var(--mono);
  outline: none;
  transition: border-color 0.2s, background 0.2s, box-shadow 0.2s;
}

.docs-search-input:focus {
  border-color: var(--signal);
  background: rgba(18, 38, 52, 0.9);
  box-shadow: 0 0 0 1px var(--signal), 0 0 16px rgba(185, 245, 106, 0.15);
}

.docs-search-input::placeholder {
  color: var(--muted-2);
}

.docs-search-icon {
  position: absolute;
  left: 10px;
  top: 50%;
  transform: translateY(-50%);
  width: 13px;
  height: 13px;
  color: var(--muted-2);
  pointer-events: none;
}

.docs-search-kbd {
  position: absolute;
  right: 8px;
  top: 50%;
  transform: translateY(-50%);
  padding: 2px 5px;
  background: rgba(255, 255, 255, 0.05);
  border: 1px solid var(--line);
  border-radius: 3px;
  color: var(--muted-2);
  font: 9px var(--mono);
  pointer-events: none;
}

.docs-home-btn {
  display: inline-flex;
  align-items: center;
  gap: 7px;
  padding: 7px 12px;
  background: rgba(13, 27, 38, 0.6);
  border: 1px solid var(--line);
  border-radius: 3px;
  color: var(--paper-2);
  font: 10px var(--mono);
  transition: all 0.2s;
}

.docs-home-btn:hover {
  color: var(--signal);
  border-color: var(--line-strong);
  background: rgba(18, 38, 52, 0.85);
  transform: translateY(-1px);
}

/* Three-column documentation layout */
.docs-container {
  width: min(1440px, calc(100% - 48px));
  margin: 0 auto;
  display: grid;
  grid-template-columns: 280px minmax(0, 1fr) 240px;
  gap: 40px;
  padding: 36px 0 120px;
  position: relative;
}

/* Sidebar Navigation */
.docs-sidebar {
  position: sticky;
  top: 96px;
  height: calc(100vh - 120px);
  overflow-y: auto;
  padding-right: 16px;
  border-right: 1px solid var(--line);
  scrollbar-width: thin;
  scrollbar-color: var(--line) transparent;
}

.docs-sidebar::-webkit-scrollbar {
  width: 4px;
}

.docs-sidebar::-webkit-scrollbar-thumb {
  background: var(--line-strong);
  border-radius: 2px;
}

.docs-sidebar-section {
  margin-bottom: 28px;
}

.docs-sidebar-heading {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 0 8px 8px;
  color: var(--muted-2);
  font: 9px var(--mono);
  letter-spacing: 0.14em;
  text-transform: uppercase;
  border-bottom: 1px solid rgba(165, 203, 207, 0.08);
  margin-bottom: 10px;
}

.docs-sidebar-nav {
  list-style: none;
  margin: 0;
  padding: 0;
  display: flex;
  flex-direction: column;
  gap: 2px;
}

.docs-nav-item a {
  display: flex;
  align-items: center;
  gap: 9px;
  padding: 8px 10px;
  border-radius: 4px;
  color: var(--muted);
  font-size: 12px;
  line-height: 1.4;
  transition: transform 0.22s cubic-bezier(0.2, 0.8, 0.2, 1), color 0.2s, background 0.2s;
  position: relative;
}

.docs-nav-item a:hover {
  color: var(--paper);
  background: rgba(18, 38, 52, 0.55);
  transform: translateX(2px);
}

.docs-nav-item a.is-active {
  color: var(--signal);
  background: rgba(var(--signal-rgb), 0.08);
  font-weight: 600;
  transform: translateX(4px);
  box-shadow: inset 2px 0 0 var(--signal);
}

.docs-nav-item a.is-active::before {
  content: "";
  position: absolute;
  left: 0;
  top: 4px;
  bottom: 4px;
  width: 3px;
  background: var(--signal);
  box-shadow: 0 0 10px var(--signal);
  border-radius: 2px;
}

.docs-nav-num {
  font: 9px var(--mono);
  color: var(--muted-2);
  min-width: 16px;
}

.docs-nav-item a.is-active .docs-nav-num {
  color: var(--signal);
}

.docs-nav-tag {
  margin-left: auto;
  font: 8px var(--mono);
  padding: 1px 5px;
  border-radius: 2px;
  background: rgba(116, 201, 246, 0.12);
  color: var(--blue);
}

.docs-nav-tag.green {
  background: rgba(152, 239, 176, 0.12);
  color: var(--green);
}

.docs-nav-tag.amber {
  background: rgba(247, 200, 115, 0.12);
  color: var(--amber);
}

/* Center Content Column */
.docs-main {
  min-width: 0;
  max-width: 860px;
}

/* Hero / Header banner */
.docs-hero {
  margin-bottom: 50px;
  padding-bottom: 32px;
  border-bottom: 1px solid var(--line);
}

.docs-badges {
  display: flex;
  flex-wrap: wrap;
  gap: 8px;
  margin-bottom: 18px;
}

.docs-badge {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  padding: 4px 8px;
  border: 1px solid var(--line);
  background: rgba(13, 27, 38, 0.7);
  border-radius: 2px;
  color: var(--muted);
  font: 9px var(--mono);
  letter-spacing: 0.06em;
}

.docs-badge b {
  color: var(--paper);
  font-weight: 500;
}

.docs-badge.signal b {
  color: var(--signal);
}

.docs-badge.blue b {
  color: var(--blue);
}

.docs-hero h1 {
  font-size: clamp(34px, 4.2vw, 52px);
  line-height: 1.05;
  letter-spacing: -0.06em;
  font-weight: 500;
  margin-bottom: 18px;
}

.docs-hero-lead {
  font-size: 16px;
  line-height: 1.7;
  color: var(--paper-2);
  max-width: 760px;
  margin-bottom: 24px;
}

.docs-meta-strip {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: 20px;
  color: var(--muted-2);
  font: 10px var(--mono);
}

.docs-meta-strip span {
  display: flex;
  align-items: center;
  gap: 6px;
}

.docs-meta-strip b {
  color: var(--muted);
  font-weight: normal;
}

/* Content Sections */
.docs-section {
  margin-bottom: 72px;
  padding-top: 24px;
  border-top: 1px solid var(--line);
  scroll-margin-top: 96px;
}

.docs-section-tag {
  display: inline-flex;
  align-items: center;
  gap: 8px;
  color: var(--signal);
  font: 9px var(--mono);
  letter-spacing: 0.16em;
  text-transform: uppercase;
  margin-bottom: 10px;
}

.docs-section-tag span {
  color: var(--muted-2);
}

.docs-section h2 {
  font-size: clamp(26px, 3.2vw, 36px);
  letter-spacing: -0.05em;
  font-weight: 500;
  margin: 0 0 16px;
  color: var(--paper);
}

.docs-section h3 {
  font-size: 20px;
  letter-spacing: -0.03em;
  font-weight: 500;
  margin: 36px 0 14px;
  color: var(--paper);
  display: flex;
  align-items: center;
  gap: 10px;
}

.docs-section h3::before {
  content: "§";
  color: var(--signal);
  font-size: 16px;
  font-weight: 400;
}

.docs-section h4 {
  font-size: 15px;
  letter-spacing: -0.02em;
  font-weight: 600;
  margin: 24px 0 10px;
  color: var(--paper-2);
}

.docs-section p {
  color: var(--paper-2);
  font-size: 14px;
  line-height: 1.75;
  margin-bottom: 18px;
}

.docs-section strong {
  color: var(--paper);
  font-weight: 600;
}

.docs-section em {
  color: var(--signal);
  font-style: italic;
  font-family: var(--serif);
}

.docs-section ul,
.docs-section ol {
  color: var(--paper-2);
  font-size: 14px;
  line-height: 1.75;
  margin: 0 0 20px 20px;
  padding: 0;
}

.docs-section li {
  margin-bottom: 8px;
}

.docs-section code:not(pre code) {
  padding: 2px 6px;
  background: rgba(13, 27, 38, 0.85);
  border: 1px solid var(--line);
  border-radius: 3px;
  color: var(--blue);
  font: 11px var(--mono);
}

/* Callout Blocks */
.docs-callout {
  margin: 24px 0;
  padding: 18px 20px;
  background: rgba(10, 26, 38, 0.7);
  border: 1px solid var(--line);
  border-left: 3px solid var(--signal);
  border-radius: 2px;
}

.docs-callout-header {
  display: flex;
  align-items: center;
  gap: 8px;
  margin-bottom: 8px;
  font: 10px var(--mono);
  letter-spacing: 0.1em;
  text-transform: uppercase;
}

.docs-callout-header span {
  font-size: 14px;
}

.docs-callout p {
  margin: 0;
  font-size: 13px;
  line-height: 1.65;
  color: var(--paper-2);
}

.docs-callout.tip {
  border-left-color: var(--signal);
}
.docs-callout.tip .docs-callout-header {
  color: var(--signal);
}

.docs-callout.info {
  border-left-color: var(--blue);
}
.docs-callout.info .docs-callout-header {
  color: var(--blue);
}

.docs-callout.warning {
  border-left-color: var(--amber);
}
.docs-callout.warning .docs-callout-header {
  color: var(--amber);
}

.docs-callout.security {
  border-left-color: var(--red);
  background: rgba(38, 14, 18, 0.4);
}
.docs-callout.security .docs-callout-header {
  color: var(--red);
}

/* Code Blocks with Header & Copy Button */
.code-block {
  margin: 22px 0 26px;
  border: 1px solid var(--line-strong);
  border-radius: 3px;
  background: #07131c;
  overflow: hidden;
  box-shadow: 0 12px 32px rgba(0, 0, 0, 0.28);
}

.code-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 9px 14px;
  background: rgba(11, 23, 33, 0.95);
  border-bottom: 1px solid var(--line);
  color: var(--muted-2);
  font: 9px var(--mono);
  letter-spacing: 0.08em;
}

.code-lang {
  display: flex;
  align-items: center;
  gap: 8px;
  color: var(--paper-2);
}

.code-lang i {
  display: inline-block;
  width: 6px;
  height: 6px;
  border-radius: 50%;
  background: var(--signal);
  box-shadow: 0 0 6px var(--signal);
}

.code-actions {
  display: flex;
  align-items: center;
  gap: 12px;
}

.copy-code-btn {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  padding: 3px 8px;
  background: rgba(255, 255, 255, 0.04);
  border: 1px solid var(--line);
  border-radius: 2px;
  color: var(--muted);
  cursor: pointer;
  font: 9px var(--mono);
  transition: all 0.2s;
}

.copy-code-btn:hover {
  color: var(--signal);
  border-color: var(--signal);
  background: rgba(185, 245, 106, 0.08);
}

.code-block pre {
  margin: 0;
  padding: 18px 18px 20px;
  overflow-x: auto;
  color: var(--paper);
  font: 12px/1.7 var(--mono);
}

.code-block code {
  font-family: inherit;
}

/* Syntax highlight simulation */
.hl-cmd { color: var(--signal); font-weight: 600; }
.hl-flag { color: var(--blue); }
.hl-str { color: #8ce3a0; }
.hl-comment { color: var(--muted-2); font-style: italic; }
.hl-kw { color: var(--amber); }
.hl-fake { color: var(--blue); font-weight: 600; }
.hl-deny { color: var(--red); font-weight: 600; }
.hl-allow { color: var(--green); font-weight: 600; }

/* Interactive Tab switcher for code blocks */
.code-tab-group {
  margin: 22px 0 26px;
  border: 1px solid var(--line-strong);
  border-radius: 3px;
  background: #07131c;
  overflow: hidden;
}

.code-tabs-nav {
  display: flex;
  align-items: center;
  gap: 2px;
  padding: 0 8px;
  background: rgba(11, 23, 33, 0.95);
  border-bottom: 1px solid var(--line);
  overflow-x: auto;
}

.code-tab-btn {
  padding: 10px 14px;
  background: transparent;
  border: 0;
  border-bottom: 2px solid transparent;
  color: var(--muted);
  cursor: pointer;
  font: 9px var(--mono);
  letter-spacing: 0.06em;
  white-space: nowrap;
  transition: all 0.2s;
}

.code-tab-btn:hover {
  color: var(--paper);
}

.code-tab-btn.is-active {
  color: var(--signal);
  border-bottom-color: var(--signal);
}

.code-tab-pane {
  display: none;
}

.code-tab-pane.is-active {
  display: block;
}

.code-tab-pane pre {
  margin: 0;
  padding: 18px 18px 20px;
  overflow-x: auto;
  color: var(--paper);
  font: 12px/1.7 var(--mono);
}

/* Cybernetic Data Tables */
.docs-table-wrap {
  margin: 24px 0 32px;
  overflow-x: auto;
  border: 1px solid var(--line-strong);
  border-radius: 3px;
  background: #081622;
}

.docs-table {
  width: 100%;
  border-collapse: collapse;
  font-size: 12px;
  text-align: left;
}

.docs-table th {
  padding: 12px 16px;
  background: rgba(12, 28, 40, 0.95);
  border-bottom: 1px solid var(--line-strong);
  color: var(--muted);
  font: 9px var(--mono);
  letter-spacing: 0.1em;
  text-transform: uppercase;
}

.docs-table td {
  padding: 13px 16px;
  border-bottom: 1px solid var(--line);
  color: var(--paper-2);
  vertical-align: top;
  line-height: 1.6;
}

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

.docs-table tr:hover td {
  background: rgba(18, 38, 52, 0.4);
}

.docs-table code {
  color: var(--blue);
  font: 11px var(--mono);
}

/* Status / Feature Pills in Tables */
.pill {
  display: inline-block;
  padding: 2px 7px;
  border-radius: 2px;
  font: 8px var(--mono);
  letter-spacing: 0.08em;
  text-transform: uppercase;
  font-weight: 500;
}

.pill-green {
  background: rgba(152, 239, 176, 0.14);
  color: var(--green);
  border: 1px solid rgba(152, 239, 176, 0.3);
}

.pill-blue {
  background: rgba(116, 201, 246, 0.14);
  color: var(--blue);
  border: 1px solid rgba(116, 201, 246, 0.3);
}

.pill-amber {
  background: rgba(247, 200, 115, 0.14);
  color: var(--amber);
  border: 1px solid rgba(247, 200, 115, 0.3);
}

.pill-red {
  background: rgba(255, 127, 120, 0.14);
  color: var(--red);
  border: 1px solid rgba(255, 127, 120, 0.3);
}

/* ASCII / Diagram Cards */
.diagram-card {
  margin: 24px 0 32px;
  padding: 20px;
  border: 1px solid var(--line-strong);
  background: #071520;
  border-radius: 3px;
  box-shadow: inset 0 0 40px rgba(0, 0, 0, 0.4);
}

.diagram-card-title {
  display: flex;
  align-items: center;
  justify-content: space-between;
  margin-bottom: 14px;
  color: var(--muted-2);
  font: 9px var(--mono);
  letter-spacing: 0.12em;
  text-transform: uppercase;
}

.diagram-card-title span {
  display: flex;
  align-items: center;
  gap: 6px;
  color: var(--signal);
}

.diagram-card pre {
  margin: 0;
  color: var(--paper-2);
  font: 11px/1.5 var(--mono);
  overflow-x: auto;
}

/* Right TOC / "On this page" */
.docs-toc {
  position: sticky;
  top: 96px;
  height: calc(100vh - 120px);
  overflow-y: auto;
  padding-left: 20px;
  border-left: 1px solid var(--line);
}

.docs-toc-title {
  margin: 0 0 14px;
  color: var(--muted-2);
  font: 9px var(--mono);
  letter-spacing: 0.14em;
  text-transform: uppercase;
}

.docs-toc-list {
  list-style: none;
  margin: 0;
  padding: 0;
  display: flex;
  flex-direction: column;
  gap: 8px;
}

.docs-toc-list a {
  display: block;
  color: var(--muted);
  font-size: 11px;
  line-height: 1.4;
  padding: 4px 0 4px 10px;
  border-left: 2px solid transparent;
  transition: all 0.22s cubic-bezier(0.2, 0.8, 0.2, 1);
}

.docs-toc-list a:hover {
  color: var(--signal);
  transform: translateX(3px);
}

.docs-toc-list a.is-active {
  color: var(--signal);
  font-weight: 600;
  border-left-color: var(--signal);
  transform: translateX(4px);
  text-shadow: 0 0 12px rgba(var(--signal-rgb), 0.35);
}

.docs-toc-actions {
  margin-top: 36px;
  padding-top: 20px;
  border-top: 1px solid var(--line);
  display: flex;
  flex-direction: column;
  gap: 10px;
}

.docs-toc-btn {
  display: flex;
  align-items: center;
  gap: 8px;
  padding: 8px 10px;
  background: rgba(13, 27, 38, 0.6);
  border: 1px solid var(--line);
  border-radius: 2px;
  color: var(--paper-2);
  font: 10px var(--mono);
  transition: all 0.2s;
}

.docs-toc-btn:hover {
  color: var(--signal);
  border-color: var(--signal);
  background: rgba(18, 38, 52, 0.9);
}

/* Mobile Drawer Overlay */
.docs-mobile-drawer {
  display: none;
}

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

@media (max-width: 900px) {
  .docs-header-inner {
    width: calc(100% - 32px);
  }
  .docs-container {
    grid-template-columns: 1fr;
    width: calc(100% - 32px);
    padding-top: 20px;
  }
  .docs-sidebar {
    display: none;
  }
  .docs-mobile-toggle {
    display: flex !important;
  }
  .docs-mobile-drawer.is-open {
    display: block;
    position: fixed;
    inset: 0;
    z-index: 100;
    background: rgba(6, 11, 17, 0.95);
    backdrop-filter: blur(20px);
    padding: 24px;
    overflow-y: auto;
  }
  .docs-mobile-drawer-header {
    display: flex;
    align-items: center;
    justify-content: space-between;
    margin-bottom: 24px;
    padding-bottom: 16px;
    border-bottom: 1px solid var(--line);
  }
  .docs-search-bar {
    width: 200px;
  }
}

@media (max-width: 640px) {
  .docs-header .header-live.beta-badge {
    display: none;
  }
  .docs-search-bar {
    display: none;
  }
  .docs-breadcrumb {
    display: none;
  }
  .docs-hero h1 {
    font-size: 32px;
  }
  .docs-section h2 {
    font-size: 24px;
  }
  .code-block pre,
  .code-tab-pane pre {
    font-size: 10px;
    padding: 14px 12px;
  }
}