/* =============================================================================
   Common Features Documentation Styles
   Media containers, TOC navigation, and feature demo layouts
   ============================================================================= */

/* =============================================================================
   BASE OVERRIDES
   ============================================================================= */

/* Remove paragraph max-width constraint for documentation */
.doc-section p {
  max-width: none;
}

/* =============================================================================
   TABLE OF CONTENTS (Sticky Sidebar)
   ============================================================================= */

.doc-toc {
  position: sticky;
  top: calc(72px + var(--space-lg));
  height: fit-content;
  max-height: calc(100vh - 72px - var(--space-xl));
  overflow-y: auto;
  padding: var(--space-md);
  background: var(--black-surface);
  border: 1px solid var(--grey-border);
  animation: fadeInUp 0.4s ease-out both;
  animation-delay: 0.05s;
}

/* Custom scrollbar for TOC */
.doc-toc::-webkit-scrollbar {
  width: 4px;
}

.doc-toc::-webkit-scrollbar-track {
  background: var(--black-surface);
}

.doc-toc::-webkit-scrollbar-thumb {
  background: var(--grey-border);
}

.doc-toc::-webkit-scrollbar-thumb:hover {
  background: var(--grey-muted);
}

.doc-toc__label {
  display: block;
  font-family: var(--font-mono);
  font-size: 0.65rem;
  color: var(--grey-muted);
  text-transform: uppercase;
  letter-spacing: 0.1em;
  margin-bottom: var(--space-sm);
  padding-bottom: var(--space-xs);
  border-bottom: 1px solid var(--grey-border);
  line-height: 1;
}

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

.doc-toc__item {
  margin-bottom: 2px;
}

.doc-toc__link {
  display: block;
  padding: var(--space-xs) var(--space-sm);
  font-family: var(--font-mono);
  font-size: 0.75rem;
  color: var(--grey-text);
  text-decoration: none;
  border-left: 2px solid transparent;
  transition: all 0.2s ease;
}

.doc-toc__link:hover {
  color: var(--white-primary);
  border-left-color: var(--grey-muted);
  background: var(--black-elevated);
}

.doc-toc__link--active {
  color: var(--cyan-primary);
  border-left-color: var(--cyan-primary);
  background: var(--cyan-subtle);
}

/* Nested TOC items (for sub-sections) */
.doc-toc__item--nested .doc-toc__link {
  padding-left: var(--space-md);
  font-size: 0.7rem;
}

/* =============================================================================
   LAYOUT GRID (With TOC Sidebar)
   ============================================================================= */

.tool-content__grid--with-toc {
  display: grid;
  grid-template-columns: 240px 1fr;
  gap: var(--space-xl);
}

@media (max-width: 1024px) {
  .tool-content__grid--with-toc {
    grid-template-columns: 1fr;
  }

  .doc-toc {
    position: relative;
    top: 0;
    max-height: none;
    margin-bottom: var(--space-lg);
  }

  .doc-toc__list {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-xs);
  }

  .doc-toc__item {
    margin-bottom: 0;
  }

  .doc-toc__link {
    padding: var(--space-xs) var(--space-sm);
    border-left: none;
    border-bottom: 2px solid transparent;
  }

  .doc-toc__link:hover,
  .doc-toc__link--active {
    border-left: none;
    border-bottom-color: var(--cyan-primary);
  }
}

/* =============================================================================
   MEDIA CONTAINERS
   ============================================================================= */

.media-container {
  position: relative;
  margin: var(--space-lg) 0;
  background: var(--black-surface);
  border: 1px solid var(--grey-border);
  overflow: hidden;
  transition: border-color 0.2s ease;
}

.media-container:hover {
  border-color: var(--grey-muted);
}

/* Aspect ratio variants */
.media-container--16x9 {
  aspect-ratio: 16 / 9;
}

.media-container--4x3 {
  aspect-ratio: 4 / 3;
}

.media-container--21x9 {
  aspect-ratio: 21 / 9;
}

.media-container--square {
  aspect-ratio: 1 / 1;
}

