/* ==========================================================================
   0) FOUNDATIONS
   - Typography, rhythm, utility tokens, base elements
   ========================================================================== */

:root {
  /* Optional: gentle defaults if not already defined upstream */
  --radius-xs: 0.25rem;
  --radius-sm: 0.375rem;
  --radius-md: 0.5rem;
  --radius-lg: 0.75rem;
  --radius-xl: 1rem;

  --shadow-xs: 0 1px 2px rgba(0,0,0,0.06);
  --shadow-sm: 0 2px 8px rgba(0,0,0,0.06);
  --shadow-md: 0 6px 18px rgba(0,0,0,0.10);
  --shadow-lg: 0 12px 30px rgba(0,0,0,0.16);

  --ease-quick: 0.2s ease;
}

/* Base text container for articles */
:where(.markdown-content) {
  max-width: 70ch;
  margin: 0 auto;
  font-size: 1.125rem;
  line-height: 1.8;
  color: var(--color-text);
}

:where(.markdown-content) * {
  scroll-margin-top: 100px;
}

/* ==========================================================================
   1) HEADINGS & TEXT
   ========================================================================== */

:where(.markdown-content) h1,
:where(.markdown-content) h2,
:where(.markdown-content) h3,
:where(.markdown-content) h4,
:where(.markdown-content) h5,
:where(.markdown-content) h6 {
  font-weight: 700;
  line-height: 1.25;
  color: var(--color-text);
  margin: 0;
}

:where(.markdown-content) h1 {
  font-size: 2.5rem;
  margin: 3rem 0 1.5rem 0;
  border-bottom: 3px solid var(--color-primary);
  padding-bottom: 0.5rem;
}

:where(.markdown-content) h2 {
  font-size: 2rem;
  margin: 2.5rem 0 1rem 0;
  border-bottom: 2px solid var(--color-border);
  padding-bottom: 0.375rem;
}

:where(.markdown-content) h3 {
  font-size: 1.5rem;
  margin: 2rem 0 0.75rem 0;
  color: var(--color-primary);
}

:where(.markdown-content) h4 {
  font-size: 1.25rem;
  margin: 1.5rem 0 0.5rem 0;
}

:where(.markdown-content) h5,
:where(.markdown-content) h6 {
  font-size: 1.125rem;
  margin: 1rem 0 0.5rem 0;
  font-weight: 600;
}

:where(.markdown-content) p {
  margin: 0 0 1.5rem 0;
  text-align: justify;
  hyphens: auto;
}

:where(.markdown-content) strong { font-weight: 700; color: var(--color-text); }
:where(.markdown-content) em { font-style: italic; color: var(--color-text-secondary); }

/* Links with refined hover state */
:where(.markdown-content) a {
  color: var(--color-primary);
  text-decoration: underline;
  text-decoration-color: transparent;
  transition: var(--ease-quick);
}
:where(.markdown-content) a:hover {
  text-decoration-color: var(--color-primary);
  background-color: var(--color-bg-secondary);
  padding: 0.125rem 0.25rem;
  border-radius: var(--radius-xs);
}
/* External link indicator */
:where(.markdown-content) a[href^="http"]:not([href*="localhost"]):not([href*="127.0.0.1"])::after {
  content: " ↗";
  font-size: 0.875rem;
  color: var(--color-text-secondary);
}

/* ==========================================================================
   2) LISTS, DEFINITIONS, TABLES, QUOTES
   ========================================================================== */

:where(.markdown-content) ul,
:where(.markdown-content) ol {
  margin: 1.5rem 0;
  padding-left: 2rem;
}

:where(.markdown-content) li {
  margin-bottom: 0.75rem;
  line-height: 1.2;
}
:where(.markdown-content) li > ul,
:where(.markdown-content) li > ol {
  margin: 0.5rem 0;
}

:where(.markdown-content) dl { margin: 1.5rem 0; }
:where(.markdown-content) dt {
  font-weight: 700;
  margin: 1rem 0 0.5rem 0;
  color: var(--color-primary);
}
:where(.markdown-content) dd {
  margin-left: 1.5rem;
  margin-bottom: 0.75rem;
  padding-left: 1rem;
  border-left: 2px solid var(--color-border);
}

:where(.markdown-content) table {
  width: 100%;
  border-collapse: collapse;
  margin: 1.5rem 0;
  background-color: var(--color-bg);
  border-radius: var(--radius-md);
  overflow: hidden;
  border: 1px solid var(--color-border);
}
:where(.markdown-content) th,
:where(.markdown-content) td {
  padding: 0.75rem;
  text-align: left;
  border-bottom: 1px solid var(--color-border);
}
:where(.markdown-content) th {
  background-color: var(--color-bg-secondary);
  font-weight: 600;
}

