/* NineBoxView Pro - Guide Styles
   Extends the main styles.css for documentation pages
*/

/* === Reading Progress Bar === */
.reading-progress {
  position: fixed;
  top: 0;
  left: 0;
  height: 2px;
  width: 0;
  background: linear-gradient(90deg, var(--color-text-secondary), var(--color-text));
  z-index: 1000;
  transition: width 50ms linear;
}

@media (prefers-reduced-motion: reduce) {
  .reading-progress {
    transition: none;
  }
}

/* === Skip to Content (Accessibility) === */
.skip-to-content {
  position: absolute;
  top: -100%;
  left: 50%;
  transform: translateX(-50%);
  padding: 0.75rem 1.5rem;
  background-color: var(--color-text);
  color: var(--color-bg);
  text-decoration: none;
  font-weight: 500;
  border-radius: 0 0 8px 8px;
  z-index: 1000;
  transition: top var(--transition-fast);
}

.skip-to-content:focus {
  top: 0;
  outline: none;
}

/* === Focus States Enhancement === */
.guide-page :focus-visible {
  outline: 2px solid var(--color-accent);
  outline-offset: 2px;
}

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

.guide-page button:focus-visible {
  outline: 2px solid var(--color-accent);
  outline-offset: 2px;
}

/* === Language-specific Font Override ===
   避免瀏覽器嘗試載入未引入的 Noto Sans 變體，造成字體跳動
*/
html[lang="zh-Hant"] { --font-sans: 'IBM Plex Sans', 'Noto Sans TC', system-ui, sans-serif; }
html[lang="zh-Hans"] { --font-sans: 'IBM Plex Sans', 'Noto Sans SC', system-ui, sans-serif; }
html[lang="ja"]      { --font-sans: 'IBM Plex Sans', 'Noto Sans JP', system-ui, sans-serif; }
html[lang="ko"]      { --font-sans: 'IBM Plex Sans', 'Noto Sans KR', system-ui, sans-serif; }
html[lang="en"]      { --font-sans: 'IBM Plex Sans', system-ui, sans-serif; }

/* === Guide Layout === */

/* 說明書頁面的主題完全由 [data-theme] 控制，不受系統 prefers-color-scheme 影響
   這裡重新定義 CSS 變數，覆蓋 styles.css 中的 @media (prefers-color-scheme: dark) 規則
*/

/* 淺色模式（預設）*/
.guide-page,
[data-theme="light"] .guide-page {
  --color-bg: #f8f6f0;
  --color-text: #4a4a4a;
  --color-text-secondary: #6a6a6a;
  --color-border: #d4d4d4;
  --color-accent: #2a2a2a;
}

/* 深色模式（由切換按鈕控制）*/
[data-theme="dark"] .guide-page {
  --color-bg: #1a1a1a;
  --color-text: #e8e6e0;  /* 降低亮度減少光暈效應 */
  --color-text-secondary: #b0b0b0;
  --color-border: #3a3a3a;
  --color-accent: #e0e0e0;
}

/* 確保 body 背景色也跟隨 */
.guide-page {
  background-color: var(--color-bg);
  color: var(--color-text);
}

/* === Translation Banner === */
.translation-banner {
  background-color: rgba(0, 0, 0, 0.03);
  color: var(--color-text-secondary);
  text-align: center;
  padding: 0.5rem 1rem;
  font-size: 0.85rem;
}

[data-theme="dark"] .translation-banner {
  background-color: rgba(255, 255, 255, 0.05);
}

.translation-banner a {
  color: var(--color-text);
  text-decoration: underline;
  text-underline-offset: 2px;
}

.translation-banner a:hover {
  color: var(--color-accent);
}

/* === Override styles.css @media prefers-color-scheme for guide pages ===
   說明書只受 [data-theme] 控制，不受系統模式影響
*/
.guide-page .lang-dropdown {
  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);
}

.guide-page .lang-dropdown a:hover {
  background-color: rgba(0, 0, 0, 0.05);
}

