/* ─────────────────────────────────────────────────────────────── */
/* Typography Token Display - Show actual font families            */
/* ─────────────────────────────────────────────────────────────── */

.typography-token-grid {
  display: grid;
  grid-template-columns: 1fr;
  gap: var(--a-space-m);
  margin: var(--a-space-l) 0;
}

@media (min-width: 480px) {
  .typography-token-grid {
    grid-template-columns: repeat(2, 1fr);
  }
}

@media (min-width: 768px) {
  .typography-token-grid {
    grid-template-columns: repeat(4, 1fr);
  }
}

/* ─────────────────────────────────────────────────────────────── *//**
 * Axiom01 Documentation Styles
 * =====================================
 *
 * IMPORTANT: These styles are ONLY for documentation examples
 * They do NOT become part of the Axiom01 framework
 * 
 * Use these classes ONLY in documentation pages
 * Production implementations should use only framework core classes
 */

/* ─────────────────────────────────────────────────────────────── */
/* Color Palette Cards - Semantic: Color demo cards               */
/* ─────────────────────────────────────────────────────────────── */

.color-card {
  text-align: center;
}

/* ─────────────────────────────────────────────────────────────── */
/* Color Token Display - Semantic: Color demonstrations with vars  */
/* ─────────────────────────────────────────────────────────────── */

.color-token-grid {
  display: grid;
  grid-template-columns: 1fr;
  gap: var(--a-space-m);
  margin: var(--a-space-l) 0;
}

@media (min-width: 480px) {
  .color-token-grid {
    grid-template-columns: repeat(2, 1fr);
  }
}

@media (min-width: 768px) {
  .color-token-grid {
    grid-template-columns: repeat(3, 1fr);
  }
}

.color-token-card {
  display: flex;
  flex-direction: column;
  gap: var(--a-space-s);
}

.color-swatch-demo {
  width: 100%;
  height: 80px;
  border-radius: var(--a-border-radius-lg);
  border: 1px solid var(--ax-border);
  box-shadow: var(--a-shadow-sm);
}

.color-token-label {
  font-weight: var(--a-font-weight-semibold);
  font-size: var(--a-font-size-sm);
  padding: var(--a-space-xs) var(--a-space-s);
  border-radius: var(--a-border-radius-md);
  font-family: var(--a-font-family-mono);
}

.color-token-usage {
  font-size: var(--a-font-size-xs);
  color: var(--a-color-on-surface-variant);
}

/* ─────────────────────────────────────────────────────────────── */
/* Example/Demo Container - Semantic: Display rendered examples    */
/* ─────────────────────────────────────────────────────────────── */

.component-example {
  background: var(--a-color-surface-variant);
  border: 1px solid var(--a-color-outline);
  border-radius: var(--a-border-radius-lg);
  padding: var(--a-space-l);
  margin-block: var(--a-space-l);
}

.component-example:last-of-type {
  margin-block-end: 0;
}

/* ─────────────────────────────────────────────────────────────── */
/* Section Container - Semantic: Documentation section             */
/* ─────────────────────────────────────────────────────────────── */

.component-section {
  margin-block-end: var(--a-space-xxl);
}

.component-section > h2:first-child {
  margin-block-start: 0;
}

.component-section > h3:first-child {
  margin-block-start: 0;
}

/* ─────────────────────────────────────────────────────────────── */
/* Layout Grid - Semantic: Multi-column layouts for examples       */
/* ─────────────────────────────────────────────────────────────── */

.component-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
  gap: var(--a-space-l);
  margin-block-end: var(--a-space-l);
}

.layout-grid {
  display: grid;
  gap: var(--a-space-m);
  margin-block-end: var(--a-space-l);
}

.layout-grid.two-column {
  grid-template-columns: repeat(2, 1fr);
}

@media (max-width: 768px) {
  .layout-grid.two-column {
    grid-template-columns: 1fr;
  }
}

/* ─────────────────────────────────────────────────────────────── */
/* Form Examples - Semantic: Form field grouping                   */
/* ─────────────────────────────────────────────────────────────── */

.form-check-label {
  display: block;
  margin-block-end: var(--a-space-s);
  cursor: pointer;
}