:where(.markdown-content) blockquote {
  border-left: 4px solid var(--color-primary);
  background-color: var(--color-bg-secondary);
  padding: 1rem 1.5rem;
  margin: 1.5rem 0;
  border-radius: 0 var(--radius-md) var(--radius-md) 0;
}

:where(.markdown-content) hr {
  border: none;
  border-top: 1px solid var(--color-border);
  margin: 2rem 0;
}

/* ==========================================================================
   3) CODE & INLINE CODE
   ========================================================================== */

:where(.markdown-content) pre {
  background-color: var(--color-bg-tertiary);
  border: 1px solid var(--color-border);
  border-radius: 0.75rem;
  padding: 1.5rem;
  margin: 2rem 0;
  overflow-x: auto;
  font-size: 0.875rem;
  line-height: 1.6;
  position: relative;
  box-shadow: var(--shadow-sm);
  padding-left: 1.5rem;
}

:where(.markdown-content) pre::before {
  content: attr(data-language);
  position: absolute;
  top: 0.5rem;
  left: 0.75rem;
  right: auto;
  z-index: 1;
  display: inline-block;
  padding: 0.15rem 0.5rem;
  border-radius: var(--radius-sm);
  background: var(--color-bg);
  border: 1px solid var(--color-border);
  color: var(--color-text-secondary);
  text-transform: uppercase;
  font-weight: 600;
  letter-spacing: 0.05em;
  font-size: 0.75rem;
}

:where(.markdown-content) pre[data-language]::before {
  top: 0.5rem;
  left: 0.75rem;
  position: absolute;
  z-index: 1;
  display: inline-block;
  padding: 0.15rem 0.5rem;
  border-radius: var(--radius-sm);
  background: var(--color-bg);
  border: 1px solid var(--color-border);
  color: var(--color-text-secondary);
  line-height: 1;
}

:where(.markdown-content) code:not(pre code) {
  background-color: var(--color-bg-secondary);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-sm);
  padding: 0.25rem 0.5rem;
  font-size: 0.875rem;
  font-family: 'SF Mono','Monaco','Menlo','Consolas',monospace;
  color: var(--color-text);
}

