enya-agent 0.1.0

package/docs/themes/tanuki/sass/components/_navigation.scss

@@ -0,0 +1,1200 @@
+// =============================================================================
+// Navigation Components
+// =============================================================================
+
+// -----------------------------------------------------------------------------
+// Header / Top Navigation
+// -----------------------------------------------------------------------------
+
+.header {
+  z-index: 100;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 1rem 1.5rem;
+  background: var(--color-bg);
+  border-bottom: 1px solid var(--color-border);
+
+  @media (min-width: 768px) {
+    padding: 1rem 2rem;
+  }
+
+  // Fixed header (docs mode default)
+  .layout--fixed-header & {
+    position: sticky;
+    top: 0;
+    backdrop-filter: blur(10px);
+  }
+
+  // Non-fixed header (book/site mode default)
+  .layout:not(.layout--fixed-header) & {
+    position: relative;
+  }
+}
+
+.header__left {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+}
+
+.header__logo {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  font-size: var(--text-lg);
+  font-weight: var(--font-semibold);
+  color: var(--color-text);
+
+  svg, img {
+    width: 32px;
+    height: 32px;
+  }
+}
+
+// Home site link (back to main landing page)
+.header__home {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 40px;
+  height: 40px;
+  color: var(--color-text-secondary);
+  background: transparent;
+  border: 1px solid var(--color-border);
+  border-radius: 8px;
+  transition: all 0.2s ease;
+
+  &:hover {
+    color: var(--color-accent);
+    background: var(--color-bg-surface);
+    border-color: var(--color-accent);
+  }
+
+  svg {
+    width: 20px;
+    height: 20px;
+  }
+}
+
+.header__home-logo {
+  width: 24px;
+  height: 24px;
+  object-fit: contain;
+  border-radius: 4px;
+}
+
+.header__separator {
+  width: 1px;
+  height: 24px;
+  background: var(--color-border);
+  margin: 0 0.25rem;
+}
+
+// -----------------------------------------------------------------------------
+// Sidebar Toggle (Docs Mode)
+// -----------------------------------------------------------------------------
+
+// Desktop only - hidden on mobile (toc-toggle handles mobile)
+.sidebar-toggle {
+  display: none;
+  align-items: center;
+  justify-content: center;
+  width: 40px;
+  height: 40px;
+  color: var(--color-text-secondary);
+  background: transparent;
+  border: 1px solid var(--color-border);
+  border-radius: 8px;
+  cursor: pointer;
+  transition: all 0.2s ease;
+
+  @media (min-width: 1024px) {
+    display: flex;
+  }
+
+  &:hover {
+    color: var(--color-text);
+    background: var(--color-bg-surface);
+    border-color: var(--color-accent);
+  }
+
+  svg {
+    width: 20px;
+    height: 20px;
+  }
+
+  .sidebar-toggle__icon--closed {
+    display: none;
+  }
+
+  // When sidebar is collapsed
+  &[aria-expanded="false"] {
+    .sidebar-toggle__icon--open {
+      display: none;
+    }
+    .sidebar-toggle__icon--closed {
+      display: block;
+    }
+  }
+}
+
+// -----------------------------------------------------------------------------
+// ToC Toggle (Book Mode)
+// -----------------------------------------------------------------------------
+
+.toc-toggle {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 40px;
+  height: 40px;
+  color: var(--color-text-secondary);
+  background: transparent;
+  border: 1px solid var(--color-border);
+  border-radius: 8px;
+  cursor: pointer;
+  transition: all 0.2s ease;
+
+  &:hover {
+    color: var(--color-text);
+    background: var(--color-bg-surface);
+    border-color: var(--color-accent);
+  }
+
+  svg {
+    width: 20px;
+    height: 20px;
+  }
+
+  // For docs mode: only show on mobile (desktop has sidebar)
+  &--docs {
+    @media (min-width: 1024px) {
+      display: none;
+    }
+  }
+}
+
+// -----------------------------------------------------------------------------
+// ToC Overlay (Book Mode)
+// -----------------------------------------------------------------------------
+
+.toc-overlay {
+  position: fixed;
+  inset: 0;
+  z-index: 1000;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  opacity: 0;
+  visibility: hidden;
+  transition: all 0.3s ease;
+
+  &[aria-hidden="false"] {
+    opacity: 1;
+    visibility: visible;
+
+    .toc-overlay__panel {
+      transform: scale(1);
+    }
+  }
+}
+
+.toc-overlay__backdrop {
+  position: absolute;
+  inset: 0;
+  background: rgba(0, 0, 0, 0.7);
+  backdrop-filter: blur(4px);
+}
+
+.toc-overlay__panel {
+  position: relative;
+  width: 90%;
+  max-width: 600px;
+  max-height: 80vh;
+  background: var(--color-bg);
+  border-radius: 16px;
+  box-shadow: var(--shadow-xl);
+  overflow: hidden;
+  display: flex;
+  flex-direction: column;
+  transform: scale(0.95);
+  transition: transform 0.3s cubic-bezier(0.34, 1.56, 0.64, 1);
+}
+
+.toc-overlay__header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 1.5rem 2rem;
+  border-bottom: 1px solid var(--color-border);
+}
+
+.toc-overlay__title {
+  font-size: var(--text-xl);
+  font-weight: var(--font-semibold);
+  color: var(--color-text);
+  margin: 0;
+}
+
+.toc-overlay__close {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 40px;
+  height: 40px;
+  color: var(--color-text-secondary);
+  background: var(--color-bg-surface);
+  border-radius: 8px;
+  cursor: pointer;
+  transition: all 0.2s ease;
+
+  &:hover {
+    color: var(--color-text);
+    background: var(--ctp-red);
+    color: var(--ctp-base);
+  }
+
+  svg {
+    width: 20px;
+    height: 20px;
+  }
+}
+
+.toc-overlay__nav {
+  flex: 1;
+  overflow-y: auto;
+  padding: 1rem 0;
+}
+
+.toc-overlay__list {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+}
+
+.toc-overlay__item {
+  margin: 0;
+}
+
+.toc-overlay__link {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+  padding: 1rem 2rem;
+  color: var(--color-text-secondary);
+  text-decoration: none;
+  transition: all 0.2s ease;
+  border-left: 3px solid transparent;
+
+  &:hover {
+    background: var(--color-bg-surface);
+    color: var(--color-text);
+    border-left-color: var(--color-accent);
+  }
+
+  &--active {
+    background: rgba(203, 166, 247, 0.1);
+    color: var(--color-accent);
+    border-left-color: var(--color-accent);
+  }
+
+  &--section {
+    font-weight: var(--font-semibold);
+    color: var(--color-text);
+    border-bottom: 1px solid var(--color-border);
+    margin-bottom: 0.5rem;
+  }
+}
+
+.toc-overlay__chapter {
+  font-size: var(--text-xs);
+  font-weight: var(--font-medium);
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  color: var(--color-text-muted);
+}
+
+.toc-overlay__page-title {
+  font-size: var(--text-base);
+  font-weight: var(--font-medium);
+}
+
+.toc-overlay__section {
+  margin-top: 1.5rem;
+}
+
+.toc-overlay__section-title {
+  padding: 0.5rem 2rem;
+  font-size: var(--text-xs);
+  font-weight: var(--font-semibold);
+  text-transform: uppercase;
+  letter-spacing: 0.1em;
+  color: var(--color-text-muted);
+}
+
+.toc-overlay__footer {
+  padding: 1.5rem 2rem;
+  border-top: 1px solid var(--color-border);
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+}
+
+.toc-overlay__action {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+
+.toc-overlay__action-label {
+  font-size: var(--text-sm);
+  font-weight: var(--font-medium);
+  color: var(--color-text-secondary);
+}
+
+.toc-overlay__version {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+}
+
+.toc-overlay__version-current {
+  padding: 0.25rem 0.5rem;
+  font-size: var(--text-sm);
+  font-weight: var(--font-semibold);
+  background: var(--ctp-green);
+  color: var(--ctp-base);
+  border-radius: 4px;
+}
+
+.toc-overlay__version-link {
+  font-size: var(--text-sm);
+  color: var(--color-text-muted);
+  transition: color 0.2s ease;
+
+  &:hover {
+    color: var(--color-accent);
+  }
+}
+
+.toc-overlay__github,
+.toc-overlay__print {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  padding: 0.75rem 1rem;
+  font-size: var(--text-sm);
+  font-weight: var(--font-medium);
+  color: var(--color-text-secondary);
+  background: var(--color-bg-surface);
+  border-radius: 10px;
+  transition: all 0.2s ease;
+
+  &:hover {
+    color: var(--color-text);
+    background: var(--color-bg-overlay);
+    text-decoration: none;
+  }
+
+  svg {
+    flex-shrink: 0;
+  }
+}
+
+.header__nav {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+
+  @media (max-width: 767px) {
+    display: none;
+
+    &.open {
+      display: flex;
+      flex-direction: column;
+      position: absolute;
+      top: 100%;
+      left: 0;
+      right: 0;
+      padding: 1rem;
+      background: var(--color-bg);
+      border-bottom: 1px solid var(--color-border);
+    }
+  }
+}
+
+.header__link {
+  padding: 0.5rem 1rem;
+  font-size: var(--text-sm);
+  font-weight: var(--font-medium);
+  color: var(--color-text-secondary);
+  border-radius: 8px;
+  transition: all 0.2s ease;
+
+  &:hover {
+    color: var(--color-text);
+    background: var(--color-bg-surface);
+    text-decoration: none;
+  }
+
+  &.active {
+    color: var(--color-accent);
+    background: rgba(203, 166, 247, 0.1);
+  }
+}
+
+.header__actions {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+// Hide version/theme/github on mobile for docs/book mode (they're in ToC overlay)
+.header__actions-desktop {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+
+  .layout--docs &,
+  .layout--book & {
+    @media (max-width: 1023px) {
+      display: none;
+    }
+  }
+}
+
+// Mobile menu toggle - opens nav overlay
+.menu-toggle {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 44px;
+  height: 44px;
+  color: var(--color-text);
+  border-radius: 8px;
+  transition: background 0.2s ease;
+
+  // Hide on desktop - nav links are visible in header
+  @media (min-width: 768px) {
+    display: none;
+  }
+
+  &:hover {
+    background: var(--color-bg-surface);
+  }
+
+  svg {
+    width: 24px;
+    height: 24px;
+  }
+}
+
+// -----------------------------------------------------------------------------
+// Prev/Next Navigation Buttons - Full-height edge bars
+// -----------------------------------------------------------------------------
+
+.nav-buttons {
+  position: fixed;
+  top: 0;
+  bottom: 0;
+  left: 0;
+  right: 0;
+  display: flex;
+  justify-content: space-between;
+  pointer-events: none;
+  z-index: 50;
+
+  // Account for sidebar in docs mode - follows sidebar width
+  .layout--docs & {
+    @media (min-width: 1024px) {
+      left: var(--sidebar-width, 280px);
+      transition: left 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+    }
+  }
+
+  // No transition during resize - follow immediately
+  body.sidebar-resizing .layout--docs & {
+    transition: none;
+  }
+
+  // When sidebar is collapsed
+  .layout--docs:has(.sidebar.collapsed) & {
+    @media (min-width: 1024px) {
+      left: 0;
+    }
+  }
+}
+
+.nav-button {
+  pointer-events: auto;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 3rem;
+  height: 100%;
+  background: transparent;
+  color: var(--color-text-muted);
+  text-decoration: none;
+  transition: all 0.2s ease;
+
+  @media (min-width: 768px) {
+    width: 4rem;
+  }
+
+  svg {
+    width: 24px;
+    height: 24px;
+    stroke-width: 2;
+    opacity: 0.3;
+    transition: all 0.2s ease;
+  }
+
+  &:hover {
+    background: var(--color-bg-surface);
+    text-decoration: none;
+
+    svg {
+      opacity: 1;
+      color: var(--color-accent);
+    }
+  }
+
+  // Disabled state
+  &.disabled,
+  &[disabled] {
+    opacity: 0;
+    pointer-events: none;
+  }
+}
+
+.nav-button--prev {
+  border-right: 1px solid transparent;
+
+  &:hover {
+    border-right-color: var(--color-border);
+
+    svg {
+      transform: translateX(-3px);
+    }
+  }
+}
+
+.nav-button--next {
+  border-left: 1px solid transparent;
+
+  &:hover {
+    border-left-color: var(--color-border);
+
+    svg {
+      transform: translateX(3px);
+    }
+  }
+}
+
+// Tooltip labels
+.nav-button__label {
+  position: absolute;
+  top: 100%;
+  left: 50%;
+  transform: translateX(-50%);
+  margin-top: 0.5rem;
+  padding: 0.4rem 0.75rem;
+  font-size: var(--text-xs);
+  font-weight: var(--font-medium);
+  color: var(--color-text);
+  background: var(--color-bg-elevated);
+  border: 1px solid var(--color-border);
+  border-radius: 6px;
+  white-space: nowrap;
+  opacity: 0;
+  visibility: hidden;
+  transition: all 0.2s ease;
+  box-shadow: var(--shadow-md);
+}
+
+.nav-button:hover .nav-button__label {
+  opacity: 1;
+  visibility: visible;
+}
+
+// Keyboard shortcut hint
+.nav-button__shortcut {
+  display: none;
+  margin-left: 0.5rem;
+  padding: 0.15rem 0.4rem;
+  font-size: 0.65rem;
+  background: var(--color-bg-surface);
+  border-radius: 3px;
+  color: var(--color-text-muted);
+
+  @media (min-width: 768px) {
+    display: inline;
+  }
+}
+
+// -----------------------------------------------------------------------------
+// Version Picker Dropdown
+// -----------------------------------------------------------------------------
+
+.version-picker {
+  position: relative;
+}
+
+.version-picker__button {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  padding: 0.4rem 0.75rem;
+  font-size: var(--text-sm);
+  font-weight: var(--font-medium);
+  color: var(--color-text-secondary);
+  background: var(--color-bg-surface);
+  border: 1px solid var(--color-border);
+  border-radius: 6px;
+  cursor: pointer;
+  transition: all 0.2s ease;
+
+  &:hover {
+    border-color: var(--color-accent);
+    color: var(--color-text);
+  }
+
+  svg {
+    width: 14px;
+    height: 14px;
+    transition: transform 0.2s ease;
+  }
+
+  &[aria-expanded="true"] svg {
+    transform: rotate(180deg);
+  }
+}
+
+.version-picker__badge {
+  padding: 0.15rem 0.4rem;
+  font-size: var(--text-xs);
+  font-weight: var(--font-semibold);
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  background: var(--ctp-green);
+  color: var(--ctp-base);
+  border-radius: 4px;
+}
+
+.version-picker__dropdown {
+  position: absolute;
+  top: 100%;
+  right: 0;
+  margin-top: 0.5rem;
+  min-width: 180px;
+  background: var(--color-bg-elevated);
+  border: 1px solid var(--color-border);
+  border-radius: 8px;
+  box-shadow: var(--shadow-lg);
+  opacity: 0;
+  visibility: hidden;
+  transform: translateY(-8px);
+  transition: all 0.2s ease;
+  z-index: 100;
+
+  &.open {
+    opacity: 1;
+    visibility: visible;
+    transform: translateY(0);
+  }
+}
+
+.version-picker__item {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  width: 100%;
+  padding: 0.6rem 1rem;
+  font-size: var(--text-sm);
+  color: var(--color-text-secondary);
+  text-align: left;
+  transition: all 0.15s ease;
+
+  &:first-child {
+    border-radius: 8px 8px 0 0;
+  }
+
+  &:last-child {
+    border-radius: 0 0 8px 8px;
+  }
+
+  &:hover {
+    background: var(--color-bg-surface);
+    color: var(--color-text);
+  }
+
+  &.active {
+    color: var(--color-accent);
+    background: rgba(203, 166, 247, 0.1);
+  }
+
+  &--link {
+    gap: 0.5rem;
+    font-size: var(--text-xs);
+    color: var(--color-text-muted);
+
+    svg {
+      opacity: 0.6;
+    }
+
+    &:hover svg {
+      opacity: 1;
+    }
+  }
+}
+
+.version-picker__divider {
+  margin: 0.25rem 0;
+  border: none;
+  border-top: 1px solid var(--color-border);
+}
+
+// -----------------------------------------------------------------------------
+// Print Button
+// -----------------------------------------------------------------------------
+
+.print-button {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  padding: 0.5rem 1rem;
+  font-size: var(--text-sm);
+  font-weight: var(--font-medium);
+  color: var(--color-text-secondary);
+  background: var(--color-bg-surface);
+  border: 1px solid var(--color-border);
+  border-radius: 8px;
+  cursor: pointer;
+  transition: all 0.2s ease;
+
+  svg {
+    width: 16px;
+    height: 16px;
+  }
+
+  &:hover {
+    border-color: var(--color-accent);
+    color: var(--color-text);
+    background: var(--color-bg-overlay);
+  }
+}
+
+// -----------------------------------------------------------------------------
+// Nav Overlay (Mobile Menu)
+// -----------------------------------------------------------------------------
+
+.nav-overlay {
+  position: fixed;
+  inset: 0;
+  z-index: 1000;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  opacity: 0;
+  visibility: hidden;
+  transition: all 0.3s ease;
+
+  &[aria-hidden="false"] {
+    opacity: 1;
+    visibility: visible;
+
+    .nav-overlay__panel {
+      transform: scale(1);
+    }
+  }
+}
+
+.nav-overlay__backdrop {
+  position: absolute;
+  inset: 0;
+  background: rgba(0, 0, 0, 0.8);
+  backdrop-filter: blur(8px);
+}
+
+.nav-overlay__panel {
+  position: relative;
+  width: 90%;
+  max-width: 400px;
+  max-height: 80vh;
+  background: var(--color-bg);
+  border-radius: 20px;
+  box-shadow: var(--shadow-xl);
+  overflow: hidden;
+  display: flex;
+  flex-direction: column;
+  transform: scale(0.9);
+  transition: transform 0.3s cubic-bezier(0.34, 1.56, 0.64, 1);
+}
+
+.nav-overlay__header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 1.5rem 2rem;
+  border-bottom: 1px solid var(--color-border);
+}
+
+.nav-overlay__title {
+  font-size: var(--text-lg);
+  font-weight: var(--font-semibold);
+  color: var(--color-text);
+}
+
+.nav-overlay__close {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 40px;
+  height: 40px;
+  color: var(--color-text-secondary);
+  background: var(--color-bg-surface);
+  border-radius: 10px;
+  cursor: pointer;
+  transition: all 0.2s ease;
+
+  &:hover {
+    color: var(--color-text);
+    background: var(--ctp-red);
+    color: var(--ctp-base);
+  }
+
+  svg {
+    width: 20px;
+    height: 20px;
+  }
+}
+
+.nav-overlay__nav {
+  flex: 1;
+  overflow-y: auto;
+  padding: 1rem 0;
+}
+
+.nav-overlay__list {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+}
+
+.nav-overlay__item {
+  margin: 0;
+}
+
+.nav-overlay__link {
+  display: block;
+  padding: 1rem 2rem;
+  font-size: var(--text-lg);
+  font-weight: var(--font-medium);
+  color: var(--color-text-secondary);
+  text-decoration: none;
+  transition: all 0.2s ease;
+  border-left: 3px solid transparent;
+
+  &:hover {
+    background: var(--color-bg-surface);
+    color: var(--color-text);
+    border-left-color: var(--color-accent);
+  }
+
+  &--active {
+    background: rgba(203, 166, 247, 0.1);
+    color: var(--color-accent);
+    border-left-color: var(--color-accent);
+  }
+}
+
+.nav-overlay__footer {
+  padding: 1.5rem 2rem;
+  border-top: 1px solid var(--color-border);
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+}
+
+.nav-overlay__theme {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+
+.nav-overlay__theme-label {
+  font-size: var(--text-sm);
+  font-weight: var(--font-medium);
+  color: var(--color-text-secondary);
+}
+
+.nav-overlay__github {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  padding: 0.75rem 1rem;
+  font-size: var(--text-sm);
+  font-weight: var(--font-medium);
+  color: var(--color-text-secondary);
+  background: var(--color-bg-surface);
+  border-radius: 10px;
+  transition: all 0.2s ease;
+
+  &:hover {
+    color: var(--color-text);
+    background: var(--color-bg-overlay);
+    text-decoration: none;
+  }
+
+  svg {
+    width: 20px;
+    height: 20px;
+  }
+}
+
+// -----------------------------------------------------------------------------
+// Page ToC Toggle Button (Fixed, top-right corner)
+// -----------------------------------------------------------------------------
+
+.page-toc-toggle {
+  position: fixed;
+  top: 96px; // Below header + progress bar
+  right: 1.5rem;
+  z-index: 103; // Above progress bar
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 32px;
+  height: 32px;
+  color: var(--color-text-muted);
+  background: var(--color-bg);
+  border: 1px solid var(--color-border);
+  border-radius: 6px;
+  cursor: pointer;
+  transition: all 0.2s ease;
+  opacity: 0.7;
+
+  &:hover {
+    opacity: 1;
+    color: var(--color-text);
+    border-color: var(--color-text-muted);
+  }
+
+  // Hide when ToC is open (the panel has its own close button)
+  &[aria-expanded="true"] {
+    display: none;
+  }
+
+  // Hide on mobile
+  @media (max-width: 1023px) {
+    display: none;
+  }
+}
+
+.page-toc-toggle__icon {
+  width: 16px;
+  height: 16px;
+
+  &--close {
+    display: none; // Not used since button hides when expanded
+  }
+}
+
+// -----------------------------------------------------------------------------
+// Page ToC Panel (Right Sidebar)
+// -----------------------------------------------------------------------------
+
+.page-toc-panel {
+  // Hidden by default
+  display: none;
+  width: 0;
+  overflow: hidden;
+  transition: width 0.25s ease;
+
+  // When open, show as right sidebar
+  &[aria-hidden="false"] {
+    display: block;
+    width: 260px;
+    overflow: visible;
+
+    @media (min-width: 1280px) {
+      width: 280px;
+    }
+  }
+
+  // Hide on mobile - will use overlay instead
+  @media (max-width: 1023px) {
+    display: none !important;
+  }
+}
+
+.page-toc-panel__backdrop {
+  display: none; // No backdrop for push layout
+}
+
+.page-toc-panel__content {
+  position: sticky;
+  top: 84px; // Below header + progress bar
+  max-height: calc(100vh - 100px);
+  overflow-y: auto;
+  padding: 1rem 0;
+  border-left: 1px solid var(--color-border);
+}
+
+.page-toc-panel__header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 0 1rem 0.75rem;
+  margin-bottom: 0.5rem;
+}
+
+.page-toc-panel__title {
+  font-size: var(--text-xs);
+  font-weight: var(--font-semibold);
+  color: var(--color-text-muted);
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  margin: 0;
+}
+
+.page-toc-panel__close {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 24px;
+  height: 24px;
+  color: var(--color-text-muted);
+  background: transparent;
+  border: none;
+  border-radius: 4px;
+  cursor: pointer;
+  transition: all 0.15s ease;
+
+  &:hover {
+    background: var(--color-bg-surface);
+    color: var(--color-text);
+  }
+
+  svg {
+    width: 14px;
+    height: 14px;
+  }
+}
+
+.page-toc-panel__nav {
+  padding: 0;
+}
+
+.page-toc-panel__list {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+}
+
+.page-toc-panel__list--nested {
+  margin-left: 0.75rem;
+  padding-left: 0.75rem;
+  border-left: 1px solid var(--color-border);
+}
+
+.page-toc-panel__item {
+  position: relative;
+}
+
+.page-toc-panel__link {
+  display: block;
+  padding: 0.35rem 1rem;
+  font-size: 0.8125rem;
+  line-height: 1.4;
+  color: var(--color-text-secondary);
+  transition: all 0.15s ease;
+  border-left: 2px solid transparent;
+  margin-left: -1px;
+
+  &:hover {
+    color: var(--color-text);
+    text-decoration: none;
+  }
+
+  &.active {
+    color: var(--color-accent);
+    border-left-color: var(--color-accent);
+  }
+}
+
+// Nested links
+.page-toc-panel__list--nested .page-toc-panel__link {
+  padding: 0.25rem 0.75rem;
+  font-size: 0.75rem;
+}
+
+// -----------------------------------------------------------------------------
+// Scroll Progress Indicator
+// -----------------------------------------------------------------------------
+
+.scroll-progress {
+  position: fixed;
+  left: 0;
+  // JS dynamically sets left, width, and top based on sidebar and header
+  width: 100vw;
+  top: 57px;
+  z-index: 102;
+  height: 2px;
+  background: transparent;
+  pointer-events: none;
+}
+
+.scroll-progress__bar {
+  height: 100%;
+  width: 0%;
+  background: linear-gradient(
+    90deg,
+    var(--ctp-pink) 0%,
+    var(--ctp-mauve) 25%,
+    var(--ctp-blue) 50%,
+    var(--ctp-sapphire) 75%,
+    var(--ctp-teal) 100%
+  );
+  transition: width 0.1s ease-out;
+
+  // Softer gradient for light theme
+  [data-theme="light"] & {
+    background: linear-gradient(
+      90deg,
+      var(--ctp-pink) 0%,
+      var(--ctp-lavender) 25%,
+      var(--ctp-sky) 50%,
+      var(--ctp-sapphire) 75%,
+      var(--ctp-teal) 100%
+    );
+    opacity: 0.8;
+  }
+}
+
+.scroll-progress__percent {
+  position: absolute;
+  left: 0;
+  top: 100%;
+  margin-top: 0.35rem;
+  font-family: var(--font-mono);
+  font-size: 0.625rem;
+  font-weight: var(--font-medium);
+  color: var(--color-text-muted);
+  background: transparent;
+  padding: 0;
+  min-width: 2rem;
+  text-align: left;
+  opacity: 0;
+  visibility: hidden;
+  transition: opacity 0.2s ease, visibility 0.2s ease, left 0.1s ease-out;
+  font-variant-numeric: tabular-nums;
+  pointer-events: none;
+
+  // Show when scrolled past threshold
+  .scroll-progress--active & {
+    opacity: 1;
+    visibility: visible;
+  }
+}