[data-theme="dark"] .guide-page .lang-dropdown {
  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.3);
}

[data-theme="dark"] .guide-page .lang-dropdown a:hover {
  background-color: rgba(255, 255, 255, 0.1);
}

.guide__container {
  display: grid;
  grid-template-columns: 220px 1fr;
  gap: var(--spacing-lg);
  max-width: 72rem;
  margin: 0 auto;
  padding: var(--spacing-md);
}

/* === Sidebar Navigation === */
.guide__sidebar {
  position: sticky;
  top: calc(60px + var(--spacing-md));
  height: fit-content;
  max-height: calc(100vh - 100px);
  overflow-y: auto;
  scrollbar-gutter: stable;
  padding-right: var(--spacing-sm);
}

.guide__nav {
  display: flex;
  flex-direction: column;
  gap: 2px;
}

.guide__nav a {
  display: block;
  padding: var(--spacing-xs) var(--spacing-sm);
  color: var(--color-text-secondary);
  text-decoration: none;
  font-size: 0.875rem;
  border-radius: 4px;
  transition: background-color var(--transition-fast), color var(--transition-fast);
}

.guide__nav a:hover {
  color: var(--color-text);
  background-color: rgba(0, 0, 0, 0.05);
  opacity: 1;
}

.guide__nav a.active {
  color: var(--color-text);
  background-color: rgba(0, 0, 0, 0.08);
  font-weight: 500;
}

[data-theme="dark"] .guide__nav a:hover {
  background-color: rgba(255, 255, 255, 0.05);
}

[data-theme="dark"] .guide__nav a.active {
  background-color: rgba(255, 255, 255, 0.1);
}

[data-theme="light"] .guide__nav a:hover {
  background-color: rgba(0, 0, 0, 0.05);
}

[data-theme="light"] .guide__nav a.active {
  background-color: rgba(0, 0, 0, 0.08);
}

/* === Main Content === */
.guide__content {
  min-width: 0; /* Prevent overflow */
  padding-bottom: var(--spacing-xl);
}

/* H1：漸層淡出底線（模擬書法墨跡） */
.guide__content h1 {
  font-size: 2rem;
  margin-bottom: var(--spacing-md);
  padding-bottom: var(--spacing-sm);
  border-bottom: none;
  position: relative;
}

.guide__content h1::after {
  content: '';
  position: absolute;
  bottom: 0;
  left: 0;
  width: 100%;
  height: 1px;
  background: linear-gradient(90deg, var(--color-text) 0%, var(--color-text) 30%, transparent 100%);
  opacity: 0.3;
}

/* H2：左側色條標記 */
.guide__content h2 {
  font-size: 1.5rem;
  margin-top: var(--spacing-lg);
  margin-bottom: var(--spacing-sm);
  scroll-margin-top: 80px;
  padding-left: var(--spacing-sm);
  border-left: 4px solid var(--color-text);
  position: relative;
}

/* H2 左側色條漸層效果 */
.guide__content h2::before {
  content: '';
  position: absolute;
  left: 0;
  top: 0;
  bottom: 0;
  width: 4px;
  background: linear-gradient(180deg, var(--color-text) 0%, var(--color-text-secondary) 100%);
  border-radius: 2px;
  margin-left: -4px;
}

.guide__content h2 {
  border-left: none;
}

/* H3：調整字重而非尺寸 */
.guide__content h3 {
  font-size: 1.125rem;
  font-weight: 600;
  margin-top: var(--spacing-md);
  margin-bottom: var(--spacing-xs);
  scroll-margin-top: 80px;
  letter-spacing: 0.02em;
}

.guide__content p {
  margin-bottom: var(--spacing-sm);
  line-height: 1.7;
}

.guide__content ul,
.guide__content ol {
  margin-bottom: var(--spacing-sm);
  padding-left: 1.5rem;
}

.guide__content li {
  margin-bottom: 0.25rem;
  line-height: 1.6;
}

