/* ============================================================
   EtqanShop — doc.css
   Documentation page styles for .docs-page class
   Handles typography, lists, images, and content elements
   ============================================================ */

/* ============================================================
   .docs-page — Base container
   ============================================================ */

.docs-page {
  color: var(--color-text);
  font-family: var(--font-primary);
  line-height: var(--lh-relaxed);
}

/* ============================================================
   Headings (h1 - h6)
   ============================================================ */

.docs-page h1,
.docs-page h2,
.docs-page h3,
.docs-page h4,
.docs-page h5,
.docs-page h6 {
  font-family: var(--font-display);
  font-weight: var(--fw-semibold);
  line-height: var(--lh-tight);
  color: var(--color-text);
  letter-spacing: var(--ls-snug);
  margin-top: var(--space-2xl);
  margin-bottom: var(--space-lg);
  scroll-margin-top: calc(var(--header-height) + var(--space-lg));
}

.docs-page h1 {
  font-size: var(--fs-3xl);
  font-weight: var(--fw-bold);
  margin-top: 0;
}

.docs-page h2 {
  font-size: var(--fs-2xl);
  font-weight: var(--fw-bold);
  border-bottom: 2px solid var(--color-gold-line);
  padding-bottom: var(--space-md);
}

.docs-page h3 {
  font-size: var(--fs-xl);
  font-weight: var(--fw-semibold);
}

.docs-page h4 {
  font-size: var(--fs-lg);
  font-weight: var(--fw-semibold);
}

.docs-page h5 {
  font-size: var(--fs-md);
  font-weight: var(--fw-semibold);
}

.docs-page h6 {
  font-size: var(--fs-base);
  font-weight: var(--fw-semibold);
  text-transform: uppercase;
  letter-spacing: var(--ls-wide);
  color: var(--color-text-muted);
}

/* ============================================================
   Paragraphs and text
   ============================================================ */

.docs-page p {
  margin-bottom: var(--space-lg);
  line-height: var(--lh-relaxed);
}

.docs-page p:last-child {
  margin-bottom: 0;
}

/* ============================================================
   Unordered Lists
   ============================================================ */

.docs-page ul {
  margin-bottom: var(--space-lg);
  padding-left: var(--space-2xl);
  list-style-type: disc;
}

.docs-page ul ul {
  margin-bottom: var(--space-md);
  margin-top: var(--space-md);
  list-style-type: circle;
}

.docs-page ul ul ul {
  list-style-type: square;
}

.docs-page ul li {
  margin-bottom: var(--space-md);
  line-height: var(--lh-relaxed);
}

.docs-page ul li:last-child {
  margin-bottom: 0;
}

/* ============================================================
   Ordered Lists
   ============================================================ */

.docs-page ol {
  margin-bottom: var(--space-lg);
  padding-left: var(--space-2xl);
  list-style-type: decimal;
}

.docs-page ol ol {
  margin-bottom: var(--space-md);
  margin-top: var(--space-md);
  list-style-type: lower-alpha;
}

.docs-page ol ol ol {
  list-style-type: lower-roman;
}

.docs-page ol li {
  margin-bottom: var(--space-md);
  line-height: var(--lh-relaxed);
}

.docs-page ol li:last-child {
  margin-bottom: 0;
}

/* ============================================================
   Description Lists
   ============================================================ */

.docs-page dl {
  margin-bottom: var(--space-lg);
}

.docs-page dt {
  font-weight: var(--fw-semibold);
  color: var(--color-purple);
  margin-top: var(--space-md);
  margin-bottom: var(--space-xs);
}

.docs-page dt:first-child {
  margin-top: 0;
}

.docs-page dd {
  margin-left: var(--space-lg);
  margin-bottom: var(--space-md);
  color: var(--color-text-soft);
}

/* ============================================================
   Links
   ============================================================ */

.docs-page a {
  color: var(--color-purple);
  text-decoration: underline;
  transition: color var(--transition-fast);
  font-weight: var(--fw-medium);
}

.docs-page a:hover,
.docs-page a:focus-visible {
  color: var(--color-purple-deep);
  outline: none;
}

.docs-page a:focus-visible {
  outline: 2px solid var(--color-gold);
  outline-offset: 2px;
  border-radius: var(--radius-xs);
}

/* ============================================================
   Code and Pre
   ============================================================ */

.docs-page code {
  font-family: var(--font-mono);
  font-size: 0.9em;
  background-color: var(--color-bg-alt);
  color: var(--color-purple);
  padding: var(--space-xs) var(--space-sm);
  border-radius: var(--radius-sm);
  border: 1px solid var(--color-border-soft);
  word-break: break-word;
}

.docs-page pre {
  background-color: #1e1e1e;
  color: #e0e0e0;
  padding: var(--space-lg);
  border-radius: var(--radius-lg);
  overflow-x: auto;
  margin-bottom: var(--space-lg);
  border: 1px solid var(--color-border);
}

.docs-page pre code {
  background: none;
  color: inherit;
  padding: 0;
  border: none;
  font-size: 0.9375rem;
  line-height: var(--lh-base);
}

/* ============================================================
   Blockquotes
   ============================================================ */

.docs-page blockquote {
  margin: var(--space-lg) 0;
  padding: var(--space-lg);
  padding-left: var(--space-xl);
  border-left: 4px solid var(--color-gold);
  background-color: var(--color-gold-mist);
  color: var(--color-text-soft);
  font-style: italic;
  border-radius: var(--radius-md);
}