.form-check-label input[type="checkbox"],
.form-check-label input[type="radio"] {
  margin-inline-end: var(--a-space-s);
  cursor: pointer;
  vertical-align: middle;
}

/* ─────────────────────────────────────────────────────────────── */
/* Text Utilities - Semantic: Text styling helpers                 */
/* ─────────────────────────────────────────────────────────────── */

.text-muted {
  color: var(--a-color-on-surface-variant);
}

.text-small {
  font-size: var(--a-font-size-sm);
}

.text-mono {
  font-family: var(--a-font-family-mono);
}

/* ─────────────────────────────────────────────────────────────── */
/* List Examples - Semantic: Example lists                         */
/* ─────────────────────────────────────────────────────────────── */

.component-list {
  list-style: none;
  padding: 0;
  margin: 0;
}

.component-list > li {
  padding: var(--a-space-m);
  border-bottom: 1px solid var(--a-color-outline);
}

.component-list > li:last-child {
  border-bottom: none;
}

/* ─────────────────────────────────────────────────────────────── */
/* Card Examples - Semantic: Card component demonstrations         */
/* ─────────────────────────────────────────────────────────────── */

.card-example {
  background: var(--a-color-surface);
  border: 1px solid var(--a-color-outline);
  border-radius: var(--a-border-radius-lg);
  overflow: hidden;
}

.card-example-header {
  padding: var(--a-space-l);
  border-bottom: 1px solid var(--a-color-outline);
  background: var(--a-color-surface-variant);
}

.card-example-body {
  padding: var(--a-space-l);
}

.card-example-footer {
  padding: var(--a-space-l);
  border-top: 1px solid var(--a-color-outline);
  background: var(--a-color-surface-variant);
}

/* ─────────────────────────────────────────────────────────────── */
/* Alert Examples - Semantic: Alert component demonstrations       */
/* ─────────────────────────────────────────────────────────────── */

.alert-example {
  padding: var(--a-space-m);
  border-radius: var(--a-border-radius-md);
  border-left: 4px solid var(--a-color-outline);
  margin-block-end: var(--a-space-m);
}

.alert-example.success {
  background: var(--a-color-success-container);
  border-left-color: var(--a-color-success);
  color: var(--a-color-on-success-container);
}

.alert-example.error {
  background: var(--a-color-error-container);
  border-left-color: var(--a-color-error);
  color: var(--a-color-on-error-container);
}

.alert-example.warning {
  background: var(--a-color-warning-container);
  border-left-color: var(--a-color-warning);
  color: var(--a-color-on-warning-container);
}

.alert-example.info {
  background: var(--a-color-info-container);
  border-left-color: var(--a-color-info);
  color: var(--a-color-on-info-container);
}

/* ─────────────────────────────────────────────────────────────── */
/* Tab Navigation - Semantic: Tab component examples               */
/* ─────────────────────────────────────────────────────────────── */

.tab-list {
  display: flex;
  gap: var(--a-space-s);
  list-style: none;
  margin: 0;
  padding: 0;
  border-bottom: 2px solid var(--a-color-outline);
  overflow-x: auto;
}

.tab-list li {
  margin: 0;
}

.tab-list button {
  padding: var(--a-space-m) var(--a-space-l);
  background: none;
  border: none;
  border-bottom: 2px solid transparent;
  color: var(--a-color-on-surface-variant);
  cursor: pointer;
  font-family: inherit;
  font-size: inherit;
  font-weight: var(--a-font-weight-medium);
  transition: all 0.2s ease;
  white-space: nowrap;
}

.tab-list button:hover {
  color: var(--a-color-on-surface);
}

.tab-list button[aria-selected="true"] {
  color: var(--a-color-primary);
  border-bottom-color: var(--a-color-primary);
}

.tab-panel {
  padding: var(--a-space-l);
  display: none;
}

.tab-panel[aria-selected="true"] {
  display: block;
}

/* ─────────────────────────────────────────────────────────────── */
/* Media Examples - Semantic: Image/media demonstrations           */
/* ─────────────────────────────────────────────────────────────── */