/* === Video & Image Embeds === */
.guide__content img {
  max-width: 100%;
  height: auto;
  border-radius: 8px;
  margin: var(--spacing-md) 0;
  display: block;
}

.guide__content video {
  max-width: 540px;
  width: 100%;
  height: auto;
  border-radius: 8px;
  margin: var(--spacing-md) auto;
  display: block;
  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.08);
  border: 1px solid var(--color-border);
}

/* === Table Styles (Responsive Wrapper) === */
.table-wrapper {
  overflow-x: auto;
  margin: var(--spacing-md) 0;
  -webkit-overflow-scrolling: touch;
}

.guide__content table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.9375rem;
  margin: 0;
}

/* 沒有 wrapper 的表格保留原始 margin */
.guide__content > table {
  margin: var(--spacing-md) 0;
}

.guide__content th,
.guide__content td {
  padding: var(--spacing-xs) var(--spacing-sm);
  border: 1px solid var(--color-border);
  text-align: left;
  vertical-align: top;
  white-space: nowrap;
}

/* 允許特定欄位換行 */
.guide__content td:last-child {
  white-space: normal;
}

.guide__content th {
  background-color: rgba(0, 0, 0, 0.03);
  font-weight: 500;
}

[data-theme="dark"] .guide__content th {
  background-color: rgba(255, 255, 255, 0.05);
}

[data-theme="light"] .guide__content th {
  background-color: rgba(0, 0, 0, 0.03);
}

/* === Code Blocks === */
.guide__content pre {
  background-color: rgba(0, 0, 0, 0.05);
  padding: var(--spacing-sm);
  border-radius: 6px;
  overflow-x: auto;
  font-family: var(--font-mono);
  font-size: 0.875rem;
  line-height: 1.5;
  margin: var(--spacing-md) 0;
}

[data-theme="dark"] .guide__content pre {
  background-color: #252525;
}

[data-theme="light"] .guide__content pre {
  background-color: rgba(0, 0, 0, 0.05);
}

.guide__content code {
  font-family: var(--font-mono);
  font-size: 0.875em;
  background-color: rgba(0, 0, 0, 0.05);
  padding: 0.1em 0.4em;
  border-radius: 3px;
}

[data-theme="dark"] .guide__content code {
  background-color: rgba(255, 255, 255, 0.1);
}

[data-theme="light"] .guide__content code {
  background-color: rgba(0, 0, 0, 0.05);
}

.guide__content pre code {
  background: none;
  padding: 0;
  font-size: inherit;
}

/* === GitHub-style Alerts (Enhanced) === */
.alert {
  padding: var(--spacing-sm) var(--spacing-md);
  border-radius: 8px;
  margin: var(--spacing-md) 0;
  border-left: 4px solid;
  position: relative;
  overflow: hidden;
}

/* 微妙的漸層背景 */
.alert::before {
  content: '';
  position: absolute;
  top: 0;
  left: 0;
  right: 0;
  bottom: 0;
  opacity: 0.5;
  pointer-events: none;
  z-index: 0;
}

.alert > * {
  position: relative;
  z-index: 1;
}

.alert p {
  margin: 0;
}

.alert p + p {
  margin-top: var(--spacing-xs);
}

