/*
Theme Name: ChordSongs
Theme URI: https://chordsongs.com
Author: ChordSongs
Author URI: https://chordsongs.com
Description: A modern chord search engine theme for finding songs by chord count, instrument, difficulty, genre, and progression. Features built-in SVG chord diagram rendering for guitar, ukulele, piano, mandolin, banjo, and harmonica.
Version: 1.0.0
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.4
License: GNU General Public License v2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Text Domain: chordsongs
Tags: music, chords, guitar, ukulele, piano, custom-menu, custom-logo, featured-images, theme-options
*/

/* ==========================================================================
   1. CSS Custom Properties
   ========================================================================== */

:root {
    /* Colors */
    --color-primary: #6366f1;
    --color-primary-hover: #4f46e5;
    --color-primary-light: #e0e7ff;
    --color-secondary: #0ea5e9;
    --color-secondary-hover: #0284c7;
    --color-accent: #f59e0b;
    --color-accent-hover: #d97706;

    /* Backgrounds */
    --color-bg: #ffffff;
    --color-bg-alt: #f8fafc;
    --color-surface: #ffffff;
    --color-surface-hover: #f1f5f9;
    --color-surface-raised: #ffffff;

    /* Text */
    --color-text: #1e293b;
    --color-text-secondary: #64748b;
    --color-text-muted: #94a3b8;
    --color-text-inverse: #ffffff;

    /* Borders */
    --color-border: #e2e8f0;
    --color-border-hover: #cbd5e1;

    /* Status */
    --color-success: #22c55e;
    --color-warning: #f59e0b;
    --color-error: #ef4444;

    /* Difficulty colors */
    --color-beginner: #22c55e;
    --color-easy: #84cc16;
    --color-intermediate: #f59e0b;
    --color-advanced: #ef4444;

    /* Typography */
    --font-heading: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
    --font-heading-serif: 'Instrument Serif', Georgia, 'Times New Roman', serif;
    --font-body: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
    --font-body-alt: 'DM Sans', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
    --font-mono: 'JetBrains Mono', 'Fira Code', Consolas, monospace;

    /* Font Sizes */
    --text-xs: 0.75rem;
    --text-sm: 0.875rem;
    --text-base: 1rem;
    --text-lg: 1.125rem;
    --text-xl: 1.25rem;
    --text-2xl: 1.5rem;
    --text-3xl: 1.875rem;
    --text-4xl: 2.25rem;
    --text-5xl: 3rem;

    /* Spacing */
    --space-1: 0.25rem;
    --space-2: 0.5rem;
    --space-3: 0.75rem;
    --space-4: 1rem;
    --space-5: 1.25rem;
    --space-6: 1.5rem;
    --space-8: 2rem;
    --space-10: 2.5rem;
    --space-12: 3rem;
    --space-16: 4rem;
    --space-20: 5rem;

    /* Borders */
    --radius-sm: 0.375rem;
    --radius-md: 0.5rem;
    --radius-lg: 0.75rem;
    --radius-xl: 1rem;
    --radius-full: 9999px;

    /* Shadows */
    --shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.05);
    --shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1);
    --shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);
    --shadow-xl: 0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1);

    /* Transitions */
    --transition-fast: 150ms ease;
    --transition-base: 250ms ease;
    --transition-slow: 350ms ease;

    /* Layout */
    --container-max: 1200px;
    --header-height: 64px;
}

/* ==========================================================================
   2. Dark Mode
   ========================================================================== */

[data-theme="dark"] {
    --color-bg: #0f172a;
    --color-bg-alt: #1e293b;
    --color-surface: #1e293b;
    --color-surface-hover: #334155;
    --color-surface-raised: #334155;
    --color-text: #f1f5f9;
    --color-text-secondary: #94a3b8;
    --color-text-muted: #64748b;
    --color-border: #334155;
    --color-border-hover: #475569;
    --color-primary-light: #312e81;
    --shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.2);
    --shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.3), 0 2px 4px -2px rgb(0 0 0 / 0.3);
    --shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.3), 0 4px 6px -4px rgb(0 0 0 / 0.3);
}

@media (prefers-color-scheme: dark) {
    body:not([data-theme="light"]) {
        --color-bg: #0f172a;
        --color-bg-alt: #1e293b;
        --color-surface: #1e293b;
        --color-surface-hover: #334155;
        --color-surface-raised: #334155;
        --color-text: #f1f5f9;
        --color-text-secondary: #94a3b8;
        --color-text-muted: #64748b;
        --color-border: #334155;
        --color-border-hover: #475569;
        --color-primary-light: #312e81;
    }
}

/* ==========================================================================
   3. Reset & Base Styles
   ========================================================================== */

*,
*::before,
*::after {
    box-sizing: border-box;
    margin: 0;
    padding: 0;
}

html {
    scroll-behavior: smooth;
    -webkit-text-size-adjust: 100%;
}

body {
    font-family: var(--font-body);
    font-size: var(--text-base);
    line-height: 1.6;
    color: var(--color-text);
    background-color: var(--color-bg);
    -webkit-font-smoothing: antialiased;
    -moz-osx-font-smoothing: grayscale;
}

img {
    max-width: 100%;
    height: auto;
    display: block;
}

a {
    color: var(--color-primary);
    text-decoration: none;
    transition: color var(--transition-fast);
}

a:hover {
    color: var(--color-primary-hover);
}

button {
    cursor: pointer;
    font-family: inherit;
    border: none;
    background: none;
}

input,
select,
textarea {
    font-family: inherit;
    font-size: inherit;
}

ul,
ol {
    list-style: none;
}

/* Screen reader text */
.screen-reader-text {
    position: absolute;
    width: 1px;
    height: 1px;
    padding: 0;
    margin: -1px;
    overflow: hidden;
    clip: rect(0, 0, 0, 0);
    white-space: nowrap;
    border-width: 0;
}

.skip-link:focus {
    position: fixed;
    top: var(--space-2);
    left: var(--space-2);
    z-index: 100000;
    padding: var(--space-2) var(--space-4);
    background: var(--color-primary);
    color: var(--color-text-inverse);
    clip: auto;
    width: auto;
    height: auto;
    border-radius: var(--radius-md);
}

/* ==========================================================================
   4. Typography
   ========================================================================== */

h1, h2, h3, h4, h5, h6 {
    font-family: var(--font-heading);
    font-weight: 700;
    line-height: 1.25;
    color: var(--color-text);
}

h1 { font-size: var(--text-4xl); }
h2 { font-size: var(--text-3xl); }
h3 { font-size: var(--text-2xl); }
h4 { font-size: var(--text-xl); }
h5 { font-size: var(--text-lg); }
h6 { font-size: var(--text-base); }

p {
    margin-bottom: var(--space-4);
}

/* ==========================================================================
   5. Layout
   ========================================================================== */

.container {
    width: 100%;
    max-width: var(--container-max);
    margin: 0 auto;
    padding: 0 var(--space-4);
}

.site-content {
    min-height: calc(100vh - var(--header-height) - 300px);
}

.archive-layout {
    display: grid;
    grid-template-columns: 280px 1fr;
    gap: var(--space-8);
    align-items: start;
}

/* ==========================================================================
   6. Header & Navigation
   ========================================================================== */

.site-header {
    position: sticky;
    top: 0;
    z-index: 1000;
    background-color: var(--color-surface);
    border-bottom: 1px solid var(--color-border);
    height: var(--header-height);
    backdrop-filter: blur(12px);
}

.header-inner {
    display: flex;
    align-items: center;
    justify-content: space-between;
    height: var(--header-height);
    gap: var(--space-4);
}

.site-branding {
    flex-shrink: 0;
}

.site-title-link {
    display: flex;
    align-items: center;
    gap: var(--space-2);
    color: var(--color-text);
    font-weight: 800;
    font-size: var(--text-xl);
    text-decoration: none;
}

.site-title-link:hover {
    color: var(--color-primary);
}

.site-logo-icon {
    color: var(--color-primary);
    display: flex;
}

.main-navigation ul {
    display: flex;
    gap: var(--space-6);
}

.main-navigation a {
    color: var(--color-text-secondary);
    font-weight: 500;
    font-size: var(--text-sm);
    padding: var(--space-2) 0;
    transition: color var(--transition-fast);
}

.main-navigation a:hover,
.main-navigation .current-menu-item a {
    color: var(--color-primary);
}

.header-actions {
    display: flex;
    align-items: center;
    gap: var(--space-2);
}

.header-search-toggle,
.theme-toggle {
    display: flex;
    align-items: center;
    justify-content: center;
    width: 40px;
    height: 40px;
    border-radius: var(--radius-md);
    color: var(--color-text-secondary);
    transition: all var(--transition-fast);
}