/* Decorative frame (optional) */
.media-container__frame {
  position: absolute;
  inset: 4px;
  border: 1px solid var(--grey-border);
  pointer-events: none;
  z-index: 5;
  opacity: 0.5;
}

/* Caption */
.media-container__caption,
.doc-section .media-container__caption {
  margin: 0;
  padding: var(--space-sm) var(--space-md);
  font-family: var(--font-mono);
  font-size: 0.7rem;
  color: var(--grey-muted);
  background: var(--black-elevated);
  border-top: 1px solid var(--grey-border);
}

.media-container__caption code {
  color: var(--cyan-primary);
  background: transparent;
  padding: 0;
}

/* Animated indicator badge */
.media-container--animated::before {
  content: 'LOOP';
  position: absolute;
  top: var(--space-sm);
  right: var(--space-sm);
  font-family: var(--font-mono);
  font-size: 0.55rem;
  color: var(--cyan-primary);
  background: rgba(10, 10, 11, 0.85);
  border: 1px solid var(--grey-border);
  padding: 2px 6px;
  z-index: 10;
  text-transform: uppercase;
  letter-spacing: 0.1em;
}

/* =============================================================================
   IMAGES
   ============================================================================= */

.media-image {
  display: block;
  width: 100%;
  height: auto;
  transition: filter 0.3s ease;
}

/* Optional: zoomable images (opens in lightbox) */
.media-container--zoomable {
  cursor: zoom-in;
}

.media-container--zoomable:hover .media-image {
  filter: brightness(1.05);
}

/* Image grid for multiple screenshots */
.media-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
  gap: var(--space-sm);
  margin: var(--space-lg) 0;
}

.media-grid .media-container {
  margin: 0;
}

/* Two-column grid variant */
.media-grid--2col {
  grid-template-columns: repeat(2, 1fr);
}

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

/* =============================================================================
   VIDEO PLAYER
   ============================================================================= */

.media-video {
  width: 100%;
  height: auto;
  display: block;
  background: var(--black-deep);
}

/* Video with aspect ratio container */
.media-container--16x9 .media-video,
.media-container--4x3 .media-video,
.media-container--21x9 .media-video {
  position: absolute;
  inset: 0;
  object-fit: cover;
}

/* Custom video controls overlay (progressive enhancement) */
.media-video-controls {
  position: absolute;
  bottom: 0;
  left: 0;
  right: 0;
  padding: var(--space-md);
  background: linear-gradient(transparent, rgba(10, 10, 11, 0.9));
  display: flex;
  align-items: center;
  gap: var(--space-md);
  opacity: 0;
  transition: opacity 0.3s ease;
  z-index: 10;
}

.media-container:hover .media-video-controls,
.media-container:focus-within .media-video-controls {
  opacity: 1;
}

.media-video-controls__btn {
  width: 32px;
  height: 32px;
  display: flex;
  align-items: center;
  justify-content: center;
  background: transparent;
  border: 1px solid var(--grey-border);
  color: var(--white-primary);
  cursor: pointer;
  transition: all 0.2s ease;
}

.media-video-controls__btn:hover {
  border-color: var(--cyan-primary);
  color: var(--cyan-primary);
}

.media-video-controls__progress {
  flex: 1;
  height: 3px;
  background: var(--grey-border);
  cursor: pointer;
  position: relative;
}

.media-video-controls__progress-fill {
  height: 100%;
  background: var(--cyan-primary);
  width: 0%;
  transition: width 0.1s linear;
}

.media-video-controls__time {
  font-family: var(--font-mono);
  font-size: 0.7rem;
  color: var(--grey-text);
  min-width: 80px;
  text-align: right;
}

/* =============================================================================
   YOUTUBE EMBED (Lazy-loaded Facade)
   ============================================================================= */

.media-youtube {
  position: relative;
  aspect-ratio: 16 / 9;
  background: var(--black-surface);
  border: 1px solid var(--grey-border);
  cursor: pointer;
  overflow: hidden;
  transition: border-color 0.2s ease;
}

.media-youtube:hover {
  border-color: var(--grey-muted);
}