/* 入場動畫 */
@keyframes alertFadeIn {
  from {
    opacity: 0;
    transform: translateY(8px);
  }
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

.alert {
  animation: alertFadeIn 0.3s ease-out;
}

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

.alert--note {
  background: linear-gradient(135deg, rgba(0, 122, 204, 0.08) 0%, rgba(0, 122, 204, 0.04) 100%);
  border-color: #007acc;
}

.alert--tip {
  background: linear-gradient(135deg, rgba(0, 153, 51, 0.08) 0%, rgba(0, 153, 51, 0.04) 100%);
  border-color: #009933;
}

.alert--caution {
  background: linear-gradient(135deg, rgba(204, 102, 0, 0.08) 0%, rgba(204, 102, 0, 0.04) 100%);
  border-color: #cc6600;
}

.alert--warning {
  background: linear-gradient(135deg, rgba(204, 51, 0, 0.08) 0%, rgba(204, 51, 0, 0.04) 100%);
  border-color: #cc3300;
}

[data-theme="dark"] .alert--note {
  background-color: rgba(0, 122, 204, 0.15);
}
[data-theme="dark"] .alert--tip {
  background-color: rgba(0, 153, 51, 0.15);
}
[data-theme="dark"] .alert--caution {
  background-color: rgba(204, 102, 0, 0.15);
}
[data-theme="dark"] .alert--warning {
  background-color: rgba(204, 51, 0, 0.15);
}

[data-theme="light"] .alert--note {
  background-color: rgba(0, 122, 204, 0.08);
}
[data-theme="light"] .alert--tip {
  background-color: rgba(0, 153, 51, 0.08);
}
[data-theme="light"] .alert--caution {
  background-color: rgba(204, 102, 0, 0.08);
}
[data-theme="light"] .alert--warning {
  background-color: rgba(204, 51, 0, 0.08);
}

/* Alert title styling */
.alert__title {
  font-weight: 600;
  margin-bottom: var(--spacing-xs);
  display: flex;
  align-items: center;
  gap: 0.5em;
}

.alert--note .alert__title {
  color: #007acc;
}

.alert--tip .alert__title {
  color: #009933;
}

.alert--caution .alert__title {
  color: #cc6600;
}

.alert--warning .alert__title {
  color: #cc3300;
}

[data-theme="dark"] .alert--note .alert__title {
  color: #4db8ff;
}
[data-theme="dark"] .alert--tip .alert__title {
  color: #4dff88;
}
[data-theme="dark"] .alert--caution .alert__title {
  color: #ffb84d;
}
[data-theme="dark"] .alert--warning .alert__title {
  color: #ff6b4d;
}

[data-theme="light"] .alert--note .alert__title {
  color: #007acc;
}
[data-theme="light"] .alert--tip .alert__title {
  color: #009933;
}
[data-theme="light"] .alert--caution .alert__title {
  color: #cc6600;
}
[data-theme="light"] .alert--warning .alert__title {
  color: #cc3300;
}

/* === Inline SVG Icons (Phosphor Icons) === */
.icon {
  width: 1em;
  height: 1em;
  vertical-align: -0.125em;
  display: inline-block;
  fill: currentColor;
  flex-shrink: 0;
}

/* 表格內的圖示稍大 */
td .icon {
  width: 1.2em;
  height: 1.2em;
}

/* Alert 標題內的圖示 */
.alert__title .icon {
  width: 1.1em;
  height: 1.1em;
  margin-right: 0.3em;
}

/* 缺失圖示的後備樣式 */
.icon-missing {
  color: #ff6b4d;
  font-size: 0.8em;
}

/* === Links (Animated Underline) === */
.guide__content a {
  color: var(--color-text);
  text-decoration: none;
  position: relative;
  display: inline;
}

/* 底線從左向右展開動畫 */
.guide__content a::after {
  content: '';
  position: absolute;
  bottom: -1px;
  left: 0;
  width: 0;
  height: 1px;
  background-color: var(--color-text);
  transition: width var(--transition-fast);
}

.guide__content a:hover::after {
  width: 100%;
}

.guide__content a:hover {
  opacity: 0.85;
}

@media (prefers-reduced-motion: reduce) {
  .guide__content a::after {
    transition: none;
    width: 100%;
    opacity: 0.5;
  }
}

/* === Mobile Navigation Toggle === */
.mobile-nav-backdrop {
  display: none;
}

.mobile-nav-toggle {
  display: none;
  position: fixed;
  bottom: 1rem;
  left: 1rem;
  width: 48px;
  height: 48px;
  border-radius: 50%;
  border: 1px solid var(--color-border);
  background-color: var(--color-bg);
  color: var(--color-text);
  cursor: pointer;
  align-items: center;
  justify-content: center;
  box-shadow: 0 2px 12px rgba(0, 0, 0, 0.15);
  z-index: 60;
  transition: background-color var(--transition-fast), color var(--transition-fast), transform var(--transition-fast);
}

/* 僅在支援 hover 的裝置上顯示 hover 效果 */
@media (hover: hover) {
  .mobile-nav-toggle:hover {
    border-color: var(--color-text-secondary);
  }
}

.mobile-nav-toggle:active {
  transform: scale(0.95);
}

.mobile-nav-toggle__icon--close {
  display: none;
}

.mobile-nav-toggle[aria-expanded="true"] .mobile-nav-toggle__icon--menu {
  display: none;
}

.mobile-nav-toggle[aria-expanded="true"] .mobile-nav-toggle__icon--close {
  display: block;
}

[data-theme="dark"] .mobile-nav-toggle {
  box-shadow: 0 2px 12px rgba(0, 0, 0, 0.4);
}

/* === Responsive Design === */
@media (max-width: 768px) {
  .mobile-nav-toggle {
    display: flex;
  }

  .guide__container {
    grid-template-columns: 1fr;
    gap: var(--spacing-md);
  }

  /* 手機版導航遮罩（獨立元素） */
  .mobile-nav-backdrop {
    position: fixed;
    top: 60px;
    left: 0;
    right: 0;
    bottom: 0;
    background-color: rgba(0, 0, 0, 0.4);
    opacity: 0;
    visibility: hidden;
    transition: opacity var(--transition-normal), visibility var(--transition-normal);
    z-index: 55;
    pointer-events: none;
  }

  .mobile-nav-backdrop.is-visible {
    opacity: 1;
    visibility: visible;
    pointer-events: auto;
  }

  .guide__sidebar {
    position: fixed;
    top: 60px;
    left: 0;
    width: 280px;
    max-width: 85vw;
    bottom: 0;
    background-color: #f8f6f0;
    border-bottom: none;
    padding: var(--spacing-md);
    margin-bottom: 0;
    max-height: calc(100vh - 60px);
    overflow-y: auto;
    transform: translateX(-100%);
    visibility: hidden;
    transition: transform var(--transition-normal), visibility var(--transition-normal);
    z-index: 60;
    box-shadow: 2px 0 8px rgba(0, 0, 0, 0.1);
  }

  .guide__sidebar.is-open {
    transform: translateX(0);
    visibility: visible;
  }

  /* 深色模式下的側邊欄背景 */
  [data-theme="dark"] .guide__sidebar {
    background-color: #1a1a1a;
    box-shadow: 2px 0 8px rgba(0, 0, 0, 0.3);
  }

  .guide__nav {
    flex-direction: column;
    gap: var(--spacing-xs);
  }

  .guide__nav a {
    padding: var(--spacing-sm) var(--spacing-md);
    font-size: 1rem;
  }

  /* 尊重減少動態效果偏好 */
  @media (prefers-reduced-motion: reduce) {
    .guide__sidebar {
      transition: none;
    }
  }
}

/* 保留原始 768px 以下的樣式（作為備用） */
@media (max-width: 768px) {
  .guide__content h1 {
    font-size: 1.75rem;
  }

  .guide__content h2 {
    font-size: 1.25rem;
  }
}

/* === Language Bar (for guide pages) === */
.guide__lang-bar {
  display: flex;
  gap: var(--spacing-sm);
  padding: var(--spacing-sm) 0;
  margin-bottom: var(--spacing-md);
  border-bottom: 1px solid var(--color-border);
  font-size: 0.875rem;
}

.guide__lang-bar a {
  color: var(--color-text-secondary);
  text-decoration: none;
}

.guide__lang-bar a:hover {
  color: var(--color-text);
}

.guide__lang-bar .active {
  font-weight: 500;
  color: var(--color-text);
}

/* === Breadcrumb === */
.guide__breadcrumb {
  font-size: 0.875rem;
  color: var(--color-text-secondary);
  margin-bottom: var(--spacing-sm);
}

.guide__breadcrumb a {
  color: var(--color-text-secondary);
}

.guide__breadcrumb a:hover {
  color: var(--color-text);
}

/* === Table of Contents (in-page) === */
.guide__toc {
  background-color: rgba(0, 0, 0, 0.02);
  padding: var(--spacing-sm) var(--spacing-md);
  border-radius: 6px;
  margin-bottom: var(--spacing-md);
}

[data-theme="dark"] .guide__toc {
  background-color: rgba(255, 255, 255, 0.03);
}

[data-theme="light"] .guide__toc {
  background-color: rgba(0, 0, 0, 0.02);
}

/* === Theme Toggle Button === */
#theme-toggle {
  background: none;
  border: none;
  cursor: pointer;
  padding: 0.25rem;
  color: var(--color-text-secondary);
  display: flex;
  align-items: center;
  justify-content: center;
  border-radius: 4px;
  transition: color var(--transition-fast), background-color var(--transition-fast);
}

