/* ============================================================
   docs.css — Silicon Secure Documentation Styles
   Layered on top of main.css for all /docs/ pages
   ============================================================ */

/* ----------------------------------------------------------
   Docs Layout: Two-pane sidebar + content
   ---------------------------------------------------------- */

.docs-layout {
  display: grid;
  grid-template-columns: 260px 1fr;
  gap: 0;
  min-height: calc(100vh - var(--nav-height));
  max-width: var(--max-width);
  margin: 0 auto;
  padding: 0 var(--content-padding);
}

/* ----------------------------------------------------------
   Docs Sidebar
   ---------------------------------------------------------- */

.docs-sidebar {
  position: sticky;
  top: calc(var(--nav-height) + 1.5rem);
  height: calc(100vh - var(--nav-height) - 3rem);
  overflow-y: auto;
  padding: var(--space-6) 0 var(--space-8);
  border-right: 1px solid var(--color-border);
  scrollbar-width: thin;
  scrollbar-color: var(--color-border) transparent;
}

.docs-sidebar::-webkit-scrollbar { width: 4px; }
.docs-sidebar::-webkit-scrollbar-track { background: transparent; }
.docs-sidebar::-webkit-scrollbar-thumb {
  background: var(--color-border);
  border-radius: var(--radius-full);
}

.docs-sidebar-section {
  margin-bottom: var(--space-6);
}

.docs-sidebar-label {
  display: block;
  font-size: 0.6875rem;
  font-weight: 700;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--color-text-muted);
  padding: 0 var(--space-4);
  margin-bottom: var(--space-2);
}

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

.docs-sidebar-links li { margin: 0; }

.docs-sidebar-links a {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  padding: var(--space-2) var(--space-4);
  font-size: 0.875rem;
  color: var(--color-text-secondary);
  text-decoration: none;
  border-radius: var(--radius-sm);
  transition: background var(--transition-fast), color var(--transition-fast);
  margin: 1px 0;
}

.docs-sidebar-links a:hover {
  color: var(--color-text-primary);
  background: var(--color-surface-2);
}

.docs-sidebar-links a.active {
  color: var(--color-accent);
  background: rgba(50, 215, 75, 0.08);
  font-weight: 500;
  border-left: 2px solid var(--color-accent);
  padding-left: calc(var(--space-4) - 2px);
}

.docs-sidebar-links a .link-icon {
  font-size: 0.9em;
  flex-shrink: 0;
  opacity: 0.7;
}

/* ----------------------------------------------------------
   Docs Content Area
   ---------------------------------------------------------- */

.docs-content {
  padding: var(--space-8) var(--space-8) var(--space-24);
  max-width: 760px;
}

.docs-content h1 {
  font-size: clamp(1.75rem, 3vw, 2.25rem);
  font-weight: 700;
  line-height: var(--line-height-tight);
  margin-bottom: var(--space-4);
  color: var(--color-text-primary);
}

.docs-content h2 {
  font-size: clamp(1.25rem, 2vw, 1.5rem);
  font-weight: 700;
  margin-top: var(--space-12);
  margin-bottom: var(--space-4);
  padding-top: var(--space-8);
  border-top: 1px solid var(--color-border);
  color: var(--color-text-primary);
}

.docs-content h2:first-of-type {
  margin-top: var(--space-8);
  padding-top: 0;
  border-top: none;
}

.docs-content h3 {
  font-size: 1.0625rem;
  font-weight: 600;
  margin-top: var(--space-6);
  margin-bottom: var(--space-3);
  color: var(--color-text-primary);
}

.docs-content p {
  color: var(--color-text-secondary);
  line-height: var(--line-height-relaxed);
  margin-bottom: var(--space-4);
}

.docs-content ul,
.docs-content ol {
  color: var(--color-text-secondary);
  line-height: var(--line-height-relaxed);
  padding-left: var(--space-6);
  margin-bottom: var(--space-4);
}

.docs-content li { margin-bottom: var(--space-2); }

.docs-content a {
  color: var(--color-accent);
  text-decoration: underline;
  text-decoration-color: transparent;
  transition: text-decoration-color var(--transition-fast);
}

.docs-content a:hover { text-decoration-color: var(--color-accent); }

/* ----------------------------------------------------------
   Docs Page Header
   ---------------------------------------------------------- */

.docs-page-header {
  margin-bottom: var(--space-8);
  padding-bottom: var(--space-6);
  border-bottom: 1px solid var(--color-border);
}

.docs-eyebrow {
  display: inline-flex;
  align-items: center;
  gap: var(--space-2);
  font-size: 0.75rem;
  font-weight: 600;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--color-accent);
  margin-bottom: var(--space-3);
}

.docs-page-intro {
  font-size: 1.0625rem;
  color: var(--color-text-secondary);
  line-height: var(--line-height-relaxed);
  margin-bottom: 0;
}