.docs-page blockquote p {
  margin-bottom: var(--space-md);
}

.docs-page blockquote p:last-child {
  margin-bottom: 0;
}

/* ============================================================
   Images
   ============================================================ */

.docs-page img {
  max-width: 100%;
  height: auto;
  display: block;
  margin: var(--space-2xl) auto;
  border-radius: var(--radius-lg);
  box-shadow: var(--shadow-md);
  border: 1px solid var(--color-border-soft);
}

.docs-page img.inline {
  margin: 0;
  display: inline;
  box-shadow: none;
  border: none;
}

.docs-page figure {
  margin: var(--space-2xl) 0;
  text-align: center;
}

.docs-page figcaption {
  margin-top: var(--space-md);
  font-size: var(--fs-sm);
  color: var(--color-text-muted);
  font-style: italic;
}

/* ============================================================
   Tables
   ============================================================ */

.docs-page table {
  width: 100%;
  border-collapse: collapse;
  margin: var(--space-2xl) 0;
  box-shadow: var(--shadow-sm);
  border-radius: var(--radius-lg);
  overflow: hidden;
}

.docs-page thead {
  background-color: var(--color-purple-mist);
}

.docs-page th {
  padding: var(--space-md) var(--space-lg);
  text-align: left;
  font-weight: var(--fw-semibold);
  color: var(--color-purple);
  border-bottom: 2px solid var(--color-purple-line);
}

.docs-page td {
  padding: var(--space-md) var(--space-lg);
  border-bottom: 1px solid var(--color-border-soft);
}

.docs-page tbody tr:hover {
  background-color: var(--color-bg-alt);
  transition: background-color var(--transition-fast);
}

.docs-page tbody tr:last-child td {
  border-bottom: none;
}

/* ============================================================
   Horizontal Rule
   ============================================================ */

.docs-page hr {
  margin: var(--space-3xl) 0;
  border: none;
  border-top: 2px solid var(--color-border-soft);
}

/* ============================================================
   Strong and Emphasis
   ============================================================ */

.docs-page strong,
.docs-page b {
  font-weight: var(--fw-semibold);
  color: var(--color-text);
}

.docs-page em,
.docs-page i {
  font-style: italic;
  color: var(--color-text-soft);
}

/* ============================================================
   Mark/Highlight
   ============================================================ */

.docs-page mark {
  background-color: var(--color-warning-bg);
  color: inherit;
  padding: var(--space-xs) var(--space-sm);
  border-radius: var(--radius-sm);
}

/* ============================================================
   Subscript and Superscript
   ============================================================ */

.docs-page sub,
.docs-page sup {
  font-size: 0.8em;
  line-height: 0;
  position: relative;
}

.docs-page sup {
  top: -0.5em;
}

.docs-page sub {
  bottom: -0.25em;
}

/* ============================================================
   Abbreviation
   ============================================================ */

.docs-page abbr[title] {
  border-bottom: 1px dotted var(--color-border);
  cursor: help;
  text-decoration: none;
}

/* ============================================================
   Small text
   ============================================================ */

.docs-page small {
  font-size: 0.875em;
  color: var(--color-text-muted);
}

/* ============================================================
   Dividers and Separators
   ============================================================ */

.docs-page .divider {
  margin: var(--space-3xl) 0;
  height: 1px;
  background: linear-gradient(
    to right,
    transparent,
    var(--color-border-soft),
    transparent
  );
  border: none;
}

/* ============================================================
   Highlights / Alert boxes
   ============================================================ */

.docs-page .alert,
.docs-page .note,
.docs-page .tip,
.docs-page .warning,
.docs-page .danger {
  margin: var(--space-lg) 0;
  padding: var(--space-lg);
  border-radius: var(--radius-lg);
  border-left: 4px solid;
}

.docs-page .alert {
  background-color: var(--color-info-bg);
  border-left-color: var(--color-info);
  color: var(--color-info);
}

.docs-page .note {
  background-color: var(--color-info-bg);
  border-left-color: var(--color-info);
  color: var(--color-text);
}

.docs-page .tip {
  background-color: var(--color-success-bg);
  border-left-color: var(--color-success);
  color: var(--color-text);
}

.docs-page .warning {
  background-color: var(--color-warning-bg);
  border-left-color: var(--color-warning);
  color: var(--color-text);
}

.docs-page .danger {
  background-color: var(--color-danger-bg);
  border-left-color: var(--color-danger);
  color: var(--color-text);
}

.docs-page .alert p,
.docs-page .note p,
.docs-page .tip p,
.docs-page .warning p,
.docs-page .danger p {
  margin-bottom: 0;
}

/* ============================================================
   Responsive adjustments
   ============================================================ */

@media (max-width: 768px) {
  .docs-page h1 {
    font-size: var(--fs-2xl);
  }

  .docs-page h2 {
    font-size: var(--fs-xl);
  }

  .docs-page h3 {
    font-size: var(--fs-lg);
  }

  .docs-page ul,
  .docs-page ol {
    padding-left: var(--space-xl);
  }

  .docs-page table {
    font-size: var(--fs-sm);
  }

  .docs-page th,
  .docs-page td {
    padding: var(--space-sm) var(--space-md);
  }

  .docs-page pre {
    padding: var(--space-md);
    font-size: var(--fs-xs);
  }
}