#theme-toggle:hover {
  color: var(--color-text);
  background-color: rgba(0, 0, 0, 0.05);
}

[data-theme="dark"] #theme-toggle:hover {
  background-color: rgba(255, 255, 255, 0.1);
}

[data-theme="light"] #theme-toggle:hover {
  background-color: rgba(0, 0, 0, 0.05);
}

#theme-toggle svg {
  display: block;
}

/* Nav controls container (lang switcher + theme toggle) */
.nav__controls {
  display: flex;
  align-items: center;
  gap: var(--spacing-sm);
}

/* === Language Menu (custom dropdown) === */
.lang-menu {
  position: relative;
}

.lang-trigger {
  display: flex;
  align-items: center;
  gap: 0.25rem;
  padding: 0.25rem 0.5rem;
  border: 1px solid var(--color-border);
  border-radius: 4px;
  background: transparent;
  color: var(--color-text);
  font-size: 0.875rem;
  font-family: inherit;
  cursor: pointer;
  transition: border-color var(--transition-fast), background-color var(--transition-fast);
}

.lang-trigger:hover {
  border-color: var(--color-text);
}

.lang-chevron {
  transition: transform var(--transition-fast);
}

.lang-menu.open .lang-chevron {
  transform: rotate(180deg);
}

.lang-dropdown {
  display: none;
  position: absolute;
  top: 100%;
  right: 0;
  margin-top: 0.25rem;
  padding: 0.25rem 0;
  background: var(--color-bg);
  border: 1px solid var(--color-border);
  border-radius: 4px;
  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);
  list-style: none;
  min-width: 8rem;
  z-index: 200;
}