/* ----------------------------------------------------------
   Callout Boxes
   ---------------------------------------------------------- */

.callout {
  display: flex;
  gap: var(--space-4);
  padding: var(--space-4) var(--space-5);
  border-radius: var(--radius-md);
  border: 1px solid;
  margin: var(--space-6) 0;
}

.callout-icon {
  font-size: 1.125rem;
  flex-shrink: 0;
  margin-top: 1px;
}

.callout-body { flex: 1; }

.callout-title {
  font-size: 0.8125rem;
  font-weight: 700;
  letter-spacing: 0.04em;
  text-transform: uppercase;
  margin-bottom: var(--space-1);
}

.callout-body p {
  font-size: 0.9375rem;
  margin-bottom: 0;
  line-height: var(--line-height-relaxed);
}

/* Tip */
.callout--tip {
  background: rgba(50, 215, 75, 0.06);
  border-color: rgba(50, 215, 75, 0.25);
}
.callout--tip .callout-title { color: var(--color-success); }
.callout--tip .callout-body p { color: var(--color-text-secondary); }

/* Note */
.callout--note {
  background: rgba(10, 132, 255, 0.06);
  border-color: rgba(10, 132, 255, 0.25);
}
.callout--note .callout-title { color: var(--color-info); }
.callout--note .callout-body p { color: var(--color-text-secondary); }

/* Warning */
.callout--warning {
  background: rgba(255, 159, 10, 0.06);
  border-color: rgba(255, 159, 10, 0.25);
}
.callout--warning .callout-title { color: var(--color-warning); }
.callout--warning .callout-body p { color: var(--color-text-secondary); }

/* Important */
.callout--important {
  background: rgba(255, 69, 58, 0.06);
  border-color: rgba(255, 69, 58, 0.25);
}
.callout--important .callout-title { color: var(--color-error); }
.callout--important .callout-body p { color: var(--color-text-secondary); }

/* ----------------------------------------------------------
   Step-by-Step Procedures
   ---------------------------------------------------------- */

.steps {
  list-style: none;
  padding: 0;
  margin: var(--space-6) 0;
  counter-reset: steps-counter;
}

.steps li {
  display: flex;
  gap: var(--space-4);
  padding: var(--space-4) 0 var(--space-4) 0;
  border-bottom: 1px solid var(--color-border);
  counter-increment: steps-counter;
  margin-bottom: 0;
}

.steps li:last-child { border-bottom: none; }

.steps li::before {
  content: counter(steps-counter);
  flex-shrink: 0;
  width: 28px;
  height: 28px;
  background: var(--color-accent);
  color: #000;
  font-size: 0.8125rem;
  font-weight: 700;
  border-radius: var(--radius-full);
  display: flex;
  align-items: center;
  justify-content: center;
  margin-top: 1px;
}

.steps li .step-content { flex: 1; }

.steps li .step-title {
  font-size: 0.9375rem;
  font-weight: 600;
  color: var(--color-text-primary);
  margin-bottom: var(--space-2);
}

.steps li p {
  font-size: 0.9rem;
  margin-bottom: var(--space-2);
  color: var(--color-text-secondary);
}

.steps li p:last-child { margin-bottom: 0; }

/* ----------------------------------------------------------
   Keyboard Shortcuts
   ---------------------------------------------------------- */

kbd {
  display: inline-flex;
  align-items: center;
  gap: 3px;
  padding: 2px 7px;
  font-family: var(--font-mono);
  font-size: 0.75rem;
  font-weight: 500;
  background: var(--color-surface-2);
  border: 1px solid var(--color-border);
  border-bottom-width: 2px;
  border-radius: 5px;
  color: var(--color-text-primary);
  white-space: nowrap;
}

.kbd-group {
  display: inline-flex;
  align-items: center;
  gap: var(--space-1);
}

/* ----------------------------------------------------------
   Shortcut Table
   ---------------------------------------------------------- */

.shortcuts-table {
  width: 100%;
  border-collapse: collapse;
  margin: var(--space-4) 0 var(--space-6);
  font-size: 0.9rem;
}

.shortcuts-table th {
  text-align: left;
  font-size: 0.75rem;
  font-weight: 600;
  letter-spacing: 0.05em;
  text-transform: uppercase;
  color: var(--color-text-muted);
  padding: var(--space-2) var(--space-4) var(--space-2) 0;
  border-bottom: 1px solid var(--color-border);
}

.shortcuts-table td {
  padding: var(--space-3) var(--space-4) var(--space-3) 0;
  border-bottom: 1px solid var(--color-border);
  vertical-align: middle;
  color: var(--color-text-secondary);
}

.shortcuts-table td:last-child {
  text-align: right;
  padding-right: 0;
}