/* Language badges (keep if your renderer sets data-language) */
:where(.markdown-content) pre[data-language="bash"]::before { content: "BASH"; color: #4EAA25; }
:where(.markdown-content) pre[data-language="javascript"]::before { content: "JS"; color: #F7DF1E; }
:where(.markdown-content) pre[data-language="python"]::before { content: "PYTHON"; color: #3776AB; }
:where(.markdown-content) pre[data-language="sql"]::before { content: "SQL"; color: #336791; }
:where(.markdown-content) pre[data-language="yaml"]::before { content: "YAML"; color: #CB171E; }
:where(.markdown-content) pre[data-language="json"]::before { content: "JSON"; color: #000000; }

/* Keyboard UI hints */
:where(.markdown-content) kbd {
  background-color: var(--color-bg-tertiary);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-xs);
  padding: 0.125rem 0.375rem;
  font-size: 0.75rem;
  font-family: monospace;
  box-shadow: var(--shadow-xs);
  margin: 0 0.125rem;
}

:where(.markdown-content) .copy-btn {
  position: absolute;
  top: 0.5rem; right: 0.5rem;
  display: inline-flex; align-items: center; gap: 0.4rem;
  padding: 0.35rem 0.6rem;
  border: 1px solid var(--color-border);
  background: var(--color-bg);
  border-radius: var(--radius-sm);
  font-size: 0.75rem;
  cursor: pointer;
  box-shadow: var(--shadow-sm);
  line-height: 1;
  z-index: 2;
  transition: var(--transition-fast);
  color: var(--color-text);
}

:where(.markdown-content) .copy-btn:hover {
  background: var(--color-bg-secondary);
}
:where(.markdown-content) .copy-btn:focus-visible {
  outline: 2px solid color-mix(in srgb, var(--color-primary) 60%, transparent);
  outline-offset: 2px;
}

:where(.markdown-content) .copy-btn svg {
  width: 14px; height: 14px;
}

[data-theme="dark"] :where(.markdown-content) .copy-btn {
  background: var(--color-bg-secondary);
  border-color: color-mix(in srgb, var(--color-border) 80%, transparent);
  box-shadow: 0 0 0 1px color-mix(in srgb, var(--color-bg-tertiary) 40%, transparent), var(--shadow-sm);
}

:where(.markdown-content) pre .copied-pill {
  position: absolute;
  top: 0.5rem; right: 0.5rem;
  padding: 0.35rem 0.6rem;
  border-radius: var(--radius-sm);
  font-size: 0.75rem;
  font-weight: 600;
  background: var(--color-primary);
  color: #fff;
  opacity: 0; transform: translateY(-6px) scale(0.98);
  pointer-events: none;
  z-index: 2;
}


/* Success state driven by [data-copied="true"] on <pre> */
:where(.markdown-content) pre[data-copied="true"] {
  box-shadow: 0 0 0 2px color-mix(in srgb, var(--color-primary) 30%, transparent) inset, var(--shadow-sm);
}
:where(.markdown-content) pre[data-copied="true"] .copy-btn { opacity: 0; }
:where(.markdown-content) pre[data-copied="true"] .copied-pill {
  opacity: 1; transform: translateY(0) scale(1);
}

/* Smooth but gentle motion */
@media (prefers-reduced-motion: no-preference) {
  :where(.markdown-content) pre,
  :where(.markdown-content) .copy-btn,
  :where(.markdown-content) pre .copied-pill {
    transition: 180ms ease;
  }
}



/* ==========================================================================
   4) CALLOUTS, STEPS, HIGHLIGHT BOX
   ========================================================================== */

:where(.markdown-content) .callout {
  border-left: 4px solid;
  border-radius: 0.5rem;
  margin: 2rem 0;
  padding: 1.25rem 1.5rem;
  background-color: var(--color-bg-secondary);
  border-color: var(--color-border);
  box-shadow: var(--shadow-sm);
}

:where(.markdown-content) .callout-header {
  display: flex;
  align-items: center;
  gap: 0.75rem;
  margin-bottom: 0.75rem;
  font-weight: 600;
  font-size: 0.9375rem;
}

:where(.markdown-content) .callout-icon {
  width: 1.25rem;
  height: 1.25rem;
  flex-shrink: 0;
}

/* Callout variants */
:where(.markdown-content) .callout-note {
  border-left-color: var(--color-primary);
  background-color: color-mix(in srgb, var(--color-primary) 8%, var(--color-bg-secondary));
}
:where(.markdown-content) .callout-note .callout-header { color: var(--color-primary); }

:where(.markdown-content) .callout-tip {
  border-left-color: var(--color-accent);
  background-color: color-mix(in srgb, var(--color-accent) 8%, var(--color-bg-secondary));
}
:where(.markdown-content) .callout-tip .callout-header { color: var(--color-accent); }

:where(.markdown-content) .callout-warning {
  border-left-color: var(--color-warning);
  background-color: color-mix(in srgb, var(--color-warning) 8%, var(--color-bg-secondary));
}
:where(.markdown-content) .callout-warning .callout-header { color: var(--color-warning); }

:where(.markdown-content) .callout-danger {
  border-left-color: var(--color-error);
  background-color: color-mix(in srgb, var(--color-error) 8%, var(--color-bg-secondary));
}
:where(.markdown-content) .callout-danger .callout-header { color: var(--color-error); }

/* Highlight feature box */
:where(.markdown-content) .highlight-box {
  background: linear-gradient(135deg, var(--color-accent) 0%, var(--color-primary) 100%);
  color: white;
  padding: 2rem;
  border-radius: 1rem;
  margin: 2rem 0;
  text-align: center;
  box-shadow: var(--shadow-md);
}
:where(.markdown-content) .highlight-box h3 { margin: 0; color: white; }

/* Steps */
:where(.markdown-content) .steps { counter-reset: step-counter; margin: 2rem 0; }
:where(.markdown-content) .step {
  counter-increment: step-counter;
  margin: 1.25rem 0;
  padding: 1.25rem 1.5rem;
  background-color: var(--color-bg-secondary);
  border-radius: 0.75rem;
  border-left: 4px solid var(--color-primary);
  position: relative;
}
:where(.markdown-content) .step::before {
  content: counter(step-counter);
  position: absolute;
  left: -0.75rem;
  top: 1rem;
  background-color: var(--color-primary);
  color: white;
  width: 1.5rem;
  height: 1.5rem;
  border-radius: 50%;
  display: grid;
  place-items: center;
  font-weight: 700;
  font-size: 0.875rem;
}
:where(.markdown-content) .step h4 { margin-top: 0; color: var(--color-primary); }

/* ==========================================================================
   5) ARTICLE LAYOUT (Header, Meta, Sidebar, Footer)
   ========================================================================== */

.article-layout {
  max-width: 1400px;
  margin: 0 auto;
  padding: 0 1rem;
}

/* Header */
.article-header {
  background: linear-gradient(135deg, var(--color-bg-secondary) 0%, var(--color-bg-tertiary) 100%);
  border: 1px solid var(--color-border);
  border-radius: 1rem;
  margin-bottom: 2rem;
  overflow: hidden;
}
.article-header-content { padding: 2rem; }

.breadcrumb {
  display: flex;
  align-items: center;
  gap: 0.5rem;
  margin-bottom: 1rem;
  font-size: 0.875rem;
}
.breadcrumb-link {
  color: var(--color-primary);
  text-decoration: none;
  transition: var(--ease-quick);
}
.breadcrumb-link:hover { text-decoration: underline; }
.breadcrumb-separator { color: var(--color-text-secondary); }
.breadcrumb-current { color: var(--color-text-secondary); font-weight: 500; }

.article-tags {
  display: flex;
  flex-wrap: wrap;
  gap: 0.5rem;
  margin-bottom: 1.5rem;
}
.article-tag {
  padding: 0.25rem 0.75rem;
  background-color: var(--color-bg);
  border: 1px solid var(--color-border);
  border-radius: 1rem;
  font-size: 0.75rem;
  font-weight: 500;
  color: var(--color-text-secondary);
}
.article-tag-category {
  background-color: var(--color-primary);
  color: white;
  border-color: var(--color-primary);
}

.article-title-section { margin-bottom: 2rem; }
.article-title {
  font-size: 2.5rem;
  font-weight: 700;
  margin: 0 0 1rem 0;
  color: var(--color-primary);
  line-height: 1.2;
}
.article-icon { margin-right: 1rem; font-size: 2rem; }
.article-description { font-size: 1.25rem; color: var(--color-text-secondary); margin: 0; line-height: 1.5; }

.article-metadata-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
  gap: 1.5rem;
  margin-bottom: 2rem;
  padding: 1.5rem;
  background-color: var(--color-bg);
  border-radius: 0.75rem;
  border: 1px solid var(--color-border);
}
.metadata-item { display: flex; flex-direction: column; gap: 0.5rem; }
.metadata-label {
  font-size: 0.75rem; font-weight: 600; text-transform: uppercase;
  letter-spacing: 0.05em; color: var(--color-text-secondary);
}
.metadata-value { font-size: 0.9375rem; font-weight: 500; color: var(--color-text); }
.metadata-badges { display: flex; flex-wrap: wrap; gap: 0.5rem; }

.article-actions { display: flex; gap: 1rem; justify-content: center; }

/* Content wrapper with sidebar */
.article-content-wrapper {
  display: grid;
  grid-template-columns: var(--main-grid-columns, 280px 1fr);
  gap: 3rem;
  align-items: start;
}
.article-sidebar {
  position: sticky;
  top: 0.1rem;
  max-height: 100vh;
  overflow-y: auto;
}

/* Sidebar TOC */
.sidebar-toc {
  background-color: var(--color-bg-secondary);
  border: 1px solid var(--color-border);
  border-radius: 0.75rem;
  padding: 1.5rem;
}
.toc-title {
  margin: 0 0 1rem 0;
  font-size: 1rem;
  font-weight: 600;
  color: var(--color-primary);
}
.toc-navigation { display: flex; flex-direction: column; gap: 0.25rem; }
.toc-item {
  display: block;
  padding: 0.5rem 0.75rem;
  color: var(--color-text);
  text-decoration: none;
  border-radius: var(--radius-sm);
  font-size: 0.875rem;
  line-height: 1.4;
  transition: var(--ease-quick);
  border-left: 3px solid transparent;
}
.toc-item:hover {
  background-color: var(--color-bg-tertiary);
  color: var(--color-primary);
  border-left-color: var(--color-primary);
}
.toc-item.active {
  background-color: var(--color-primary);
  color: white;
  border-left-color: var(--color-accent);
}

/* Indentation by level (JS sets .toc-level-X) */
.toc-level-1 { padding-left: 0.75rem; font-weight: 600; }
.toc-level-2 { padding-left: 1rem; font-weight: 500; }
.toc-level-3 { padding-left: 1.5rem; }
.toc-level-4 { padding-left: 2rem; font-size: 0.8125rem; }
.toc-level-5 { padding-left: 2.5rem; font-size: 0.8125rem; opacity: 0.85; }
.toc-level-6 { padding-left: 3rem; font-size: 0.8125rem; opacity: 0.8; }

/* Main article column */
.article-main { 
  min-width: 0; 
  max-width: 95ch;
  background-color: var(--color-bg);
  border: 1px solid var(--color-border);
  border-radius: 1rem;
  overflow: hidden;
  box-shadow: var(--shadow-sm);
}

.article-content { 
  padding: 2.5rem;
  margin-bottom: 0;
  background: linear-gradient(135deg, var(--color-bg) 0%, var(--color-bg-secondary) 100%);
}
.article-footer {
  background-color: var(--color-bg-secondary);
  border-top: 1px solid var(--color-border);
  padding: 2rem 2.5rem;
  margin-top: 0;
}
.article-footer h3 { 
  margin: 0 0 1.5rem 0; 
  color: var(--color-primary);
  font-size: 1.25rem;
  font-weight: 600;
}
.footer-actions-grid { 
  display: flex; 
  flex-wrap: wrap; 
  gap: 1rem; 
  margin-bottom: 2rem;
}
.footer-actions-grid .btn { 
  flex: 1; 
  min-width: 200px;
  justify-content: center;
}
/* Tool button variants (keep since template uses them) */
.btn-concept { background-color: var(--color-concept); color: white; border-color: var(--color-concept); }
.btn-concept:hover { opacity: 0.9; }
.btn-method { background-color: var(--color-method); color: white; border-color: var(--color-method); }
.btn-method:hover { opacity: 0.9; }

.related-tools { margin-top: 2rem; padding-top: 2rem; border-top: 1px solid var(--color-border); }
.related-tools h3 { margin: 0 0 1rem 0; color: var(--color-text); }
.related-tools-grid {
  display: grid; grid-template-columns: repeat(auto-fill, minmax(200px, 1fr)); gap: 1rem;
}
.related-tool-card {
  display: flex; align-items: center; gap: 0.75rem; padding: 1rem;
  background-color: var(--color-bg-secondary); border: 1px solid var(--color-border);
  border-radius: 0.5rem; color: var(--color-text); text-decoration: none;
  transition: var(--ease-quick);
}
.related-tool-card:hover {
  background-color: var(--color-bg-tertiary); border-color: var(--color-primary);
  transform: translateY(-1px); box-shadow: var(--shadow-sm);
}
.tool-icon { font-size: 1.25rem; flex-shrink: 0; }
.tool-name { font-weight: 500; font-size: 0.9375rem; }

/* ==========================================================================
   6) RESPONSIVE
   ========================================================================== */

@media (max-width: 1200px) {
  .article-content-wrapper { grid-template-columns: 240px 1fr; gap: 2rem; }
}

@media (max-width: 1024px) {
  .article-content-wrapper { grid-template-columns: 1fr; gap: 0; }
  .article-sidebar { position: static; max-height: none; margin-bottom: 2rem; }
  .sidebar-toc { max-width: 500px; margin: 0 auto; }
  .article-main { max-width: 100%; }
}

@media (max-width: 768px) {
  .article-layout { padding: 0 0.5rem; }
  .article-header-content { padding: 1.5rem; }
  .article-title { font-size: 2rem; }
  .article-description { font-size: 1.125rem; }
  .article-metadata-grid { grid-template-columns: 1fr; gap: 1rem; padding: 1rem; }
  .article-actions { flex-direction: column; }
  .footer-actions-grid { flex-direction: column; }
  .footer-actions-grid .btn { min-width: auto; }
  .article-content { padding: 1.5rem; }
  .article-footer { padding: 1.5rem; }
  .footer-actions-grid { flex-direction: column; }
  .footer-actions-grid .btn { min-width: auto; }

  :where(.markdown-content) {
    font-size: 1rem;
    line-height: 1.65;
    max-width: 100%;
  }
  :where(.markdown-content) pre { padding: 1rem; margin: 1.5rem 0; font-size: 0.8125rem; }
  :where(.markdown-content) .callout { padding: 1rem; margin: 1.5rem 0; }
  :where(.markdown-content) .step { padding: 1rem; margin: 1rem 0; }
  :where(.markdown-content) .step::before { left: -0.5rem; top: 0.75rem; }
}

@media (max-width: 480px) {
  .article-title { font-size: 1.75rem; }
  .article-icon { font-size: 1.5rem; margin-right: 0.75rem; }
  .breadcrumb { font-size: 0.8125rem; }
}

/* ==========================================================================
   7) PRINT
   ========================================================================== */

@media print {
  /* Hide interactive chrome not used in print */
  .article-sidebar { display: none !important; }
  .article-actions,
  .article-footer .footer-actions-grid { display: none !important; }

  /* Expand content */
  .article-main { max-width: 100% !important; }
}