.header-search-toggle:hover,
.theme-toggle:hover {
    background-color: var(--color-surface-hover);
    color: var(--color-text);
}

.theme-toggle .icon-moon {
    display: none;
}

[data-theme="dark"] .theme-toggle .icon-sun {
    display: none;
}

[data-theme="dark"] .theme-toggle .icon-moon {
    display: block;
}

.menu-toggle {
    display: none;
    flex-direction: column;
    gap: 5px;
    padding: var(--space-2);
}

.hamburger-line {
    display: block;
    width: 24px;
    height: 2px;
    background-color: var(--color-text);
    transition: all var(--transition-base);
}

.header-search-bar {
    display: none;
    background-color: var(--color-surface);
    border-bottom: 1px solid var(--color-border);
    padding: var(--space-4) 0;
}

.header-search-bar.search-bar-open {
    display: block;
}

/* ==========================================================================
   7. Hero / Search Section
   ========================================================================== */

.hero-section {
    padding: var(--space-20) 0 var(--space-16);
    text-align: center;
    background: linear-gradient(135deg, var(--color-primary-light) 0%, var(--color-bg) 100%);
}

.hero-title {
    font-size: var(--text-5xl);
    font-weight: 800;
    margin-bottom: var(--space-4);
    letter-spacing: -0.025em;
}

.hero-subtitle {
    font-size: var(--text-xl);
    color: var(--color-text-secondary);
    margin-bottom: var(--space-8);
    max-width: 600px;
    margin-left: auto;
    margin-right: auto;
}

.hero-search {
    max-width: 640px;
    margin: 0 auto var(--space-8);
}

.hero-quick-filters {
    display: flex;
    flex-wrap: wrap;
    justify-content: center;
    gap: var(--space-3);
}

.quick-filter-btn {
    display: inline-flex;
    align-items: center;
    padding: var(--space-2) var(--space-4);
    background-color: var(--color-surface);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-full);
    color: var(--color-text-secondary);
    font-size: var(--text-sm);
    font-weight: 500;
    transition: all var(--transition-fast);
}

.quick-filter-btn:hover {
    border-color: var(--color-primary);
    color: var(--color-primary);
    background-color: var(--color-primary-light);
}

/* ==========================================================================
   8. Search Form
   ========================================================================== */

.search-form {
    position: relative;
}

.search-input-wrapper {
    position: relative;
    display: flex;
    align-items: center;
}

.search-icon {
    position: absolute;
    left: var(--space-4);
    color: var(--color-text-muted);
    pointer-events: none;
    z-index: 1;
}

.search-field {
    width: 100%;
    padding: var(--space-4) var(--space-4) var(--space-4) 48px;
    background-color: var(--color-surface);
    border: 2px solid var(--color-border);
    border-radius: var(--radius-lg);
    font-size: var(--text-lg);
    color: var(--color-text);
    transition: border-color var(--transition-fast), box-shadow var(--transition-fast);
    outline: none;
}

.search-field:focus {
    border-color: var(--color-primary);
    box-shadow: 0 0 0 3px rgba(99, 102, 241, 0.15);
}

.search-field::placeholder {
    color: var(--color-text-muted);
}

.search-submit {
    position: absolute;
    right: var(--space-2);
    padding: var(--space-2) var(--space-5);
    background-color: var(--color-primary);
    color: var(--color-text-inverse);
    border: none;
    border-radius: var(--radius-md);
    font-weight: 600;
    font-size: var(--text-sm);
    cursor: pointer;
    transition: background-color var(--transition-fast);
}

.search-submit:hover {
    background-color: var(--color-primary-hover);
}

.search-suggestions {
    position: absolute;
    top: 100%;
    left: 0;
    right: 0;
    background-color: var(--color-surface);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    box-shadow: var(--shadow-lg);
    z-index: 100;
    margin-top: var(--space-1);
    max-height: 400px;
    overflow-y: auto;
}

.suggestion-item a {
    display: flex;
    align-items: center;
    gap: var(--space-3);
    padding: var(--space-3) var(--space-4);
    color: var(--color-text);
    transition: background-color var(--transition-fast);
}

.suggestion-item a:hover,
.suggestion-item.focused a {
    background-color: var(--color-surface-hover);
}

.suggestion-icon {
    flex-shrink: 0;
    color: var(--color-text-muted);
}

.suggestion-text {
    flex: 1;
    font-weight: 500;
}

.suggestion-artist {
    color: var(--color-text-secondary);
    font-size: var(--text-sm);
}

.suggestion-count {
    color: var(--color-text-muted);
    font-size: var(--text-xs);
}

/* ==========================================================================
   9. Song Cards
   ========================================================================== */

.songs-grid {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
    gap: var(--space-6);
}

.songs-list {
    display: flex;
    flex-direction: column;
    gap: var(--space-4);
}

.songs-list .song-card {
    display: flex;
}

.songs-list .song-card-body {
    flex-direction: row;
    align-items: center;
}

.song-card {
    background-color: var(--color-surface);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    overflow: hidden;
    transition: all var(--transition-base);
}

.song-card:hover {
    border-color: var(--color-primary);
    box-shadow: var(--shadow-md);
    transform: translateY(-2px);
}

.song-card-link {
    display: flex;
    flex-direction: column;
    color: var(--color-text);
    text-decoration: none;
    height: 100%;
}

.song-card-thumb {
    aspect-ratio: 4/3;
    overflow: hidden;
}

.song-card-thumb img {
    width: 100%;
    height: 100%;
    object-fit: cover;
    transition: transform var(--transition-slow);
}

.song-card:hover .song-card-thumb img {
    transform: scale(1.05);
}

.song-card-body {
    padding: var(--space-4);
    display: flex;
    flex-direction: column;
    gap: var(--space-2);
    flex: 1;
}

.song-card-title {
    font-size: var(--text-lg);
    font-weight: 600;
    line-height: 1.3;
}

.song-card-artist {
    color: var(--color-text-secondary);
    font-size: var(--text-sm);
}

.song-card-meta {
    display: flex;
    align-items: center;
    gap: var(--space-2);
    flex-wrap: wrap;
}

.song-card-chord-count {
    display: inline-flex;
    align-items: center;
    padding: 2px var(--space-2);
    background-color: var(--color-primary-light);
    color: var(--color-primary);
    border-radius: var(--radius-sm);
    font-size: var(--text-xs);
    font-weight: 600;
}

.song-card-difficulty {
    display: inline-flex;
    padding: 2px var(--space-2);
    border-radius: var(--radius-sm);
    font-size: var(--text-xs);
    font-weight: 600;
}

.song-card-chords {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-1);
}

.chord-mini-badge {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    padding: 2px 6px;
    background-color: var(--color-bg-alt);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-sm);
    font-family: var(--font-mono);
    font-size: var(--text-xs);
    font-weight: 500;
    min-width: 28px;
}

.chord-mini-more {
    background-color: var(--color-text-muted);
    color: var(--color-text-inverse);
    border-color: transparent;
}

.song-card-progression {
    margin-top: auto;
}

.progression-label {
    font-family: var(--font-mono);
    font-size: var(--text-xs);
    color: var(--color-text-muted);
}

.song-card-tags {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-1);
    margin-top: var(--space-1);
}

.song-card-tag {
    font-size: var(--text-xs);
    color: var(--color-text-muted);
    background-color: var(--color-bg-alt);
    padding: 1px 6px;
    border-radius: var(--radius-sm);
}

