/* ==========================================================================
   Digital Specialist — Shared Stylesheet
   M3 Blue Theme · Light Mode
   ========================================================================== */

/* --------------------------------------------------------------------------
   1. CSS Variables — Color, Typography & Layout Tokens
   -------------------------------------------------------------------------- */

:root {
  /* Primary */
  --md-primary: #1565C0;
  --md-on-primary: #FFFFFF;
  --md-primary-container: #D4E3FF;
  --md-on-primary-container: #001C3A;

  /* Surface */
  --md-surface: #FFFFFF;
  --md-on-surface: #1B1B1F;
  --md-on-surface-variant: #44474E;
  --md-surface-container-low: #F3F3F6;
  --md-surface-container: #EEEEF1;
  --md-surface-container-high: #E8E8EB;

  /* Outline */
  --md-outline: #74777F;
  --md-outline-variant: #C4C6CF;

  /* Error */
  --md-error: #BA1A1A;
  --md-error-container: #FFDAD6;

  /* Tertiary — tips / success */
  --md-tertiary: #006D3B;
  --md-tertiary-container: #98F7B5;

  /* Warning (custom) */
  --md-warning: #7D5800;
  --md-warning-container: #FFDEA6;

  /* Typography */
  --md-font-family: 'Roboto', system-ui, -apple-system, sans-serif;
  --md-font-mono: 'JetBrains Mono', 'Fira Code', 'Consolas', monospace;

  /* Layout */
  --md-content-max-width: 860px;
  --md-content-padding: 24px;
  --md-border-radius-sm: 8px;
  --md-border-radius-md: 12px;
  --md-border-radius-lg: 16px;
}

/* --------------------------------------------------------------------------
   2. Reset & Base
   -------------------------------------------------------------------------- */

*, *::before, *::after {
  box-sizing: border-box;
}

body {
  font-family: var(--md-font-family);
  font-size: 16px;
  font-weight: 400;
  line-height: 1.7;
  margin: 0;
  padding: 0;
  background-color: var(--md-surface);
  color: var(--md-on-surface);
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
}

a {
  color: var(--md-primary);
  text-decoration: none;
  transition: color 0.15s ease;
}

a:hover {
  text-decoration: underline;
}

a:focus-visible {
  outline: 2px solid var(--md-primary);
  outline-offset: 2px;
  border-radius: 2px;
}

img {
  max-width: 100%;
  height: auto;
}

/* --------------------------------------------------------------------------
   3. Typography
   -------------------------------------------------------------------------- */

h1, h2, h3, h4 {
  margin: 1.5em 0 0.5em;
  line-height: 1.3;
  color: var(--md-on-surface);
}

h1 {
  font-size: 32px;
  font-weight: 700;
  margin-top: 0;
}

h2 {
  font-size: 24px;
  font-weight: 600;
  padding-bottom: 6px;
  border-bottom: 2px solid var(--md-outline-variant);
}

h3 {
  font-size: 20px;
  font-weight: 600;
}

h4 {
  font-size: 17px;
  font-weight: 600;
  color: var(--md-on-surface-variant);
}

p {
  margin: 0 0 1em;
}

ul, ol {
  margin: 0 0 1em;
  padding-left: 1.5em;
}

li {
  margin-bottom: 0.35em;
}

li > ul, li > ol {
  margin-top: 0.35em;
  margin-bottom: 0;
}

strong {
  font-weight: 600;
}

.subtitle {
  font-size: 17px;
  color: var(--md-on-surface-variant);
  margin-top: -0.25em;
  margin-bottom: 1.5em;
}

/* --------------------------------------------------------------------------
   4. Layout
   -------------------------------------------------------------------------- */

.page-container {
  max-width: var(--md-content-max-width);
  margin: 0 auto;
  padding: var(--md-content-padding);
}

.page-header {
  margin-bottom: 2em;
}

.page-header h1 {
  margin-bottom: 0.15em;
}

/* --------------------------------------------------------------------------
   5. Table of Contents
   -------------------------------------------------------------------------- */

.toc {
  background-color: var(--md-primary-container);
  border-radius: var(--md-border-radius-md);
  padding: 20px 24px;
  margin-bottom: 2.5em;
}

.toc-category {
  font-weight: 700;
  font-size: 15px;
  color: var(--md-on-primary-container);
  margin: 1em 0 0.35em;
}

.toc-category:first-child {
  margin-top: 0;
}

.toc-links {
  list-style: none;
  padding-left: 0.5em;
  margin: 0 0 0.25em;
}

.toc-links li {
  margin-bottom: 0.25em;
}

.toc-links a {
  color: var(--md-on-primary-container);
  font-size: 15px;
}

.toc-links a:hover {
  color: var(--md-primary);
}

/* --------------------------------------------------------------------------
   6. Tables
   -------------------------------------------------------------------------- */