/* Thumbnail placeholder */
.media-youtube__thumbnail {
  position: absolute;
  inset: 0;
  background-size: cover;
  background-position: center;
  background-color: var(--black-deep);
  filter: brightness(0.7);
  transition: filter 0.3s ease;
}

.media-youtube:hover .media-youtube__thumbnail {
  filter: brightness(0.85);
}

/* Play button overlay */
.media-youtube__play {
  position: absolute;
  top: 50%;
  left: 50%;
  transform: translate(-50%, -50%);
  width: 72px;
  height: 72px;
  display: flex;
  align-items: center;
  justify-content: center;
  background: rgba(10, 10, 11, 0.8);
  border: 2px solid var(--cyan-primary);
  border-radius: 50%;
  color: var(--cyan-primary);
  transition: all 0.3s ease;
}

.media-youtube:hover .media-youtube__play {
  background: var(--cyan-primary);
  color: var(--black-deep);
  transform: translate(-50%, -50%) scale(1.1);
}

.media-youtube__play svg {
  margin-left: 4px; /* Visual centering for play triangle */
}

/* Loaded state - iframe visible */
.media-youtube--loaded .media-youtube__thumbnail,
.media-youtube--loaded .media-youtube__play {
  display: none;
}

.media-youtube__iframe {
  position: absolute;
  inset: 0;
  width: 100%;
  height: 100%;
  border: none;
}

/* =============================================================================
   FEATURE DEMO BLOCKS (Media + Description Layout)
   ============================================================================= */

.feature-demo {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--space-lg);
  margin: var(--space-lg) 0;
  padding: var(--space-lg);
  background: var(--black-surface);
  border: 1px solid var(--grey-border);
  border-left: 3px solid var(--cyan-primary);
  transition: border-color 0.2s ease;
}

.feature-demo:hover {
  border-color: var(--grey-muted);
  border-left-color: var(--cyan-primary);
}

/* Media positioning variants */
.feature-demo--media-left .feature-demo__media {
  order: -1;
}

.feature-demo--stacked {
  grid-template-columns: 1fr;
}

.feature-demo--stacked .feature-demo__media {
  order: -1;
}

/* Content area */
.feature-demo__content {
  display: flex;
  flex-direction: column;
  justify-content: center;
}

.feature-demo__title {
  font-family: var(--font-display);
  font-size: 1rem;
  color: var(--white-primary);
  margin: 0 0 var(--space-sm) 0;
}

.feature-demo__description {
  color: var(--grey-text);
  font-size: 0.9rem;
  line-height: 1.6;
  margin: 0 0 var(--space-md) 0;
}

.feature-demo__keybinds {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-sm);
  margin-top: auto;
}

.feature-demo__keybind {
  display: inline-flex;
  align-items: center;
  gap: var(--space-xs);
  font-family: var(--font-mono);
  font-size: 0.75rem;
  color: var(--grey-muted);
}

.feature-demo__keybind kbd {
  display: inline-block;
  min-width: 1.5em;
  padding: 3px 6px;
  font-family: var(--font-mono);
  font-size: 0.7rem;
  font-weight: 500;
  text-align: center;
  color: var(--cyan-primary);
  background: linear-gradient(180deg, var(--black-elevated) 0%, var(--black-surface) 100%);
  border: 1px solid var(--grey-border);
  border-bottom-width: 2px;
  border-radius: 3px;
}

/* List within feature demo */
.feature-demo__list {
  margin: 0;
  padding-left: var(--space-lg);
  color: var(--grey-text);
  font-size: 0.9rem;
  line-height: 1.6;
}

.feature-demo__list li {
  margin-bottom: var(--space-xs);
}

.feature-demo__list li:last-child {
  margin-bottom: 0;
}

.feature-demo__list li strong {
  color: var(--white-secondary);
}

/* Media area */
.feature-demo__media {
  position: relative;
}

.feature-demo__media .media-container {
  margin: 0;
}

/* Mobile: Stack all demos */
@media (max-width: 768px) {
  .feature-demo {
    grid-template-columns: 1fr;
    padding: var(--space-md);
  }

  .feature-demo--media-left .feature-demo__media,
  .feature-demo__media {
    order: -1;
  }

  .feature-demo__title {
    font-size: 1.1rem;
  }
}