/* Difficulty color variants */
.difficulty-beginner { background-color: #dcfce7; color: #166534; }
.difficulty-easy { background-color: #ecfccb; color: #3f6212; }
.difficulty-intermediate { background-color: #fef3c7; color: #92400e; }
.difficulty-advanced { background-color: #fee2e2; color: #991b1b; }

[data-theme="dark"] .difficulty-beginner { background-color: #14532d; color: #86efac; }
[data-theme="dark"] .difficulty-easy { background-color: #365314; color: #bef264; }
[data-theme="dark"] .difficulty-intermediate { background-color: #78350f; color: #fde68a; }
[data-theme="dark"] .difficulty-advanced { background-color: #7f1d1d; color: #fca5a5; }

/* ==========================================================================
   10. Single Song Page
   ========================================================================== */

.single-song {
    padding: var(--space-8) 0 var(--space-16);
}

.breadcrumb {
    display: flex;
    align-items: center;
    gap: var(--space-2);
    font-size: var(--text-sm);
    color: var(--color-text-muted);
    margin-bottom: var(--space-6);
    flex-wrap: wrap;
}

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

.breadcrumb a:hover {
    color: var(--color-primary);
}

.breadcrumb-sep {
    color: var(--color-text-muted);
}

.breadcrumb-current {
    color: var(--color-text);
    font-weight: 500;
}

.song-header {
    margin-bottom: var(--space-8);
}

.song-title {
    font-size: var(--text-4xl);
    font-weight: 800;
    margin-bottom: var(--space-4);
    letter-spacing: -0.02em;
}

.song-meta-bar {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-4);
    align-items: center;
}

.song-meta-item {
    display: inline-flex;
    align-items: center;
    gap: var(--space-2);
    font-size: var(--text-sm);
    color: var(--color-text-secondary);
}

.song-meta-item svg {
    flex-shrink: 0;
}

.song-meta-difficulty {
    padding: 2px var(--space-3);
    border-radius: var(--radius-full);
    font-weight: 600;
}

.instrument-tabs {
    display: flex;
    gap: var(--space-1);
    margin-bottom: var(--space-6);
    border-bottom: 2px solid var(--color-border);
    padding-bottom: 0;
}

.instrument-tab {
    padding: var(--space-3) var(--space-5);
    font-weight: 500;
    color: var(--color-text-secondary);
    border-bottom: 2px solid transparent;
    margin-bottom: -2px;
    transition: all var(--transition-fast);
    font-size: var(--text-sm);
}

.instrument-tab:hover {
    color: var(--color-text);
}

.instrument-tab.active {
    color: var(--color-primary);
    border-bottom-color: var(--color-primary);
}

.song-chords-section,
.song-content-section {
    margin-bottom: var(--space-8);
}

.section-subtitle {
    font-size: var(--text-xl);
    margin-bottom: var(--space-4);
}

.chord-diagrams-strip {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-4);
    margin-bottom: var(--space-4);
}

.chord-badges {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-2);
}

.chord-badge {
    display: inline-flex;
    align-items: center;
    padding: var(--space-1) var(--space-3);
    background-color: var(--color-primary-light);
    color: var(--color-primary);
    border-radius: var(--radius-sm);
    font-family: var(--font-mono);
    font-size: var(--text-sm);
    font-weight: 600;
    transition: all var(--transition-fast);
}

a.chord-badge:hover {
    background-color: var(--color-primary);
    color: var(--color-text-inverse);
}

/* Progression display */
.song-progression {
    margin-bottom: var(--space-8);
    padding: var(--space-6);
    background-color: var(--color-bg-alt);
    border-radius: var(--radius-lg);
}

.song-progression-title {
    font-size: var(--text-lg);
    margin-bottom: var(--space-3);
}

.progression-roman {
    font-family: var(--font-mono);
    font-size: var(--text-2xl);
    font-weight: 700;
    color: var(--color-primary);
    margin-bottom: var(--space-3);
}

.progression-chords {
    display: flex;
    align-items: center;
    flex-wrap: wrap;
    gap: var(--space-2);
}

.progression-chord {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    padding: var(--space-2) var(--space-4);
    background-color: var(--color-surface);
    border: 2px solid var(--color-border);
    border-radius: var(--radius-md);
    font-family: var(--font-mono);
    font-weight: 600;
    font-size: var(--text-lg);
    min-width: 48px;
}

.progression-arrow {
    color: var(--color-text-muted);
    display: flex;
}

/* Strumming Pattern */
.song-strumming {
    margin-bottom: var(--space-8);
}

.song-strumming-title {
    font-size: var(--text-lg);
    margin-bottom: var(--space-3);
}

.strumming-pattern {
    display: flex;
    gap: var(--space-3);
}

.strumming-beat {
    display: flex;
    align-items: center;
    justify-content: center;
    width: 40px;
    height: 40px;
    border-radius: var(--radius-md);
    font-family: var(--font-mono);
    font-weight: 700;
    font-size: var(--text-lg);
    background-color: var(--color-bg-alt);
    border: 1px solid var(--color-border);
}

.strumming-down {
    background-color: var(--color-primary-light);
    color: var(--color-primary);
    border-color: var(--color-primary);
}

.strumming-up {
    background-color: #fef3c7;
    color: #92400e;
    border-color: #f59e0b;
}

[data-theme="dark"] .strumming-up {
    background-color: #78350f;
    color: #fde68a;
}

/* External link */
.song-external {
    margin-bottom: var(--space-8);
}

.external-link-btn {
    display: inline-flex;
    align-items: center;
    gap: var(--space-2);
    padding: var(--space-3) var(--space-5);
    background-color: var(--color-primary);
    color: var(--color-text-inverse);
    border-radius: var(--radius-md);
    font-weight: 600;
    transition: background-color var(--transition-fast);
}

.external-link-btn:hover {
    background-color: var(--color-primary-hover);
    color: var(--color-text-inverse);
}

/* Tags section */
.song-tags-section {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-4);
    margin-bottom: var(--space-12);
    padding-top: var(--space-6);
    border-top: 1px solid var(--color-border);
}

.instrument-tags,
.genre-tags {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-2);
}

.instrument-tag,
.genre-tag {
    padding: var(--space-1) var(--space-3);
    background-color: var(--color-bg-alt);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-full);
    font-size: var(--text-sm);
    color: var(--color-text-secondary);
    transition: all var(--transition-fast);
}

.instrument-tag:hover,
.genre-tag:hover {
    border-color: var(--color-primary);
    color: var(--color-primary);
}

/* Similar songs */
.similar-songs-section {
    margin-top: var(--space-12);
}

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

/* ==========================================================================
   11. Chord Diagrams (SVG)
   ========================================================================== */

.chord-diagram-wrapper {
    display: inline-flex;
    flex-direction: column;
    align-items: center;
}

.chord-diagram {
    display: block;
}

.chord-diagram--small { width: 80px; height: auto; }
.chord-diagram--medium { width: 120px; height: auto; }
.chord-diagram--large { width: 160px; height: auto; }

.chord-diagram__title {
    font-family: var(--font-heading);
    font-weight: 700;
    font-size: 14px;
    fill: var(--color-text);
}

.chord-diagram__nut {
    stroke: var(--color-text);
    stroke-width: 4;
}

.chord-diagram__fret {
    stroke: var(--color-border);
    stroke-width: 1;
}

.chord-diagram__string {
    stroke: var(--color-text-secondary);
    stroke-width: 1;
}

.chord-diagram__dot {
    fill: var(--color-text);
}

.chord-diagram__finger {
    fill: var(--color-text-inverse);
    font-size: 9px;
    font-weight: 700;
    font-family: var(--font-mono);
}

.chord-diagram__open {
    fill: none;
    stroke: var(--color-text);
    stroke-width: 1.5;
}

.chord-diagram__mute {
    fill: var(--color-text-muted);
    font-size: 12px;
    font-weight: 700;
}

.chord-diagram__barre {
    fill: var(--color-text);
    opacity: 0.85;
}

.chord-diagram__fret-number {
    fill: var(--color-text-secondary);
    font-size: 10px;
    font-family: var(--font-mono);
}

/* Piano keys */
.chord-diagram__white-key {
    fill: #ffffff;
    stroke: var(--color-border);
    stroke-width: 1;
}

.chord-diagram__black-key {
    fill: #1e293b;
}

.chord-diagram__key--active {
    fill: var(--color-primary-light);
    stroke: var(--color-primary);
    stroke-width: 2;
}

.chord-diagram__key--active-black {
    fill: var(--color-primary);
}

[data-theme="dark"] .chord-diagram__white-key {
    fill: #f1f5f9;
}

[data-theme="dark"] .chord-diagram__black-key {
    fill: #0f172a;
}

/* Harmonica */
.chord-diagram__harp-hole {
    fill: none;
    stroke: var(--color-border);
    stroke-width: 1;
}

.chord-diagram__harp-active-blow {
    fill: var(--color-primary-light);
}

.chord-diagram__harp-active-draw {
    fill: #fef3c7;
}

[data-theme="dark"] .chord-diagram__harp-active-draw {
    fill: #78350f;
}

.chord-diagram__harp-number {
    fill: var(--color-text-secondary);
    font-size: 8px;
    font-family: var(--font-mono);
}

/* ==========================================================================
   12. Filters & Sidebar
   ========================================================================== */

.sidebar-filters {
    background-color: var(--color-surface);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    padding: var(--space-5);
    position: sticky;
    top: calc(var(--header-height) + var(--space-4));
    max-height: calc(100vh - var(--header-height) - var(--space-8));
    overflow-y: auto;
}

.filters-header {
    display: flex;
    justify-content: space-between;
    align-items: center;
    margin-bottom: var(--space-5);
}

.filters-title {
    font-size: var(--text-lg);
    font-weight: 700;
}

.filters-reset {
    font-size: var(--text-sm);
    color: var(--color-primary);
    font-weight: 500;
    cursor: pointer;
}

.filters-reset:hover {
    color: var(--color-primary-hover);
}

.filter-group {
    border-bottom: 1px solid var(--color-border);
    padding-bottom: var(--space-4);
    margin-bottom: var(--space-4);
}

.filter-group:last-of-type {
    border-bottom: none;
    margin-bottom: 0;
}

.filter-group-title {
    display: flex;
    align-items: center;
    justify-content: space-between;
    font-size: var(--text-sm);
    font-weight: 600;
    color: var(--color-text);
    cursor: pointer;
    padding: var(--space-1) 0;
    user-select: none;
}

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

.filter-group-title[aria-expanded="false"] .filter-chevron {
    transform: rotate(-90deg);
}

.filter-group-content {
    margin-top: var(--space-3);
    display: flex;
    flex-direction: column;
    gap: var(--space-2);
}

.filter-checkbox {
    display: flex;
    align-items: center;
    gap: var(--space-2);
    cursor: pointer;
    font-size: var(--text-sm);
    padding: var(--space-1) 0;
}

.filter-checkbox input[type="checkbox"] {
    width: 16px;
    height: 16px;
    accent-color: var(--color-primary);
    cursor: pointer;
    flex-shrink: 0;
}

.filter-checkbox-label {
    flex: 1;
    color: var(--color-text-secondary);
}

.filter-count {
    font-size: var(--text-xs);
    color: var(--color-text-muted);
    background-color: var(--color-bg-alt);
    padding: 1px 6px;
    border-radius: var(--radius-full);
}

.chord-tags-filter {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-1);
}

.chord-tag-filter {
    cursor: pointer;
}

.chord-tag-filter input {
    display: none;
}

.chord-tag-label {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    padding: var(--space-1) var(--space-2);
    background-color: var(--color-bg-alt);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-sm);
    font-family: var(--font-mono);
    font-size: var(--text-xs);
    font-weight: 500;
    transition: all var(--transition-fast);
    min-width: 32px;
}