.subscriptions-table,
.roles-table {
  width: 100%;
  border-collapse: collapse;
  margin: 1.25em 0 1.5em;
  font-size: 15px;
  border: 1px solid var(--md-outline-variant);
  overflow: hidden;
}

.subscriptions-table th,
.roles-table th {
  background-color: var(--md-primary);
  color: var(--md-on-primary);
  font-weight: 600;
  padding: 10px 14px;
  text-align: left;
  white-space: nowrap;
}

.subscriptions-table td,
.roles-table td {
  padding: 10px 14px;
  border-bottom: 1px solid var(--md-outline-variant);
}

.subscriptions-table tr:nth-child(even),
.roles-table tr:nth-child(even) {
  background-color: var(--md-surface-container-low);
}

.subscriptions-table tr:last-child td,
.roles-table tr:last-child td {
  border-bottom: none;
}

/* Wrapper for horizontal scroll on narrow screens */
.table-wrapper {
  overflow-x: auto;
  -webkit-overflow-scrolling: touch;
  margin: 1.25em 0 1.5em;
}

.table-wrapper .subscriptions-table,
.table-wrapper .roles-table {
  margin: 0;
}

/* --------------------------------------------------------------------------
   7. Code Blocks
   -------------------------------------------------------------------------- */

code {
  font-family: var(--md-font-mono);
  font-size: 14px;
  background-color: var(--md-surface-container);
  color: var(--md-primary);
  padding: 2px 6px;
  border-radius: 4px;
}

pre {
  font-family: var(--md-font-mono);
  font-size: 14px;
  background-color: var(--md-surface-container);
  color: var(--md-on-surface);
  padding: 16px 20px;
  border-radius: var(--md-border-radius-sm);
  overflow-x: auto;
  line-height: 1.5;
  margin: 1em 0 1.5em;
  border: 1px solid var(--md-outline-variant);
}

pre code {
  background: none;
  color: inherit;
  padding: 0;
  border-radius: 0;
  font-size: inherit;
}

.code-block {
  display: block;
  white-space: pre;
}

/* --------------------------------------------------------------------------
   8. Callout Boxes
   -------------------------------------------------------------------------- */

.callout {
  padding: 14px 18px;
  border-radius: var(--md-border-radius-sm);
  border-left: 4px solid;
  margin: 1.25em 0;
  font-size: 15px;
  line-height: 1.6;
}

.callout strong {
  display: inline;
}

/* Tip — green */
.callout-tip {
  border-left-color: var(--md-tertiary);
  background-color: #d4f5df;
  color: #00210e;
}

/* Warning — amber */
.callout-warning {
  border-left-color: var(--md-warning);
  background-color: var(--md-warning-container);
  color: #281900;
}

/* Note — blue */
.callout-note {
  border-left-color: var(--md-primary);
  background-color: var(--md-primary-container);
  color: var(--md-on-primary-container);
}

/* --------------------------------------------------------------------------
   9. Navigation
   -------------------------------------------------------------------------- */

.back-to-top {
  text-align: right;
  margin: 1.5em 0 0.5em;
  font-size: 14px;
}

.back-to-top a {
  color: var(--md-on-surface-variant);
}

.back-to-top a:hover {
  color: var(--md-primary);
}

.breadcrumb {
  font-size: 14px;
  margin-bottom: 1.5em;
  color: var(--md-on-surface-variant);
}

.breadcrumb a {
  color: var(--md-primary);
}

.page-nav {
  display: flex;
  justify-content: space-between;
  align-items: center;
  padding-top: 1.5em;
  margin-top: 2em;
  border-top: 1px solid var(--md-outline-variant);
  font-size: 15px;
}

.page-nav a {
  color: var(--md-primary);
}

/* --------------------------------------------------------------------------
   10. Responsive
   -------------------------------------------------------------------------- */

@media (max-width: 768px) {
  .page-container {
    padding: 16px;
  }

  h1 {
    font-size: 26px;
  }

  h2 {
    font-size: 21px;
  }

  h3 {
    font-size: 18px;
  }

  .toc {
    padding: 16px 18px;
  }

  .subscriptions-table th,
  .subscriptions-table td,
  .roles-table th,
  .roles-table td {
    padding: 8px 10px;
    font-size: 14px;
  }
}

@media (max-width: 480px) {
  .page-container {
    padding: 12px;
  }

  h1 {
    font-size: 23px;
  }

  h2 {
    font-size: 19px;
  }

  pre {
    padding: 12px 14px;
    font-size: 13px;
  }

  .callout {
    padding: 12px 14px;
    font-size: 14px;
  }

  .table-wrapper {
    margin-left: -12px;
    margin-right: -12px;
    padding: 0 12px;
  }

  .page-nav {
    flex-direction: column;
    gap: 0.75em;
    text-align: center;
  }
}