/* =============================================================================
   COMMON HERO VARIANT (No version/game info)
   ============================================================================= */

.tool-hero--common .tool-hero__header {
  margin-bottom: var(--space-md);
}

.tool-hero--common h1 {
  font-size: clamp(2rem, 5vw, 3rem);
  margin: 0 0 var(--space-xs) 0;
}

.tool-hero--common .tool-hero__subtitle {
  font-size: 1rem;
  color: var(--grey-text);
  line-height: 1.6;
  max-width: 100ch;
}

/* =============================================================================
   INPUT METHOD TABLES (Side-by-side Keyboard/Gamepad)
   ============================================================================= */

.input-methods {
  display: grid;
  grid-template-columns: repeat(2, 1fr);
  gap: var(--space-lg);
  margin: var(--space-lg) 0;
}

@media (max-width: 900px) {
  .input-methods {
    grid-template-columns: 1fr;
  }
}

.input-methods .keybind-group {
  margin-bottom: 0;
}

/* Compact keybind list (alternative to table) */
.keybind-list {
  list-style: none;
  padding: 0;
  margin: 0;
}

.keybind-list__item {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: var(--space-sm) 0;
  border-bottom: 1px solid var(--grey-border);
  font-size: 0.875rem;
}

.keybind-list__item:last-child {
  border-bottom: none;
}

.keybind-list__item:hover {
  background: var(--black-elevated);
}

.keybind-list__item:hover kbd {
  color: var(--white-primary);
  border-color: var(--cyan-dim);
  transform: translateY(-1px);
  box-shadow:
    inset 0 1px 0 rgba(255, 255, 255, 0.05),
    0 2px 4px rgba(0, 0, 0, 0.4),
    0 0 8px var(--cyan-glow);
}

.keybind-list__action {
  color: var(--grey-text);
}

/* Keycap styling for list items (matches .keybind-table kbd from tool-docs.css) */
.keybind-list kbd {
  display: inline-block;
  min-width: 2em;
  padding: 4px 8px;
  font-family: var(--font-mono);
  font-size: 0.75rem;
  font-weight: 500;
  text-align: center;
  color: var(--cyan-primary);
  background:
    linear-gradient(180deg, var(--black-elevated) 0%, var(--black-surface) 100%);
  border: 1px solid var(--grey-border);
  border-bottom-width: 3px;
  border-radius: 3px;
  box-shadow:
    inset 0 1px 0 rgba(255, 255, 255, 0.05),
    0 1px 2px rgba(0, 0, 0, 0.3);
  transition: all 0.15s ease;
}

.keybind-list__keys {
  display: flex;
  align-items: center;
  gap: 4px;
  flex-wrap: wrap;
  justify-content: flex-end;
}

/* Gamepad button styling */
kbd.kbd--gamepad {
  background: linear-gradient(180deg, var(--black-surface) 0%, var(--black-deep) 100%);
  border-color: var(--grey-muted);
  color: var(--white-secondary);
  font-size: 0.75rem;
  padding: 4px 8px;
  border-radius: 4px;
}

.keybind-table tr:hover kbd.kbd--gamepad,
.keybind-list__item:hover kbd.kbd--gamepad {
  border-color: var(--cyan-dim);
  color: var(--cyan-primary);
}

/* Stick indicators (circular) */
kbd.kbd--stick {
  border-radius: 50%;
  width: 32px;
  height: 32px;
  padding: 0;
  display: inline-flex;
  align-items: center;
  justify-content: center;
  font-size: 0.7rem;
}

/* D-pad styling */
kbd.kbd--dpad {
  position: relative;
}

/* Trigger styling (slightly rounded) */
kbd.kbd--trigger {
  border-radius: 4px 4px 8px 8px;
}

/* Bumper styling */
kbd.kbd--bumper {
  border-radius: 8px 8px 4px 4px;
}

/* Arrow key symbols - make them slightly larger */
kbd.kbd--arrow {
  font-size: 0.85rem;
  min-width: 1.8em;
}

/* =============================================================================
   PLACEHOLDER STYLING (For scaffold content)
   ============================================================================= */