.chord-tag-filter input:checked + .chord-tag-label {
    background-color: var(--color-primary);
    color: var(--color-text-inverse);
    border-color: var(--color-primary);
}

.chord-tag-label:hover {
    border-color: var(--color-primary);
}

.filters-apply-btn {
    display: block;
    width: 100%;
    padding: var(--space-3) var(--space-4);
    background-color: var(--color-primary);
    color: var(--color-text-inverse);
    border: none;
    border-radius: var(--radius-md);
    font-weight: 600;
    font-size: var(--text-sm);
    cursor: pointer;
    transition: background-color var(--transition-fast);
    margin-top: var(--space-4);
}

.filters-apply-btn:hover {
    background-color: var(--color-primary-hover);
}

.mobile-filters-toggle {
    display: none;
    align-items: center;
    gap: var(--space-2);
    padding: var(--space-3) var(--space-4);
    background-color: var(--color-surface);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
    font-weight: 500;
    color: var(--color-text);
    margin-bottom: var(--space-4);
}

/* Active filters bar */
.active-filters {
    display: flex;
    align-items: center;
    flex-wrap: wrap;
    gap: var(--space-2);
    padding: var(--space-3) var(--space-4);
    background-color: var(--color-bg-alt);
    border-radius: var(--radius-md);
    margin-bottom: var(--space-6);
}

.active-filters-label {
    font-size: var(--text-sm);
    font-weight: 600;
    color: var(--color-text-secondary);
}

.active-filter-tags {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-1);
}

.active-filter-tag {
    display: inline-flex;
    align-items: center;
    gap: var(--space-1);
    padding: 2px var(--space-2) 2px var(--space-3);
    background-color: var(--color-primary-light);
    color: var(--color-primary);
    border-radius: var(--radius-full);
    font-size: var(--text-xs);
    font-weight: 500;
}

.remove-filter {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    width: 16px;
    height: 16px;
    border-radius: var(--radius-full);
    font-size: 14px;
    line-height: 1;
    color: var(--color-primary);
    cursor: pointer;
    transition: all var(--transition-fast);
}

.remove-filter:hover {
    background-color: var(--color-primary);
    color: var(--color-text-inverse);
}

.clear-all-filters {
    font-size: var(--text-xs);
    color: var(--color-error);
    font-weight: 500;
    cursor: pointer;
    margin-left: auto;
}

/* ==========================================================================
   13. Archive Page
   ========================================================================== */

.archive-header {
    margin-bottom: var(--space-6);
    padding: var(--space-8) 0 var(--space-4);
}

.archive-header .page-title {
    font-size: var(--text-3xl);
    margin-bottom: var(--space-2);
}

.archive-description {
    color: var(--color-text-secondary);
    font-size: var(--text-lg);
}

.results-toolbar {
    display: flex;
    justify-content: space-between;
    align-items: center;
    margin-bottom: var(--space-6);
    flex-wrap: wrap;
    gap: var(--space-3);
}

.results-count {
    font-size: var(--text-sm);
    color: var(--color-text-secondary);
}

.results-controls {
    display: flex;
    align-items: center;
    gap: var(--space-3);
}

.sort-select {
    padding: var(--space-2) var(--space-3);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
    background-color: var(--color-surface);
    color: var(--color-text);
    font-size: var(--text-sm);
    cursor: pointer;
}

.view-toggles {
    display: flex;
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
    overflow: hidden;
}

.view-toggle {
    display: flex;
    align-items: center;
    justify-content: center;
    padding: var(--space-2);
    color: var(--color-text-secondary);
    transition: all var(--transition-fast);
}

.view-toggle.active {
    background-color: var(--color-primary);
    color: var(--color-text-inverse);
}

.view-toggle:not(.active):hover {
    background-color: var(--color-surface-hover);
}

/* Loading indicator */
.loading-indicator {
    display: flex;
    flex-direction: column;
    align-items: center;
    justify-content: center;
    padding: var(--space-12);
    color: var(--color-text-muted);
}

.loading-spinner {
    width: 32px;
    height: 32px;
    border: 3px solid var(--color-border);
    border-top-color: var(--color-primary);
    border-radius: 50%;
    animation: spin 0.8s linear infinite;
    margin-bottom: var(--space-3);
}

@keyframes spin {
    to { transform: rotate(360deg); }
}

/* ==========================================================================
   14. Instruments Section (Homepage)
   ========================================================================== */

.instruments-section,
.categories-section,
.cta-section,
.recent-section,
.progressions-section {
    padding: var(--space-16) 0;
}

.instruments-section {
    background-color: var(--color-bg-alt);
}

.section-title {
    font-size: var(--text-2xl);
    font-weight: 700;
    margin-bottom: var(--space-8);
    text-align: center;
}

.section-header {
    display: flex;
    justify-content: space-between;
    align-items: center;
    margin-bottom: var(--space-8);
}

.section-header .section-title {
    margin-bottom: 0;
    text-align: left;
}

.view-all-link {
    font-size: var(--text-sm);
    font-weight: 600;
    color: var(--color-primary);
}

.instruments-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(160px, 1fr));
    gap: var(--space-4);
}

.instrument-card {
    display: flex;
    flex-direction: column;
    align-items: center;
    padding: var(--space-6) var(--space-4);
    background-color: var(--color-surface);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    text-align: center;
    color: var(--color-text);
    transition: all var(--transition-base);
}

.instrument-card:hover {
    border-color: var(--color-primary);
    box-shadow: var(--shadow-md);
    transform: translateY(-2px);
    color: var(--color-primary);
}

.instrument-icon {
    margin-bottom: var(--space-3);
    color: var(--color-primary);
}

.instrument-name {
    font-size: var(--text-base);
    font-weight: 600;
    margin-bottom: var(--space-1);
}

.instrument-count {
    font-size: var(--text-sm);
    color: var(--color-text-muted);
}

/* ==========================================================================
   15. Categories Grid (Homepage)
   ========================================================================== */

.categories-grid {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
    gap: var(--space-3);
}

.category-card {
    display: flex;
    align-items: center;
    justify-content: center;
    padding: var(--space-4) var(--space-5);
    background-color: var(--color-surface);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
    font-weight: 500;
    font-size: var(--text-sm);
    color: var(--color-text);
    text-align: center;
    transition: all var(--transition-fast);
}

.category-card:hover {
    border-color: var(--color-primary);
    color: var(--color-primary);
    background-color: var(--color-primary-light);
}

/* ==========================================================================
   16. CTA Section (Homepage)
   ========================================================================== */