.media-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
  gap: var(--a-space-l);
  margin-block-end: var(--a-space-l);
}

.media-item {
  text-align: center;
}

.media-item figure {
  margin: 0 0 var(--a-space-m);
}

.media-item img {
  max-width: 100%;
  height: auto;
  border-radius: var(--a-border-radius-md);
}

.media-item figcaption {
  font-size: var(--a-font-size-sm);
  color: var(--a-color-on-surface-variant);
}

/* ─────────────────────────────────────────────────────────────── */
/* Typography Examples - Semantic: Text samples                    */
/* ─────────────────────────────────────────────────────────────── */

.text-size-example {
  background: var(--a-color-surface-variant);
  padding: var(--a-space-m);
  margin-block-end: var(--a-space-s);
  border-radius: var(--a-border-radius-md);
  border: 1px solid var(--a-color-outline);
}

.line-height-example {
  background: var(--a-color-surface-variant);
  padding: var(--a-space-m);
  margin-block-end: var(--a-space-l);
  border-radius: var(--a-border-radius-md);
  border: 1px solid var(--a-color-outline);
}

/* ─────────────────────────────────────────────────────────────── */
/* Animation Examples - Semantic: Animation demonstrations         */
/* ─────────────────────────────────────────────────────────────── */

@keyframes fadeIn {
  from {
    opacity: 0;
  }
  to {
    opacity: 1;
  }
}

@keyframes slideInRight {
  from {
    opacity: 0;
    transform: translateX(20px);
  }
  to {
    opacity: 1;
    transform: translateX(0);
  }
}

@keyframes slideInLeft {
  from {
    opacity: 0;
    transform: translateX(-20px);
  }
  to {
    opacity: 1;
    transform: translateX(0);
  }
}

@keyframes scaleIn {
  from {
    opacity: 0;
    transform: scale(0.95);
  }
  to {
    opacity: 1;
    transform: scale(1);
  }
}

.animation-demo {
  animation: fadeIn 0.6s ease-out forwards;
}

.animation-demo.slide-right {
  animation: slideInRight 0.6s ease-out forwards;
}

.animation-demo.slide-left {
  animation: slideInLeft 0.6s ease-out forwards;
}

.animation-demo.scale-in {
  animation: scaleIn 0.6s ease-out forwards;
}

.animation-demo.delay-1 {
  animation-delay: 0.2s;
}

.animation-demo.delay-2 {
  animation-delay: 0.4s;
}

.animation-demo.delay-3 {
  animation-delay: 0.6s;
}

/* ─────────────────────────────────────────────────────────────── */
/* Button Group - Semantic: Multiple buttons example               */
/* ─────────────────────────────────────────────────────────────── */

.button-group {
  display: flex;
  gap: var(--a-space-s);
  flex-wrap: wrap;
  margin-block-end: var(--a-space-m);
}

/* ─────────────────────────────────────────────────────────────── */
/* Color Palette - Semantic: Color demonstrations                  */
/* ─────────────────────────────────────────────────────────────── */

.color-swatch {
  display: inline-block;
  width: 100px;
  height: 100px;
  border-radius: var(--a-border-radius-lg);
  border: 1px solid var(--a-color-outline);
  margin: var(--a-space-m);
  position: relative;
  overflow: hidden;
}

.color-swatch-label {
  position: absolute;
  bottom: 0;
  left: 0;
  right: 0;
  background: rgba(0, 0, 0, 0.5);
  color: white;
  padding: var(--a-space-xs) var(--a-space-s);
  font-size: var(--a-font-size-xs);
  font-family: var(--a-font-family-mono);
}

.color-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(120px, 1fr));
  gap: var(--a-space-l);
  margin-block-end: var(--a-space-l);
}

/* ─────────────────────────────────────────────────────────────── */
/* Comparison Table - Semantic: Feature comparison                 */
/* ─────────────────────────────────────────────────────────────── */

.comparison-table {
  width: 100%;
  border-collapse: collapse;
  margin-block-end: var(--a-space-l);
}

.comparison-table th,
.comparison-table td {
  padding: var(--a-space-m);
  text-align: left;
  border-bottom: 1px solid var(--a-color-outline);
}