.placeholder-media {
  display: flex;
  align-items: center;
  justify-content: center;
  min-height: 200px;
  background: repeating-linear-gradient(
    45deg,
    var(--black-surface),
    var(--black-surface) 10px,
    var(--black-elevated) 10px,
    var(--black-elevated) 20px
  );
  color: var(--grey-muted);
  font-family: var(--font-mono);
  font-size: 0.75rem;
  text-transform: uppercase;
  letter-spacing: 0.1em;
}

.placeholder-media::before {
  content: 'Media Placeholder';
}

.placeholder-media--video::before {
  content: 'Video Placeholder';
}

.placeholder-media--image::before {
  content: 'Image Placeholder';
}

/* =============================================================================
   FOCUS STATES (Accessibility)
   ============================================================================= */

.doc-toc__link:focus-visible {
  outline: 2px solid var(--cyan-primary);
  outline-offset: 2px;
}

.media-youtube:focus-visible {
  outline: 2px solid var(--cyan-primary);
  outline-offset: 4px;
}

.media-video:focus-visible {
  outline: 2px solid var(--cyan-primary);
  outline-offset: 4px;
}

.media-container--zoomable:focus-visible {
  outline: 2px solid var(--cyan-primary);
  outline-offset: 4px;
}

/* =============================================================================
   REDUCED MOTION
   ============================================================================= */

@media (prefers-reduced-motion: reduce) {
  .doc-toc {
    animation: none;
  }

  .doc-toc__link,
  .media-container,
  .media-youtube,
  .media-youtube__thumbnail,
  .media-youtube__play,
  .media-video-controls,
  .feature-demo {
    transition: none;
  }

  .media-youtube:hover .media-youtube__play {
    transform: translate(-50%, -50%);
  }
}

/* =============================================================================
   DOC SUBSECTIONS (Nested within doc-section)
   ============================================================================= */

.doc-subsection {
  margin: var(--space-xl) 0;
  margin-left: var(--space-lg);
  padding-left: var(--space-xl);
  border-left: 2px solid var(--grey-border);
  scroll-margin-top: calc(72px + var(--space-lg));
}

.doc-subsection:first-of-type {
  margin-top: var(--space-lg);
}

.doc-subsection__title {
  font-family: var(--font-display);
  font-size: 1.1rem;
  color: var(--white-primary);
  margin: 0 0 var(--space-md) 0;
}

/* Tighter spacing for feature-demos inside subsections */
.doc-subsection .feature-demo {
  margin: var(--space-md) 0;
}

.doc-subsection .feature-demo:first-of-type {
  margin-top: 0;
}

/* Multiple feature-demos in same subsection */
.doc-subsection .feature-demo + .feature-demo {
  margin-top: var(--space-lg);
}

/* =============================================================================
   NESTED TOC (Enhanced for subsections)
   ============================================================================= */

.doc-toc__list--nested {
  list-style: none;
  padding: 0;
  margin: var(--space-xs) 0 0 0;
}

.doc-toc__item--nested {
  margin-bottom: 1px;
}

.doc-toc__item--nested .doc-toc__link {
  padding-left: var(--space-md);
  font-size: 0.7rem;
  color: var(--grey-muted);
}

.doc-toc__item--nested .doc-toc__link:hover {
  color: var(--grey-text);
  border-left-color: var(--grey-muted);
}

.doc-toc__item--nested .doc-toc__link--active {
  color: var(--cyan-primary);
  border-left-color: var(--cyan-primary);
  background: var(--cyan-subtle);
}

/* Mobile: nested items in horizontal layout */
@media (max-width: 1024px) {
  .doc-toc__list--nested {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-xs);
    margin-top: var(--space-xs);
    padding-left: var(--space-sm);
  }

  .doc-toc__item--nested .doc-toc__link {
    padding-left: var(--space-sm);
    border-left: none;
    border-bottom: 2px solid transparent;
  }

  .doc-toc__item--nested .doc-toc__link:hover,
  .doc-toc__item--nested .doc-toc__link--active {
    border-left: none;
    border-bottom-color: var(--cyan-primary);
  }
}