.cta-card {
    display: grid;
    grid-template-columns: 1fr 1fr;
    gap: var(--space-8);
    padding: var(--space-10);
    background: linear-gradient(135deg, var(--color-primary) 0%, #4338ca 100%);
    border-radius: var(--radius-xl);
    color: var(--color-text-inverse);
    align-items: center;
}

.cta-title {
    font-size: var(--text-3xl);
    color: var(--color-text-inverse);
    margin-bottom: var(--space-4);
}

.cta-text {
    opacity: 0.9;
    margin-bottom: var(--space-6);
    line-height: 1.7;
}

.cta-btn {
    display: inline-flex;
    padding: var(--space-3) var(--space-6);
    background-color: var(--color-text-inverse);
    color: var(--color-primary);
    border-radius: var(--radius-md);
    font-weight: 700;
    transition: all var(--transition-fast);
}

.cta-btn:hover {
    transform: translateY(-1px);
    box-shadow: var(--shadow-lg);
    color: var(--color-primary-hover);
}

.cta-visual {
    display: flex;
    justify-content: center;
    gap: var(--space-4);
    flex-wrap: wrap;
}

.cta-chord-preview {
    background-color: rgba(255, 255, 255, 0.15);
    border-radius: var(--radius-lg);
    padding: var(--space-2);
}

/* ==========================================================================
   17. Progressions Section
   ========================================================================== */

.progressions-grid {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(320px, 1fr));
    gap: var(--space-4);
}

.progression-card {
    display: flex;
    flex-direction: column;
    padding: var(--space-5);
    background-color: var(--color-surface);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    color: var(--color-text);
    transition: all var(--transition-base);
}

.progression-card:hover {
    border-color: var(--color-primary);
    box-shadow: var(--shadow-md);
    color: var(--color-text);
}

.progression-card .progression-roman {
    font-family: var(--font-mono);
    font-size: var(--text-xl);
    font-weight: 700;
    color: var(--color-primary);
    margin-bottom: var(--space-1);
}

.progression-card .progression-name {
    font-weight: 600;
    font-size: var(--text-base);
    display: block;
    margin-bottom: var(--space-1);
}

.progression-card .progression-example {
    font-family: var(--font-mono);
    font-size: var(--text-sm);
    color: var(--color-text-secondary);
    display: block;
    margin-bottom: var(--space-2);
}

.progression-card .progression-desc {
    font-size: var(--text-sm);
    color: var(--color-text-muted);
    line-height: 1.5;
}

/* Progression Browser page */
.progression-search {
    margin-bottom: var(--space-8);
}

.progression-search-label {
    display: block;
    font-weight: 600;
    margin-bottom: var(--space-2);
}

.progression-search-input-wrap {
    display: flex;
    gap: var(--space-2);
    max-width: 500px;
}

.progression-search-input {
    flex: 1;
    padding: var(--space-3) var(--space-4);
    border: 2px solid var(--color-border);
    border-radius: var(--radius-md);
    background-color: var(--color-surface);
    color: var(--color-text);
    font-family: var(--font-mono);
    outline: none;
}

.progression-search-input:focus {
    border-color: var(--color-primary);
}

.progression-search-btn {
    padding: var(--space-3) var(--space-5);
    background-color: var(--color-primary);
    color: var(--color-text-inverse);
    border: none;
    border-radius: var(--radius-md);
    font-weight: 600;
    cursor: pointer;
    transition: background-color var(--transition-fast);
}

.progression-search-btn:hover {
    background-color: var(--color-primary-hover);
}

.progressions-list {
    display: flex;
    flex-direction: column;
    gap: var(--space-4);
}

.progression-detail-card {
    padding: var(--space-6);
    background-color: var(--color-surface);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
}

.progression-detail-header {
    display: flex;
    justify-content: space-between;
    align-items: flex-start;
    gap: var(--space-4);
    margin-bottom: var(--space-3);
}

.progression-detail-name {
    font-size: var(--text-xl);
    margin-bottom: var(--space-1);
}

.progression-detail-roman {
    font-family: var(--font-mono);
    font-size: var(--text-lg);
    color: var(--color-primary);
    font-weight: 700;
}

.progression-browse-btn {
    flex-shrink: 0;
    padding: var(--space-2) var(--space-4);
    background-color: var(--color-primary);
    color: var(--color-text-inverse);
    border-radius: var(--radius-md);
    font-size: var(--text-sm);
    font-weight: 600;
    transition: background-color var(--transition-fast);
}

.progression-browse-btn:hover {
    background-color: var(--color-primary-hover);
    color: var(--color-text-inverse);
}

.progression-detail-desc {
    color: var(--color-text-secondary);
    margin-bottom: var(--space-3);
    font-size: var(--text-sm);
    line-height: 1.6;
}

.progression-keys {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-3);
    align-items: center;
}

.progression-keys-label {
    font-size: var(--text-sm);
    color: var(--color-text-muted);
    font-weight: 500;
}

.progression-key-example {
    font-family: var(--font-mono);
    font-size: var(--text-sm);
    color: var(--color-text-secondary);
    padding: var(--space-1) var(--space-3);
    background-color: var(--color-bg-alt);
    border-radius: var(--radius-sm);
}

/* ==========================================================================
   18. Chord Finder Page
   ========================================================================== */

.finder-instrument-select {
    margin-bottom: var(--space-8);
}

.finder-label {
    display: block;
    font-weight: 600;
    margin-bottom: var(--space-3);
    font-size: var(--text-lg);
}

.finder-instrument-options {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-2);
}

.finder-instrument-btn {
    padding: var(--space-3) var(--space-5);
    border: 2px solid var(--color-border);
    border-radius: var(--radius-md);
    font-weight: 500;
    color: var(--color-text-secondary);
    transition: all var(--transition-fast);
    font-size: var(--text-sm);
}

.finder-instrument-btn:hover {
    border-color: var(--color-primary);
    color: var(--color-primary);
}

.finder-instrument-btn.active {
    background-color: var(--color-primary);
    border-color: var(--color-primary);
    color: var(--color-text-inverse);
}

.finder-chords-section {
    margin-bottom: var(--space-8);
}

.finder-section-title {
    font-size: var(--text-xl);
    margin-bottom: var(--space-6);
}

.finder-chord-categories {
    display: flex;
    flex-direction: column;
    gap: var(--space-6);
}

.finder-group-title {
    font-size: var(--text-sm);
    font-weight: 600;
    color: var(--color-text-secondary);
    text-transform: uppercase;
    letter-spacing: 0.05em;
    margin-bottom: var(--space-3);
}

.finder-chord-grid {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-2);
}

.finder-chord-btn {
    display: flex;
    align-items: center;
    justify-content: center;
    width: 56px;
    height: 48px;
    border: 2px solid var(--color-border);
    border-radius: var(--radius-md);
    font-family: var(--font-mono);
    font-weight: 600;
    font-size: var(--text-sm);
    color: var(--color-text);
    transition: all var(--transition-fast);
    background-color: var(--color-surface);
}

.finder-chord-btn:hover {
    border-color: var(--color-primary);
    color: var(--color-primary);
}

.finder-chord-btn.selected,
.finder-chord-btn[aria-pressed="true"] {
    background-color: var(--color-primary);
    border-color: var(--color-primary);
    color: var(--color-text-inverse);
}

.finder-selected {
    margin-top: var(--space-6);
    padding: var(--space-5);
    background-color: var(--color-bg-alt);
    border-radius: var(--radius-lg);
}

.finder-selected-title {
    font-size: var(--text-lg);
    margin-bottom: var(--space-4);
}

.finder-selected-count {
    color: var(--color-primary);
}

.finder-selected-diagrams {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-3);
    margin-bottom: var(--space-4);
}

.finder-clear-btn {
    padding: var(--space-2) var(--space-4);
    border: 1px solid var(--color-error);
    border-radius: var(--radius-md);
    color: var(--color-error);
    font-size: var(--text-sm);
    font-weight: 500;
    transition: all var(--transition-fast);
}

.finder-clear-btn:hover {
    background-color: var(--color-error);
    color: var(--color-text-inverse);
}

.finder-results-section {
    margin-top: var(--space-8);
    padding-top: var(--space-8);
    border-top: 1px solid var(--color-border);
}

.finder-results-title {
    font-size: var(--text-2xl);
    margin-bottom: var(--space-6);
}

.finder-results-count {
    color: var(--color-primary);
    font-weight: 500;
}

.finder-suggestions {
    margin-top: var(--space-8);
    padding: var(--space-6);
    background-color: var(--color-bg-alt);
    border-radius: var(--radius-lg);
}

.finder-suggestions-title {
    font-size: var(--text-xl);
    margin-bottom: var(--space-2);
}

.finder-suggestions-desc {
    color: var(--color-text-secondary);
    font-size: var(--text-sm);
    margin-bottom: var(--space-4);
}

.finder-suggestions-list {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-3);
}

.suggestion-card {
    display: flex;
    align-items: center;
    gap: var(--space-3);
    padding: var(--space-3) var(--space-4);
    background-color: var(--color-surface);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
}

.suggestion-chord-name {
    font-family: var(--font-mono);
    font-weight: 700;
    font-size: var(--text-lg);
    color: var(--color-primary);
}

.suggestion-unlock {
    font-size: var(--text-sm);
    color: var(--color-success);
    font-weight: 600;
}