.comparison-table th {
  background: var(--a-color-surface-variant);
  font-weight: var(--a-font-weight-bold);
  color: var(--a-color-on-surface);
}

.comparison-table tbody tr:hover {
  background: var(--a-color-surface-variant);
}

/* ─────────────────────────────────────────────────────────────── */
/* Code Example - Semantic: Code display sections                  */
/* ─────────────────────────────────────────────────────────────── */

.code-example {
  background: var(--a-color-on-surface);
  color: var(--a-color-surface);
  padding: var(--a-space-l);
  border-radius: var(--a-border-radius-md);
  overflow-x: auto;
  margin-block-end: var(--a-space-l);
  font-family: var(--a-font-family-mono);
  font-size: var(--a-font-size-sm);
  line-height: 1.5;
}

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

/* ─────────────────────────────────────────────────────────────── */
/* Content Wrapper - Semantic: Main content area                   */
/* ─────────────────────────────────────────────────────────────── */

.content-main {
  max-width: 1200px;
  margin: 0 auto;
  padding: var(--a-space-l);
}

/* ─────────────────────────────────────────────────────────────── */
/* Component Browser - Semantic: Icon/component browser            */
/* ─────────────────────────────────────────────────────────────── */

.component-browser {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(80px, 1fr));
  gap: var(--a-space-m);
  margin-block-end: var(--a-space-l);
}

.component-browser-item {
  background: var(--a-color-surface-variant);
  border: 1px solid var(--a-color-outline);
  border-radius: var(--a-border-radius-md);
  padding: var(--a-space-m);
  text-align: center;
  cursor: pointer;
  transition: all 0.2s ease;
}

.component-browser-item:hover {
  background: var(--a-color-outline);
  transform: translateY(-2px);
}

.component-browser-item svg,
.component-browser-item .axicon {
  display: block;
  width: 32px;
  height: 32px;
  margin: 0 auto var(--a-space-s);
  color: var(--a-color-primary);
}

.component-browser-item span {
  display: block;
  font-size: var(--a-font-size-xs);
  color: var(--a-color-on-surface-variant);
}

/* ─────────────────────────────────────────────────────────────── */
/* Output Area - Semantic: Rendered output display                 */
/* ─────────────────────────────────────────────────────────────── */

.output-area {
  background: var(--a-color-surface);
  border: 1px solid var(--a-color-outline);
  border-left: 3px solid var(--a-color-primary);
  padding: var(--a-space-m);
  margin-block-end: var(--a-space-l);
  border-radius: var(--a-border-radius-md);
}

/* ─────────────────────────────────────────────────────────────── */
/* Flex Utilities - Semantic: Layout helpers                       */
/* ─────────────────────────────────────────────────────────────── */

.flex-row {
  display: flex;
  gap: var(--a-space-m);
}

.flex-column {
  display: flex;
  flex-direction: column;
  gap: var(--a-space-m);
}

/* ─────────────────────────────────────────────────────────────── */
/* Dark Mode Support - All colors automatically adapt              */
/* ─────────────────────────────────────────────────────────────── */

@media (prefers-color-scheme: dark) {
  /* CSS variables handle dark mode - no additional rules needed */
}

/* ─────────────────────────────────────────────────────────────── */
/* Print Styles - Documentation-specific                           */
/* ─────────────────────────────────────────────────────────────── */

@media print {
  .component-example {
    page-break-inside: avoid;
  }
  
  .code-example {
    page-break-inside: avoid;
  }
}

/* ─────────────────────────────────────────────────────────────── */
/* Responsive Adjustments                                          */
/* ─────────────────────────────────────────────────────────────── */

@media (max-width: 768px) {
  .component-grid {
    grid-template-columns: 1fr;
  }
  
  .media-grid {
    grid-template-columns: 1fr;
  }
  
  .tab-list {
    flex-wrap: nowrap;
    overflow-x: auto;
  }
  
  .button-group {
    flex-direction: column;
  }
  
  .button-group button {
    width: 100%;
  }
}

/* ─────────────────────────────────────────────────────────────── */
/* MARKER: Documentation-only styles end here                      */
/* These styles are NOT part of Axiom01 framework                  */
/* ─────────────────────────────────────────────────────────────── */