.shortcuts-table tr:last-child td { border-bottom: none; }

/* ----------------------------------------------------------
   Feature Overview Cards (used on docs index)
   ---------------------------------------------------------- */

.docs-cards {
  display: grid;
  grid-template-columns: repeat(2, 1fr);
  gap: var(--space-4);
  margin: var(--space-6) 0;
}

.docs-card {
  display: flex;
  flex-direction: column;
  padding: var(--space-5);
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  text-decoration: none;
  transition: background var(--transition-normal), border-color var(--transition-normal), transform var(--transition-normal), box-shadow var(--transition-normal);
}

.docs-card:hover {
  background: var(--color-surface-2);
  border-color: rgba(50, 215, 75, 0.3);
  transform: translateY(-2px);
  box-shadow: var(--shadow-md);
  text-decoration: none;
}

.docs-card-icon {
  font-size: 1.5rem;
  margin-bottom: var(--space-3);
}

.docs-card-title {
  font-size: 0.9375rem;
  font-weight: 600;
  color: var(--color-text-primary);
  margin-bottom: var(--space-1);
}

.docs-card-desc {
  font-size: 0.8125rem;
  color: var(--color-text-secondary);
  line-height: var(--line-height-relaxed);
  margin-bottom: 0;
  flex: 1;
}

.docs-card-arrow {
  margin-top: var(--space-3);
  font-size: 0.8125rem;
  color: var(--color-accent);
  font-weight: 500;
}

/* ----------------------------------------------------------
   Inline code
   ---------------------------------------------------------- */

.docs-content code {
  font-family: var(--font-mono);
  font-size: 0.8125rem;
  background: var(--color-surface-2);
  border: 1px solid var(--color-border);
  border-radius: 4px;
  padding: 1px 6px;
  color: var(--color-text-primary);
}

/* ----------------------------------------------------------
   Breadcrumb
   ---------------------------------------------------------- */

.docs-breadcrumb {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  font-size: 0.8125rem;
  font-family: var(--font-mono);
  color: var(--color-text-muted);
  margin-bottom: var(--space-4);
}

.docs-breadcrumb a {
  color: var(--color-text-secondary);
  text-decoration: none;
}

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

.docs-breadcrumb-sep { color: var(--color-text-muted); }

/* ----------------------------------------------------------
   On-this-page nav (right column anchor links)
   ---------------------------------------------------------- */

.docs-toc {
  position: sticky;
  top: calc(var(--nav-height) + 1.5rem);
  align-self: start;
  padding: var(--space-6) var(--space-6);
  font-size: 0.8125rem;
}

.docs-toc-label {
  font-size: 0.6875rem;
  font-weight: 700;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--color-text-muted);
  margin-bottom: var(--space-3);
}

.docs-toc-links {
  list-style: none;
  padding: 0;
  margin: 0;
}

.docs-toc-links li { margin-bottom: var(--space-2); }

.docs-toc-links a {
  color: var(--color-text-secondary);
  text-decoration: none;
  transition: color var(--transition-fast);
}

.docs-toc-links a:hover { color: var(--color-accent); }

/* ----------------------------------------------------------
   Mobile: docs sidebar becomes a scrollable top nav
   ---------------------------------------------------------- */

.docs-mobile-nav {
  display: none;
  overflow-x: auto;
  gap: var(--space-2);
  padding: var(--space-3) 0;
  border-bottom: 1px solid var(--color-border);
  margin-bottom: var(--space-6);
  scrollbar-width: none;
}

.docs-mobile-nav::-webkit-scrollbar { display: none; }

.docs-mobile-nav a {
  display: inline-flex;
  align-items: center;
  gap: var(--space-1);
  white-space: nowrap;
  padding: var(--space-2) var(--space-3);
  font-size: 0.8125rem;
  font-weight: 500;
  color: var(--color-text-secondary);
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-full);
  text-decoration: none;
  flex-shrink: 0;
  transition: background var(--transition-fast), color var(--transition-fast), border-color var(--transition-fast);
}

.docs-mobile-nav a:hover,
.docs-mobile-nav a.active {
  color: var(--color-accent);
  border-color: rgba(50, 215, 75, 0.4);
  background: rgba(50, 215, 75, 0.06);
}

/* ----------------------------------------------------------
   Responsive
   ---------------------------------------------------------- */

@media (max-width: 1023px) {
  .docs-layout {
    grid-template-columns: 1fr;
    padding: 0;
  }

  .docs-sidebar { display: none; }

  .docs-mobile-nav { display: flex; }

  .docs-content {
    padding: 0 var(--content-padding) var(--space-16);
    max-width: 100%;
  }
}

@media (max-width: 640px) {
  .docs-cards {
    grid-template-columns: 1fr;
  }
}