/* ==========================================================================
   19. Buttons & Forms
   ========================================================================== */

.btn {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    gap: var(--space-2);
    padding: var(--space-3) var(--space-5);
    border-radius: var(--radius-md);
    font-weight: 600;
    font-size: var(--text-sm);
    cursor: pointer;
    transition: all var(--transition-fast);
    text-decoration: none;
    border: none;
}

.btn-primary {
    background-color: var(--color-primary);
    color: var(--color-text-inverse);
}

.btn-primary:hover {
    background-color: var(--color-primary-hover);
    color: var(--color-text-inverse);
}

.btn-secondary {
    background-color: var(--color-surface);
    color: var(--color-text);
    border: 1px solid var(--color-border);
}

.btn-secondary:hover {
    border-color: var(--color-primary);
    color: var(--color-primary);
}

/* ==========================================================================
   20. Pagination
   ========================================================================== */

.pagination {
    margin-top: var(--space-8);
    display: flex;
    justify-content: center;
}

.pagination .page-numbers {
    display: flex;
    gap: var(--space-1);
    flex-wrap: wrap;
    justify-content: center;
}

.pagination .page-numbers li {
    display: inline-flex;
}

.pagination .page-numbers a,
.pagination .page-numbers span {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    min-width: 40px;
    height: 40px;
    padding: 0 var(--space-3);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
    font-size: var(--text-sm);
    font-weight: 500;
    color: var(--color-text-secondary);
    transition: all var(--transition-fast);
}

.pagination .page-numbers a:hover {
    border-color: var(--color-primary);
    color: var(--color-primary);
}

.pagination .page-numbers .current {
    background-color: var(--color-primary);
    border-color: var(--color-primary);
    color: var(--color-text-inverse);
}

/* ==========================================================================
   21. Footer
   ========================================================================== */

.site-footer {
    background-color: var(--color-bg-alt);
    border-top: 1px solid var(--color-border);
    padding: var(--space-12) 0 var(--space-8);
    margin-top: var(--space-16);
}

.footer-grid {
    display: grid;
    grid-template-columns: 2fr 1fr 1fr 1fr;
    gap: var(--space-8);
    margin-bottom: var(--space-8);
}

.footer-title {
    font-size: var(--text-base);
    font-weight: 700;
    margin-bottom: var(--space-4);
}

.footer-description {
    color: var(--color-text-secondary);
    font-size: var(--text-sm);
    line-height: 1.6;
}

.footer-menu {
    display: flex;
    flex-direction: column;
    gap: var(--space-2);
}

.footer-menu a {
    color: var(--color-text-secondary);
    font-size: var(--text-sm);
    transition: color var(--transition-fast);
}

.footer-menu a:hover {
    color: var(--color-primary);
}

.footer-bottom {
    padding-top: var(--space-6);
    border-top: 1px solid var(--color-border);
    text-align: center;
}

.footer-copyright {
    color: var(--color-text-muted);
    font-size: var(--text-sm);
}

/* ==========================================================================
   22. 404 Page
   ========================================================================== */

.error-404 {
    text-align: center;
    padding: var(--space-20) 0;
}

.error-404 .page-title {
    font-size: var(--text-4xl);
    margin-bottom: var(--space-4);
}

.error-404 .page-content {
    max-width: 500px;
    margin: 0 auto;
}

.error-404 .page-content p {
    color: var(--color-text-secondary);
}

.error-404-suggestions {
    margin-top: var(--space-8);
}

.suggestion-tags {
    display: flex;
    flex-wrap: wrap;
    justify-content: center;
    gap: var(--space-2);
    margin-top: var(--space-4);
}

.suggestion-tag {
    padding: var(--space-2) var(--space-4);
    background-color: var(--color-surface);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-full);
    font-size: var(--text-sm);
    color: var(--color-text-secondary);
    transition: all var(--transition-fast);
}

.suggestion-tag:hover {
    border-color: var(--color-primary);
    color: var(--color-primary);
}

/* ==========================================================================
   23. No Results
   ========================================================================== */

.no-results {
    grid-column: 1 / -1;
}

.no-results-content {
    text-align: center;
    padding: var(--space-12) var(--space-4);
}

.no-results-icon {
    color: var(--color-text-muted);
    margin-bottom: var(--space-4);
}

.no-results-title {
    font-size: var(--text-2xl);
    margin-bottom: var(--space-2);
}

.no-results-text {
    color: var(--color-text-secondary);
    margin-bottom: var(--space-6);
}

.no-results-actions {
    display: flex;
    gap: var(--space-3);
    justify-content: center;
}

/* ==========================================================================
   24. Empty State
   ========================================================================== */

.empty-state {
    grid-column: 1 / -1;
    text-align: center;
    padding: var(--space-12);
    color: var(--color-text-muted);
}

/* ==========================================================================
   25. WordPress Admin Meta Box Styles
   ========================================================================== */

.chordsongs-meta-table {
    width: 100%;
}

.chordsongs-chord-selector .chord-category {
    margin-bottom: 16px;
}

.chordsongs-chord-selector .chord-category h4 {
    margin-bottom: 8px;
    font-size: 13px;
    color: #646970;
    text-transform: uppercase;
    letter-spacing: 0.5px;
}

.chordsongs-chord-selector .chord-buttons {
    display: flex;
    flex-wrap: wrap;
    gap: 4px;
}

.chord-select-btn {
    display: inline-flex;
    cursor: pointer;
}

.chord-select-btn input {
    display: none;
}

.chord-select-btn span {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    min-width: 48px;
    padding: 6px 10px;
    border: 2px solid #dcdcde;
    border-radius: 4px;
    font-weight: 600;
    font-size: 13px;
    transition: all 0.15s ease;
    background-color: #f0f0f1;
}

.chord-select-btn:hover span {
    border-color: #2271b1;
}

.chord-select-btn.selected span,
.chord-select-btn input:checked + span {
    background-color: #2271b1;
    border-color: #2271b1;
    color: #fff;
}

.selected-chords-preview {
    margin-top: 12px;
    padding: 8px 12px;
    background-color: #f6f7f7;
    border-radius: 4px;
    font-size: 13px;
}

/* ==========================================================================
   26. Animations
   ========================================================================== */

@keyframes fadeIn {
    from { opacity: 0; transform: translateY(8px); }
    to { opacity: 1; transform: translateY(0); }
}

.song-card {
    animation: fadeIn 0.3s ease forwards;
}

/* ==========================================================================
   27. Responsive Breakpoints (Mobile-First)
   ========================================================================== */

/* Tablet and below */
@media (max-width: 1024px) {
    .archive-layout {
        grid-template-columns: 1fr;
    }

    .sidebar-filters {
        position: static;
        max-height: none;
        display: none;
    }

    .sidebar-filters.sidebar-open {
        display: block;
    }

    .mobile-filters-toggle {
        display: flex;
    }

    .footer-grid {
        grid-template-columns: 1fr 1fr;
    }

    .cta-card {
        grid-template-columns: 1fr;
        text-align: center;
    }
}

/* Mobile */
@media (max-width: 768px) {
    :root {
        --text-5xl: 2.25rem;
        --text-4xl: 1.875rem;
        --text-3xl: 1.5rem;
    }

    .header-inner {
        padding: 0 var(--space-4);
    }

    .main-navigation ul {
        display: none;
        flex-direction: column;
        position: absolute;
        top: var(--header-height);
        left: 0;
        right: 0;
        background-color: var(--color-surface);
        border-bottom: 1px solid var(--color-border);
        padding: var(--space-4);
        box-shadow: var(--shadow-lg);
    }

    .nav-open ul {
        display: flex;
    }

    .menu-toggle {
        display: flex;
    }

    .hero-section {
        padding: var(--space-12) 0 var(--space-8);
    }

    .instruments-grid {
        grid-template-columns: repeat(3, 1fr);
    }

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

    .songs-grid {
        grid-template-columns: 1fr;
    }

    .progressions-grid {
        grid-template-columns: 1fr;
    }

    .footer-grid {
        grid-template-columns: 1fr;
    }

    .cta-card {
        padding: var(--space-6);
    }

    .progression-detail-header {
        flex-direction: column;
    }

    .progression-keys {
        flex-direction: column;
    }

    .finder-chord-btn {
        width: 48px;
        height: 42px;
        font-size: var(--text-xs);
    }
}

/* Small mobile */
@media (max-width: 480px) {
    .instruments-grid {
        grid-template-columns: repeat(2, 1fr);
    }

    .categories-grid {
        grid-template-columns: 1fr;
    }

    .hero-quick-filters {
        flex-direction: column;
        align-items: center;
    }

    .results-toolbar {
        flex-direction: column;
        align-items: flex-start;
    }

    .chord-diagrams-strip {
        justify-content: center;
    }
}