/* ─────────────────────────────────────────────────────────────── */
/* Demo-Specific Styles - Used for documentation examples only    */
/* ─────────────────────────────────────────────────────────────── */

.demo-section-header {
  background: var(--a-color-primary-container);
  padding: var(--a-space-l);
  border-radius: var(--a-border-radius-md);
  margin-block-end: var(--a-space-l);
}

.demo-section-header h2 {
  margin-top: 0;
}

.demo-code-inline {
  background: var(--a-color-info-container);
  padding: 2px 6px;
  border-radius: 3px;
  font-family: var(--a-font-family-mono);
  font-size: 0.9em;
}

.demo-table-small {
  font-size: 0.9rem;
}

.demo-list-compact {
  margin: 0;
  padding-left: var(--a-space-l);
}

.demo-button-interactive {
  transition: transform 150ms ease-in-out, box-shadow 150ms ease-in-out;
  cursor: pointer;
}

.demo-button-interactive:hover {
  transform: translateY(-2px);
}

.demo-section-info {
  background: var(--a-color-info-container);
  padding: var(--a-space-l);
  border-radius: var(--a-border-radius-md);
}

.demo-code-highlight {
  background: var(--a-color-primary-container);
  border-left: 4px solid var(--a-color-primary);
  padding: var(--a-space-m);
  border-radius: var(--a-border-radius-md);
}

/* ─────────────────────────────────────────────────────────────── */


/* ─────────────────────────────────────────────────────────────── */
/* Hero H1 Responsive Sizing - Mobile First                       */
/* ─────────────────────────────────────────────────────────────── */

.hero h1 {
  /* Start larger on mobile */
  font-size: var(--a-font-size-3xl);
  line-height: var(--a-line-height-tight);
  margin: var(--a-space-l) 0;
}

/* Tablet and up */
@media (min-width: 768px) {
  .hero h1 {
    font-size: var(--a-font-size-4xl);
  }
}

/* Desktop and up */
@media (min-width: 1024px) {
  .hero h1 {
    font-size: calc(var(--a-font-size-4xl) * 1.15);
  }
}

/* Large desktop */
@media (min-width: 1440px) {
  .hero h1 {
    font-size: calc(var(--a-font-size-4xl) * 1.3);
  }
}

/* ─────────────────────────────────────────────────────────────── */

/* ─────────────────────────────────────────────────────────────── */
/* Additional Demo Styles - Added Session 8                        */
/* ─────────────────────────────────────────────────────────────── */

.demo-link-primary {
  color: var(--a-color-primary);
}

.demo-list-reset {
  margin: 0;
  padding-left: var(--a-space-l);
}

.demo-text-center {
  text-align: center;
}

.demo-margin-title {
  margin: 0 0 var(--a-space-m) 0;
  color: var(--a-color-primary);
}

.demo-emoji-icon {
  font-size: 2rem;
}

/* ─────────────────────────────────────────────────────────────── */

.demo-icon-lg {
  font-size: 24px;
}

.demo-backlit-text {
  margin: 0 0 var(--a-space-m);
  color: var(--a-color-on-surface);
}

.demo-backlit-card {
  --light-x: 75%;
  --light-y: 25%;
  display: inline-block;
  max-width: 300px;
}

.demo-backlit-title {
  margin-top: 0;
}

.demo-icon-warning {
  color: var(--a-color-warning);
  font-size: 24px;
}

.demo-button-delete {
  background: var(--a-color-error);
  color: white;
}

.demo-metadata-label {
  font-size: 0.75rem;
  color: var(--a-color-text-muted);
}

.demo-backlit-interactive-text {
  margin: 0;
  color: var(--a-color-primary);
  font-weight: bold;
}

.demo-no-items {
  color: var(--a-color-text-muted);
  font-size: var(--a-font-size-sm);
}

.demo-clickable {
  cursor: pointer;
}

/* Mobile-first h1 sizing in hero section */
@media (max-width: 768px) {
  section.hero h1 {
    font-size: calc(var(--a-font-size-h1) * 1.05);
  }
}