.lang-menu.open .lang-dropdown {
  display: block;
}

.lang-dropdown li {
  margin: 0;
}

.lang-dropdown a {
  display: block;
  padding: 0.5rem 1rem;
  color: var(--color-text);
  text-decoration: none;
  font-size: 0.875rem;
  white-space: nowrap;
  transition: background-color var(--transition-fast);
}

.lang-dropdown a[aria-current="page"] {
  font-weight: 500;
}

[data-theme="light"] .lang-dropdown {
  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);
}

[data-theme="light"] .lang-dropdown a:hover {
  background-color: rgba(0, 0, 0, 0.05);
}

[data-theme="dark"] .lang-dropdown {
  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.3);
}

[data-theme="dark"] .lang-dropdown a:hover {
  background-color: rgba(255, 255, 255, 0.1);
}

.guide__toc h4 {
  font-size: 0.875rem;
  font-weight: 500;
  margin-bottom: var(--spacing-xs);
}

.guide__toc ul {
  list-style: none;
  padding-left: 0;
  margin: 0;
}

.guide__toc li {
  margin-bottom: 0.25rem;
}

.guide__toc a {
  font-size: 0.875rem;
  color: var(--color-text-secondary);
  text-decoration: none;
}

.guide__toc a:hover {
  color: var(--color-text);
}