/* ==========================================================================
   Blog Article Styles
   ========================================================================== */

/* --- Article Hero --- */
.article-hero {
    background: linear-gradient(135deg, var(--color-primary-light) 0%, var(--color-bg) 60%);
    padding: var(--space-8) 0 var(--space-12);
    border-bottom: 1px solid var(--color-border);
}

.article-hero .breadcrumb {
    display: flex;
    align-items: center;
    gap: var(--space-2);
    font-size: var(--text-sm);
    color: var(--color-text-muted);
    margin-bottom: var(--space-8);
    flex-wrap: wrap;
}

.article-hero .breadcrumb a {
    display: inline-flex;
    align-items: center;
    gap: var(--space-1);
    color: var(--color-text-secondary);
    text-decoration: none;
    transition: color var(--transition-fast);
}

.article-hero .breadcrumb a:hover {
    color: var(--color-primary);
}

.article-hero .breadcrumb-sep {
    color: var(--color-text-muted);
    display: inline-flex;
}

.article-hero .breadcrumb-current {
    color: var(--color-text);
    font-weight: 500;
}

.article-hero-content {
    max-width: 800px;
}

.article-category-badge {
    display: inline-flex;
    align-items: center;
    padding: var(--space-1) var(--space-3);
    background: var(--color-primary);
    color: var(--color-text-inverse);
    font-size: var(--text-xs);
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.05em;
    border-radius: var(--radius-full);
    text-decoration: none;
    margin-bottom: var(--space-4);
    transition: background var(--transition-fast);
}

.article-category-badge:hover {
    background: var(--color-primary-hover);
    color: var(--color-text-inverse);
}

.article-title {
    font-family: var(--font-heading-serif);
    font-size: clamp(2rem, 5vw, 3rem);
    font-weight: 400;
    line-height: 1.15;
    color: var(--color-text);
    margin: 0 0 var(--space-4);
    letter-spacing: -0.01em;
}

.article-excerpt {
    font-size: var(--text-lg);
    color: var(--color-text-secondary);
    line-height: 1.6;
    margin: 0 0 var(--space-6);
    max-width: 640px;
}

.article-meta-bar {
    display: flex;
    align-items: center;
    gap: var(--space-6);
    flex-wrap: wrap;
}

.article-meta-item {
    display: inline-flex;
    align-items: center;
    gap: var(--space-2);
    font-size: var(--text-sm);
    color: var(--color-text-secondary);
    font-weight: 500;
}

.article-meta-item svg {
    color: var(--color-text-muted);
    flex-shrink: 0;
}

/* --- Article Layout --- */
.single-article {
    padding: var(--space-10) 0 var(--space-16);
}

.article-layout {
    display: grid;
    grid-template-columns: 220px 1fr;
    gap: var(--space-12);
    align-items: start;
}

/* --- Table of Contents Sidebar --- */
.article-sidebar {
    position: sticky;
    top: calc(var(--header-height) + var(--space-8));
}

.toc-widget {
    background: var(--color-bg-alt);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    padding: var(--space-5);
}

.toc-title {
    display: flex;
    align-items: center;
    gap: var(--space-2);
    font-size: var(--text-xs);
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.08em;
    color: var(--color-text-secondary);
    margin-bottom: var(--space-4);
    padding-bottom: var(--space-3);
    border-bottom: 1px solid var(--color-border);
}

.toc-title svg {
    color: var(--color-primary);
}

.toc-list {
    list-style: none;
    padding: 0;
    margin: 0;
    display: flex;
    flex-direction: column;
    gap: var(--space-1);
}

.toc-link {
    display: block;
    padding: var(--space-2) var(--space-3);
    font-size: var(--text-xs);
    font-weight: 500;
    color: var(--color-text-secondary);
    text-decoration: none;
    border-radius: var(--radius-sm);
    border-left: 2px solid transparent;
    transition: all var(--transition-fast);
    line-height: 1.4;
}

.toc-link:hover {
    color: var(--color-primary);
    background: var(--color-primary-light);
}

.toc-link.active {
    color: var(--color-primary);
    background: var(--color-primary-light);
    border-left-color: var(--color-primary);
    font-weight: 600;
}

/* --- Article Main Content --- */
.article-main {
    min-width: 0;
}

.article-content {
    font-family: var(--font-body-alt);
    font-size: var(--text-lg);
    line-height: 1.85;
    color: var(--color-text);
}

/* Headings — Instrument Serif for blog articles */
.article-content h2 {
    font-family: var(--font-heading-serif);
    font-size: clamp(1.5rem, 3vw, 2rem);
    font-weight: 400;
    font-style: italic;
    margin: var(--space-12) 0 var(--space-4);
    padding-top: var(--space-6);
    color: var(--color-text);
    letter-spacing: -0.01em;
    border-top: 2px solid var(--color-border);
    line-height: 1.3;
}

.article-content h2:first-child {
    margin-top: 0;
    padding-top: 0;
    border-top: none;
}

.article-content h3 {
    font-family: var(--font-heading-serif);
    font-size: var(--text-xl);
    font-weight: 400;
    margin: var(--space-8) 0 var(--space-3);
    color: var(--color-text);
    line-height: 1.35;
}

/* Paragraphs */
.article-content p {
    margin: 0 0 var(--space-5);
}

.article-content > p:first-child,
.article-content > .article-intro,
.article-content > .lead {
    font-size: 1.2rem;
    line-height: 1.7;
    color: var(--color-text-secondary);
    font-weight: 400;
}

/* Links */
.article-content a {
    color: var(--color-primary);
    text-decoration: underline;
    text-decoration-color: rgba(99, 102, 241, 0.3);
    text-underline-offset: 3px;
    transition: all var(--transition-fast);
}

.article-content a:hover {
    color: var(--color-primary-hover);
    text-decoration-color: var(--color-primary-hover);
}

/* Lists */
.article-content ul,
.article-content ol {
    margin: 0 0 var(--space-6);
    padding: 0;
    list-style: none;
}

.article-content ul li {
    position: relative;
    padding-left: var(--space-6);
    margin-bottom: var(--space-4);
    line-height: 1.7;
}

.article-content ul li::before {
    content: '';
    position: absolute;
    left: 0;
    top: 0.65em;
    width: 6px;
    height: 6px;
    border-radius: var(--radius-full);
    background: var(--color-primary);
}

.article-content ol {
    counter-reset: article-counter;
}

.article-content ol li {
    position: relative;
    padding-left: var(--space-8);
    margin-bottom: var(--space-4);
    line-height: 1.7;
    counter-increment: article-counter;
}

.article-content ol li::before {
    content: counter(article-counter);
    position: absolute;
    left: 0;
    top: 0.15em;
    width: 24px;
    height: 24px;
    border-radius: var(--radius-full);
    background: var(--color-primary-light);
    color: var(--color-primary);
    font-size: var(--text-xs);
    font-weight: 700;
    display: flex;
    align-items: center;
    justify-content: center;
}

/* Bold & Italic */
.article-content strong {
    font-weight: 700;
    color: var(--color-text);
}

.article-content em {
    font-style: italic;
    color: var(--color-text-secondary);
}

/* Horizontal Rule */
.article-content hr {
    margin: var(--space-10) 0;
    border: none;
    height: 1px;
    background: var(--color-border);
}

/* Preformatted / Code */
.article-content pre {
    background: var(--color-bg-alt);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    padding: var(--space-5) var(--space-6);
    overflow-x: auto;
    font-family: var(--font-mono);
    font-size: var(--text-sm);
    line-height: 1.7;
    margin: 0 0 var(--space-6);
    color: var(--color-text);
}

.article-content code {
    font-family: var(--font-mono);
    font-size: 0.875em;
    background: var(--color-bg-alt);
    padding: 0.15em 0.4em;
    border-radius: var(--radius-sm);
    color: var(--color-primary);
}

.article-content pre code {
    background: none;
    padding: 0;
    color: inherit;
}

/* Internal Navigation Links (bottom of article) */
.article-content nav ul {
    list-style: none !important;
    padding: 0 !important;
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-3);
}

.article-content nav ul li {
    padding-left: 0 !important;
    margin-bottom: 0 !important;
}

.article-content nav ul li::before {
    display: none !important;
}

.article-content nav ul li a {
    display: inline-flex;
    align-items: center;
    padding: var(--space-2) var(--space-4);
    background: var(--color-primary-light);
    color: var(--color-primary);
    border-radius: var(--radius-full);
    text-decoration: none;
    font-weight: 600;
    font-size: var(--text-sm);
    transition: all var(--transition-fast);
    border: 1px solid transparent;
}

.article-content nav ul li a:hover {
    background: var(--color-primary);
    color: var(--color-text-inverse);
    border-color: var(--color-primary);
}