/* === Page Load Animation === */
@keyframes contentFadeIn {
  from {
    opacity: 0;
    transform: translateY(12px);
  }
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

/* 內容區元素交錯淡入 */
.guide__content > h1 {
  animation: contentFadeIn 0.4s ease-out both;
}

.guide__content > h2 {
  animation: contentFadeIn 0.4s ease-out 0.05s both;
}

.guide__content > h3 {
  animation: contentFadeIn 0.4s ease-out 0.08s both;
}

.guide__content > p,
.guide__content > ul,
.guide__content > ol,
.guide__content > .table-wrapper,
.guide__content > table,
.guide__content > .alert,
.guide__content > .code-block,
.guide__content > pre,
.guide__content > figure {
  animation: contentFadeIn 0.4s ease-out 0.1s both;
}

/* 側邊欄淡入 */
.guide__sidebar {
  animation: contentFadeIn 0.3s ease-out both;
}

/* 尊重減少動態效果偏好 */
@media (prefers-reduced-motion: reduce) {
  .guide__content > h1,
  .guide__content > h2,
  .guide__content > h3,
  .guide__content > p,
  .guide__content > ul,
  .guide__content > ol,
  .guide__content > .table-wrapper,
  .guide__content > table,
  .guide__content > .alert,
  .guide__content > .code-block,
  .guide__content > pre,
  .guide__content > figure,
  .guide__sidebar {
    animation: none;
  }
}

/* === Back to Top Button === */
.back-to-top {
  position: fixed;
  bottom: 2rem;
  right: 2rem;
  width: 44px;
  height: 44px;
  border-radius: 50%;
  border: 1px solid var(--color-border);
  background-color: var(--color-bg);
  color: var(--color-text-secondary);
  cursor: pointer;
  display: flex;
  align-items: center;
  justify-content: center;
  opacity: 0;
  visibility: hidden;
  transform: translateY(10px);
  transition: opacity var(--transition-fast), visibility var(--transition-fast), transform var(--transition-fast), background-color var(--transition-fast), color var(--transition-fast);
  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
  z-index: 50;
}

.back-to-top.is-visible {
  opacity: 1;
  visibility: visible;
  transform: translateY(0);
}

/* 僅在支援 hover 的裝置上顯示 hover 效果 */
@media (hover: hover) {
  .back-to-top:hover {
    border-color: var(--color-text-secondary);
  }
}

.back-to-top:focus-visible {
  outline: 2px solid var(--color-text);
  outline-offset: 2px;
}

[data-theme="dark"] .back-to-top {
  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.3);
}

@media (max-width: 768px) {
  .back-to-top {
    bottom: 1rem;
    right: 1rem;
    width: 40px;
    height: 40px;
  }
}

/* 尊重減少動態效果偏好 */
@media (prefers-reduced-motion: reduce) {
  .back-to-top {
    transition: none;
  }
}

/* === Code Block with Copy Button === */
.code-block {
  position: relative;
}

.code-block__copy {
  position: absolute;
  top: 0.5rem;
  right: 0.5rem;
  width: 32px;
  height: 32px;
  border-radius: 6px;
  border: 1px solid var(--color-border);
  background-color: var(--color-bg);
  color: var(--color-text-secondary);
  cursor: pointer;
  display: flex;
  align-items: center;
  justify-content: center;
  opacity: 0;
  transition: opacity var(--transition-fast), background-color var(--transition-fast), color var(--transition-fast);
}

.code-block:hover .code-block__copy {
  opacity: 1;
}

.code-block__copy:hover {
  background-color: var(--color-text);
  color: var(--color-bg);
  border-color: var(--color-text);
}

.code-block__copy.is-copied {
  background-color: #009933;
  color: white;
  border-color: #009933;
}

.code-block__copy:focus-visible {
  outline: 2px solid var(--color-text);
  outline-offset: 2px;
  opacity: 1;
}

/* 觸控裝置始終顯示複製按鈕 */
@media (hover: none) {
  .code-block__copy {
    opacity: 1;
  }
}

@media (prefers-reduced-motion: reduce) {
  .code-block__copy {
    transition: none;
  }
}