/* FAQ section styling */
.article-content h3 + p {
    color: var(--color-text);
}

/* --- Article Tags Section --- */
.article-tags-section {
    margin-top: var(--space-10);
    padding-top: var(--space-6);
    border-top: 1px solid var(--color-border);
}

.article-tags-title {
    display: flex;
    align-items: center;
    gap: var(--space-2);
    font-size: var(--text-sm);
    font-weight: 600;
    color: var(--color-text-secondary);
    margin-bottom: var(--space-3);
}

.article-tags {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-2);
}

.article-tag {
    display: inline-flex;
    align-items: center;
    padding: var(--space-1) var(--space-3);
    background: var(--color-bg-alt);
    color: var(--color-text-secondary);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-full);
    font-size: var(--text-xs);
    font-weight: 500;
    text-decoration: none;
    transition: all var(--transition-fast);
}

.article-tag:hover {
    background: var(--color-primary-light);
    color: var(--color-primary);
    border-color: var(--color-primary);
}

/* --- Share Bar --- */
.article-share {
    margin-top: var(--space-8);
    padding: var(--space-5) var(--space-6);
    background: var(--color-bg-alt);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    display: flex;
    align-items: center;
    justify-content: space-between;
}

.share-label {
    font-size: var(--text-sm);
    font-weight: 600;
    color: var(--color-text-secondary);
}

.share-buttons {
    display: flex;
    gap: var(--space-2);
}

.share-btn {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    width: 40px;
    height: 40px;
    border-radius: var(--radius-md);
    color: var(--color-text-secondary);
    background: var(--color-surface);
    border: 1px solid var(--color-border);
    text-decoration: none;
    transition: all var(--transition-fast);
    cursor: pointer;
}

.share-btn:hover {
    color: var(--color-text-inverse);
    border-color: transparent;
}

.share-twitter:hover {
    background: #1da1f2;
}

.share-facebook:hover {
    background: #1877f2;
}

.share-copy:hover {
    background: var(--color-primary);
}

.share-copy.copied {
    background: var(--color-success);
    color: var(--color-text-inverse);
    border-color: transparent;
}

/* --- Related Articles --- */
.related-articles {
    margin-top: var(--space-12);
    padding-top: var(--space-8);
    border-top: 2px solid var(--color-border);
}

.related-title {
    display: flex;
    align-items: center;
    gap: var(--space-3);
    font-size: var(--text-xl);
    font-weight: 700;
    margin-bottom: var(--space-6);
    color: var(--color-text);
}

.related-title svg {
    color: var(--color-primary);
}

.related-grid {
    display: grid;
    grid-template-columns: repeat(3, 1fr);
    gap: var(--space-5);
}

.related-card {
    display: block;
    text-decoration: none;
    background: var(--color-surface);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    overflow: hidden;
    transition: all var(--transition-base);
}

.related-card:hover {
    border-color: var(--color-primary);
    box-shadow: var(--shadow-lg);
    transform: translateY(-4px);
}

.related-card-inner {
    padding: var(--space-6);
}

.related-card-cat {
    display: inline-block;
    font-size: var(--text-xs);
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.05em;
    color: var(--color-primary);
    margin-bottom: var(--space-3);
}

.related-card-title {
    font-size: var(--text-base);
    font-weight: 700;
    color: var(--color-text);
    margin: 0 0 var(--space-2);
    line-height: 1.35;
    display: -webkit-box;
    -webkit-line-clamp: 2;
    -webkit-box-orient: vertical;
    overflow: hidden;
}

.related-card:hover .related-card-title {
    color: var(--color-primary);
}

.related-card-excerpt {
    font-size: var(--text-sm);
    color: var(--color-text-secondary);
    margin: 0 0 var(--space-3);
    line-height: 1.5;
    display: -webkit-box;
    -webkit-line-clamp: 2;
    -webkit-box-orient: vertical;
    overflow: hidden;
}

.related-card-meta {
    font-size: var(--text-xs);
    color: var(--color-text-muted);
    font-weight: 500;
}

/* --- Responsive --- */
@media (max-width: 1024px) {
    .article-layout {
        grid-template-columns: 1fr;
    }

    .article-sidebar {
        position: relative;
        top: auto;
    }

    .toc-widget {
        display: none;
    }
}

@media (max-width: 768px) {
    .article-hero {
        padding: var(--space-6) 0 var(--space-8);
    }

    .article-title {
        font-size: 1.75rem;
    }

    .article-meta-bar {
        gap: var(--space-4);
    }

    .article-content {
        font-size: var(--text-base);
    }

    .article-content h2 {
        font-size: var(--text-xl);
        margin: var(--space-8) 0 var(--space-3);
    }

    .article-content h3 {
        font-size: var(--text-lg);
    }

    .article-share {
        flex-direction: column;
        gap: var(--space-3);
        text-align: center;
    }

    .related-grid {
        grid-template-columns: 1fr;
    }

    .single-article {
        padding: var(--space-6) 0 var(--space-10);
    }

    /* Chord diagrams responsive */
    .chord-inline-strip {
        padding: var(--space-4);
        gap: var(--space-3);
    }

    .chord-palette {
        padding: var(--space-4) var(--space-5);
        gap: var(--space-3);
    }

    .chord-inline-diagram .chord-diagram--medium {
        width: 80px;
    }

    .chord-palette-item .chord-diagram--large {
        width: 110px;
    }
}

/* ==========================================================================
   Inline Chord Diagrams & Chord Palettes (React-style)
   ========================================================================== */

/* --- Inline chord strip (replaces "(Chords: G, C, D)" text) --- */
.chord-inline-strip {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-4);
    margin: var(--space-5) 0 var(--space-6);
    padding: var(--space-5) var(--space-6);
    background: var(--color-bg-alt);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    justify-content: flex-start;
    align-items: flex-end;
}

/* Individual inline chord diagram container */
.chord-inline-diagram {
    display: flex;
    flex-direction: column;
    align-items: center;
    gap: var(--space-1);
    flex-shrink: 0;
}

/* SVG sizing for inline diagrams */
.chord-inline-diagram .chord-diagram {
    display: block;
}

.chord-inline-diagram .chord-diagram--medium {
    width: 96px;
    height: auto;
}

.chord-inline-diagram .chord-diagram--large {
    width: 140px;
    height: auto;
}

/* --- Chord Palette (from [chords] shortcode) — large diagram strip --- */
.chord-palette {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-5);
    padding: var(--space-6) var(--space-8);
    background: var(--color-bg-alt);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-xl);
    margin: var(--space-6) 0 var(--space-8);
    justify-content: center;
    align-items: flex-end;
}

.chord-palette-item {
    display: flex;
    flex-direction: column;
    align-items: center;
    gap: var(--space-2);
    flex-shrink: 0;
}

.chord-palette-item .chord-diagram-wrapper {
    display: flex;
    flex-direction: column;
    align-items: center;
}

/* SVG sizing for palette (large) diagrams */
.chord-palette-item .chord-diagram {
    display: block;
}

.chord-palette-item .chord-diagram--large {
    width: 140px;
    height: auto;
}

/* Chord label under diagram */
.chord-palette-item .chord-label,
.chord-inline-diagram .chord-label {
    font-family: var(--font-mono);
    font-size: var(--text-xs);
    font-weight: 600;
    color: var(--color-text-secondary);
    text-align: center;
    margin-top: var(--space-1);
}

/* --- Article Content Chord Diagram Defaults --- */
.article-content .chord-diagram {
    display: block;
}

.article-content .chord-diagram--small {
    width: 80px;
    height: auto;
}

.article-content .chord-diagram--medium {
    width: 96px;
    height: auto;
}

.article-content .chord-diagram--large {
    width: 140px;
    height: auto;
}

/* --- Tip / Callout Boxes --- */
.article-content blockquote {
    margin: var(--space-6) 0;
    padding: var(--space-5) var(--space-6);
    background: var(--color-primary-light);
    border-left: 4px solid var(--color-primary);
    border-radius: 0 var(--radius-lg) var(--radius-lg) 0;
    font-size: var(--text-base);
    line-height: 1.7;
    color: var(--color-text);
}

.article-content blockquote p {
    margin: 0;
}

.article-content blockquote p + p {
    margin-top: var(--space-3);
}

/* --- Ordered list section numbering (monospace) --- */
.article-content ol li::before {
    font-family: var(--font-mono);
}

/* --- Dark mode overrides for chord diagrams --- */
[data-theme="dark"] .chord-inline-strip,
[data-theme="dark"] .chord-palette {
    background: var(--color-bg-alt);
    border-color: var(--color-border);
}

[data-theme="dark"] .article-content blockquote {
    background: rgba(99, 102, 241, 0.1);
    border-left-color: var(--color-primary);
}