/**
 * THEME VARIABLES - Central CSS Custom Properties
 * 
 * This file contains all color and styling variables used throughout the application.
 * Theme switching is achieved by applying different theme classes to the <body> element.
 * 
 * Usage:
 * - Light Theme: <body class="theme-light">
 * - Dark Theme: <body class="theme-dark">
 * - Dark Blue Theme: <body class="theme-dark-blue">
 * - Dark Purple Theme: <body class="theme-dark-purple">
 * 
 * All components should reference these CSS variables instead of hardcoded colors.
 * Example: background-color: var(--bg-primary); color: var(--text-primary);
 */

/* =================================================================
   DEFAULT/ROOT VARIABLES (Light Theme Base)
   ================================================================= */
:root {
    /* Primary Brand Colors */
    --brand-primary: #2563eb;
    --brand-secondary: #1e40af;
    --brand-accent: #3b82f6;
    /* Text color used on top of --brand-primary surfaces */
    --brand-contrast-text: #ffffff;
    
    /* Background Colors */
    --bg-primary: #ffffff;
    --bg-secondary: #f8fafc;
    --bg-tertiary: #f1f5f9;
    --bg-overlay: rgba(0, 0, 0, 0.5);
    
    /* Card & Panel Colors */
    --card-bg: #ffffff;
    --card-hover: #f8fafc;
    --card-border: #e2e8f0;
    --card-shadow: rgba(0, 0, 0, 0.1);
    
    /* Header Colors */
    --header-bg: #ffffff;
    --header-text: #1e293b;
    --header-border: #e2e8f0;
    --header-icon-bg: #f1f5f9;
    --header-icon-text: #1e293b;
    --header-hover-bg: #f8fafc;
    --logo-filter: none;
    
    /* Navbar & Sidebar Colors */
    --navbar-bg: #ffffff;
    --navbar-text: #1e293b;
    --navbar-hover: #f1f5f9;
    --navbar-active: #2563eb;
    --sidebar-bg: #1e293b;
    --sidebar-text: #e2e8f0;
    --sidebar-hover: #334155;
    --sidebar-active: #2563eb;
    
    /* Text Colors */
    --text-primary: #1e293b;
    --text-secondary: #475569;
    --text-tertiary: #64748b;
    --text-muted: #94a3b8;
    --text-inverse: #ffffff;
    
    /* Link Colors */
    --link-color: #2563eb;
    --link-hover: #1e40af;
    --link-active: #1e40af;
    
    /* Border Colors */
    --border-color: #e2e8f0;
    --border-light: #f1f5f9;
    --border-dark: #cbd5e1;
    
    /* Form Input Colors */
    --input-bg: #ffffff;
    --input-border: #e2e8f0;
    --input-focus-border: #2563eb;
    --input-focus-shadow: rgba(37, 99, 235, 0.1);
    --input-disabled-bg: #f1f5f9;
    --input-disabled-text: #94a3b8;
    --input-text: #1e293b;
    --input-placeholder: #94a3b8;
    
    /* Button Colors */
    --btn-primary-bg: #2563eb;
    --btn-primary-hover: #1e40af;
    --btn-primary-text: #ffffff;
    --btn-secondary-bg: #64748b;
    --btn-secondary-hover: #475569;
    --btn-secondary-text: #ffffff;
    --btn-success-bg: #10b981;
    --btn-success-hover: #059669;
    --btn-danger-bg: #ef4444;
    --btn-danger-hover: #dc2626;
    --btn-warning-bg: #f59e0b;
    --btn-warning-hover: #d97706;
    --btn-info-bg: #0ea5e9;
    --btn-info-hover: #0284c7;
    
    /* Status/Alert Colors */
    --success-bg: #d1fae5;
    --success-border: #6ee7b7;
    --success-text: #065f46;
    --error-bg: #fee2e2;
    --error-border: #fca5a5;
    --error-text: #991b1b;
    --warning-bg: #fef3c7;
    --warning-border: #fcd34d;
    --warning-text: #92400e;
    --info-bg: #dbeafe;
    --info-border: #93c5fd;
    --info-text: #1e40af;
    
    /* Table Colors */
    --table-header-bg: #f8fafc;
    --table-header-text: #1e293b;
    --table-row-hover: #f1f5f9;
    --table-border: #e2e8f0;
    --table-stripe: #f8fafc;
    
    /* Modal & Overlay */
    --modal-bg: #ffffff;
    --modal-header-bg: #f8fafc;
    --modal-overlay: rgba(0, 0, 0, 0.5);
    
    /* Scrollbar */
    --scrollbar-track: #f1f5f9;
    --scrollbar-thumb: #cbd5e1;
    --scrollbar-thumb-hover: #94a3b8;
    
    /* Shadows */
    --shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
    --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1);
    --shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1);
    --shadow-xl: 0 20px 25px -5px rgba(0, 0, 0, 0.1);

    /* Layout-Specific: TopNav */
    --topnav-bg: #ffffff;
    --topnav-shadow: 0 1px 4px rgba(0, 0, 0, 0.08), 0 2px 12px rgba(36, 91, 148, 0.06);
    --topnav-brand-color: #245b94;
    --topnav-brand-hover-bg: #245b94;
    --topnav-brand-hover-text: #ffffff;
    --topnav-user-hover-bg: #f0f4f9;
    --topnav-user-name-color: #1d3a5c;
    --topnav-user-balance-color: #607d8b;
    --topnav-logo-text-color: #1d3a5c;

    /* Layout-Specific: Dropdown */
    --dropdown-bg: #ffffff;
    --dropdown-border: #e8ecf0;
    --dropdown-shadow: 0 8px 24px rgba(36, 91, 148, 0.12), 0 2px 8px rgba(0, 0, 0, 0.06);
    --dropdown-header-bg: linear-gradient(135deg, #f6f9fc, #eef3fa);
    --dropdown-header-border: #e4eaf0;
    --dropdown-avatar-bg: linear-gradient(135deg, #245b94, #3a7bc8);
    --dropdown-name-color: #1d3a5c;
    --dropdown-login-color: #607d8b;
    --dropdown-badge-bg: #ffffff;
    --dropdown-badge-border: #d6e2ef;
    --dropdown-badge-color: #245b94;
    --dropdown-info-bg: #fafbfc;
    --dropdown-info-border: #eef0f3;
    --dropdown-info-title-color: #245b94;
    --dropdown-info-label-color: #90a4ae;
    --dropdown-info-value-color: #37474f;
    --dropdown-section-label-color: #90a4ae;
    --dropdown-item-color: #37474f;
    --dropdown-item-hover-bg: #f0f4f9;
    --dropdown-item-hover-color: #1a4a7a;
    --dropdown-divider-color: #eef0f3;
    --dropdown-signout-color: #c0392b;
    --dropdown-signout-hover-bg: #fdf2f2;
    --dropdown-signout-hover-color: #a93226;
    --dropdown-signout-border: #f0f0f0;
    --dropdown-icon-profile-bg: #dbe6f6;
    --dropdown-icon-profile-color: #1a4a7a;
    --dropdown-icon-entity-bg: #d4edda;
    --dropdown-icon-entity-color: #1b5e20;
    --dropdown-icon-password-bg: #ffe0b2;
    --dropdown-icon-password-color: #bf360c;
    --dropdown-icon-pin-bg: #e1bee7;
    --dropdown-icon-pin-color: #6a1b9a;
    --dropdown-icon-signout-bg: #f8d7da;
    --dropdown-icon-signout-color: #b71c1c;

    /* Layout-Specific: Header Gradients (card headers, table heads, modal headers) */
    --header-gradient-from: #245b94;
    --header-gradient-to: #3a7bc8;

    /* Layout-Specific: Action Buttons */
    --action-btn-bg: linear-gradient(135deg, #245b94, #3a7bc8);
    --action-btn-hover-bg: linear-gradient(135deg, #1a4a7a, #2d6aad);
    --action-btn-shadow: 0 2px 8px rgba(36, 91, 148, 0.25);
    --action-btn-hover-shadow: 0 4px 16px rgba(36, 91, 148, 0.35);

    /* Layout-Specific: Sidebar — darker than content for visual separation */
    --sidebar-menu-bg: #eef2f8;
    --sidebar-menu-color: #1d3a5c;
    --sidebar-menu-border: #dce3ed;
    --sidebar-menu-icon-color: #245b94;
    --sidebar-menu-hover-bg: #dce4ef;
    --sidebar-menu-hover-color: #1a4a7a;
    --sidebar-menu-active-bg: #d0daea;
    --sidebar-menu-active-color: #143d6b;
    --sidebar-menu-active-border: #245b94;
    --sidebar-submenu-bg: #e4ebf4;
    --sidebar-submenu-color: #1d3a5c;
    --sidebar-submenu-border: #d2dbe8;
    --sidebar-submenu-hover-bg: #d0daea;
    --sidebar-submenu-hover-color: #1a4a7a;
    --sidebar-submenu-icon-color: #245b94;

    /* Layout-Specific: Footer */
    --footer-bg: transparent;
    --footer-text: inherit;

    /* Dashboard Components */
    --dash-heading-color: #1d3a5c;
    --dash-breadcrumb-color: #90a4ae;
    --dash-breadcrumb-separator: #cfd8dc;
    --dash-breadcrumb-link: #607d8b;
    --dash-breadcrumb-active: #245b94;
    --dash-card-bg: #ffffff;
    --dash-card-border: #e8ecf0;
    --dash-card-shadow: 0 1px 4px rgba(0,0,0,0.04);
    --dash-card-header-bg: linear-gradient(135deg, #f8fafe, #f2f6fc);
    --dash-card-header-border: #eef0f3;
    --dash-card-header-title: #1d3a5c;
    --dash-action-bg: #ffffff;
    --dash-action-border: #e8ecf0;
    --dash-action-hover-shadow: 0 8px 24px rgba(36,91,148,0.12);
    --dash-action-hover-border: #d0dce8;
    --dash-action-label-color: #37474f;
    --dash-action-label-hover: #1d3a5c;
    --dash-table-th-bg: #f6f9fc;
    --dash-table-th-border: #e0e7ef;
    --dash-table-th-color: #607d8b;
    --dash-table-td-color: #37474f;
    --dash-table-td-border: #f0f2f5;
    --dash-table-row-hover: #f8fafe;
    --dash-stat-bg: #f8fafe;
    --dash-stat-border: #e8ecf0;
    --dash-stat-value-color: #1d3a5c;
    --dash-stat-label-color: #90a4ae;
    --dash-stat-footer-bg: #fafbfc;
    --dash-stat-footer-border: #eef0f3;
    --dash-stat-footer-link: #245b94;
    --dash-notice-color: #455a64;

    /* Code Example Components (for Sample Code page) */
    --code-tab-active-text: #ffffff;
    --code-copy-btn-bg: #313244;
    --code-copy-btn-text: #cdd6f4;
    --code-copy-btn-hover-text: #ffffff;
    --code-copy-btn-copied-text: #ffffff;
}

/* =================================================================
   THEME: LIGHT (Explicit Definition)
   ================================================================= */
body.theme-light {
    /* Primary Brand Colors */
    --brand-primary: #2563eb;
    --brand-secondary: #1e40af;
    --brand-accent: #3b82f6;
    /* Text color used on top of --brand-primary surfaces */
    --brand-contrast-text: #ffffff;
    
    /* Background Colors */
    --bg-primary: #ffffff;
    --bg-secondary: #f8fafc;
    --bg-tertiary: #f1f5f9;
    --bg-overlay: rgba(0, 0, 0, 0.5);
    
    /* Card & Panel Colors */
    --card-bg: #ffffff;
    --card-hover: #f8fafc;
    --card-border: #e2e8f0;
    --card-shadow: rgba(0, 0, 0, 0.1);
    
    /* Header Colors */
    --header-bg: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
    --header-text: #ffffff;
    --header-border: rgba(255, 255, 255, 0.1);
    --header-icon-bg: rgba(255, 255, 255, 0.2);
    --header-icon-text: #ffffff;
    --header-hover-bg: rgba(255, 255, 255, 0.15);
    --logo-filter: brightness(0) invert(1);
    
    /* Navbar & Sidebar Colors */
    --navbar-bg: #ffffff;
    --navbar-text: #1e293b;
    --navbar-hover: #f1f5f9;
    --navbar-active: #2563eb;
    --sidebar-bg: #1e293b;
    --sidebar-text: #e2e8f0;
    --sidebar-hover: #334155;
    --sidebar-active: #2563eb;
    
    /* Text Colors */
    --text-primary: #1e293b;
    --text-secondary: #475569;
    --text-tertiary: #64748b;
    --text-muted: #94a3b8;
    --text-inverse: #ffffff;
    
    /* Link Colors */
    --link-color: #2563eb;
    --link-hover: #1e40af;
    
    /* Border Colors */
    --border-color: #e2e8f0;
    --border-light: #f1f5f9;
    --border-dark: #cbd5e1;
    
    /* Form Input Colors */
    --input-bg: #ffffff;
    --input-border: #e2e8f0;
    --input-focus-border: #2563eb;
    --input-focus-shadow: rgba(37, 99, 235, 0.1);
    --input-disabled-bg: #f1f5f9;
    --input-disabled-text: #94a3b8;
    --input-text: #1e293b;
    --input-placeholder: #94a3b8;

    /* Status/Alert Colors */
    --success-bg: #d1fae5;
    --success-border: #6ee7b7;
    --success-text: #065f46;
    --error-bg: #fee2e2;
    --error-border: #fca5a5;
    --error-text: #991b1b;
    --warning-bg: #fef3c7;
    --warning-border: #fcd34d;
    --warning-text: #92400e;
    --info-bg: #dbeafe;
    --info-border: #93c5fd;
    --info-text: #1e40af;

    /* Table Colors */
    --table-header-bg: #f8fafc;
    --table-header-text: #1e293b;
    --table-row-hover: #f1f5f9;
    --table-border: #e2e8f0;
    --table-stripe: #f8fafc;
    
    /* Modal & Overlay */
    --modal-bg: #ffffff;
    --modal-header-bg: #f8fafc;
    --modal-overlay: rgba(0, 0, 0, 0.5);
    
    /* Scrollbar */
    --scrollbar-track: #f1f5f9;
    --scrollbar-thumb: #cbd5e1;
    --scrollbar-thumb-hover: #94a3b8;

    /* Code Example Components (for Sample Code page) */
    --code-tab-active-text: #ffffff;
    --code-copy-btn-bg: #ffffff;
    --code-copy-btn-text: #475569;
    --code-copy-btn-hover-text: #ffffff;
    --code-copy-btn-copied-text: #ffffff;
}

/* =================================================================
   THEME: DARK (Standard Dark Theme)
   ================================================================= */
body.theme-dark {
    /* Primary Brand Colors */
    /*    --brand-primary: #3b82f6;*/
    --brand-primary: #ffeb3b;
    --brand-secondary: #2563eb;
    --brand-accent: #60a5fa;
    /* Brand is yellow in this theme, so text on it must be dark for contrast */
    --brand-contrast-text: #1e293b;
    /* Background Colors */
    --bg-primary: #0f172a;
    --bg-secondary: #1e293b;
    --bg-tertiary: #334155;
    --bg-overlay: rgba(0, 0, 0, 0.7);
    /* Card & Panel Colors */
    --card-bg: #1e293b;
    --card-hover: #334155;
    --card-border: #334155;
    --card-shadow: rgba(0, 0, 0, 0.3);
    /* Header Colors */
    --header-bg: linear-gradient(135deg, #1e293b 0%, #334155 100%);
    --header-text: #f1f5f9;
    --header-border: #475569;
    --header-icon-bg: rgba(59, 130, 246, 0.15);
    --header-icon-text: #f1f5f9;
    --header-hover-bg: rgba(59, 130, 246, 0.2);
    --logo-filter: brightness(0) invert(1);
    /* Navbar & Sidebar Colors */
    --navbar-bg: #1e293b;
    --navbar-text: #e2e8f0;
    --navbar-hover: #334155;
    --navbar-active: #3b82f6;
    --sidebar-bg: #0f172a;
    --sidebar-text: #cbd5e1;
    --sidebar-hover: #1e293b;
    --sidebar-active: #3b82f6;
    /* Text Colors */
    --text-primary: #f1f5f9;
    --text-secondary: #cbd5e1;
    --text-tertiary: #94a3b8;
    --text-muted: #64748b;
    --text-inverse: #0f172a;
    /* Link Colors */
    /*    --link-color: #60a5fa;*/
    /*    --link-color: #ff9800;*/
    /*    --link-hover: #3b82f6;*/
    --link-color: #4da6ff;
    --link-hover: #66ccff;
    /* Border Colors */
    --border-color: #334155;
    --border-light: #475569;
    --border-dark: #1e293b;
    /* Form Input Colors */
    --input-bg: #0f172a;
    --input-border: #334155;
    --input-focus-border: #3b82f6;
    --input-focus-shadow: rgba(59, 130, 246, 0.2);
    --input-disabled-bg: #1e293b;
    --input-disabled-text: #64748b;
    --input-text: #f1f5f9;
    --input-placeholder: #64748b;
    /* Status/Alert Colors */
    --success-bg: rgba(16, 185, 129, 0.20);
    --success-border: rgba(16, 185, 129, 0.4);
    --success-text: #6ee7b7;
    --error-bg: rgba(239, 68, 68, 0.20);
    --error-border: rgba(239, 68, 68, 0.4);
    --error-text: #fca5a5;
    --warning-bg: rgba(245, 158, 11, 0.20);
    --warning-border: rgba(245, 158, 11, 0.4);
    --warning-text: #fcd34d;
    --info-bg: rgba(59, 130, 246, 0.20);
    --info-border: rgba(59, 130, 246, 0.4);
    --info-text: #93c5fd;
    /* Table Colors */
    --table-header-bg: #0f172a;
    --table-header-text: #f1f5f9;
    --table-row-hover: #334155;
    --table-border: #334155;
    --table-stripe: #1e293b;
    /* Modal & Overlay */
    --modal-bg: #1e293b;
    --modal-header-bg: #0f172a;
    --modal-overlay: rgba(0, 0, 0, 0.8);
    /* Scrollbar */
    --scrollbar-track: #1e293b;
    --scrollbar-thumb: #475569;
    --scrollbar-thumb-hover: #64748b;
    /* Layout-Specific: TopNav */
    --topnav-bg: #1e293b;
    --topnav-shadow: 0 1px 4px rgba(0, 0, 0, 0.3), 0 2px 12px rgba(0, 0, 0, 0.2);
    --topnav-brand-color: #60a5fa;
    --topnav-brand-hover-bg: #3b82f6;
    --topnav-brand-hover-text: #ffffff;
    --topnav-user-hover-bg: #334155;
    --topnav-user-name-color: #f1f5f9;
    --topnav-user-balance-color: #94a3b8;
    --topnav-logo-text-color: #f1f5f9;
    /* Layout-Specific: Dropdown */
    --dropdown-bg: #1e293b;
    --dropdown-border: #334155;
    --dropdown-shadow: 0 8px 24px rgba(0, 0, 0, 0.4);
    --dropdown-header-bg: linear-gradient(135deg, #0f172a, #1e293b);
    --dropdown-header-border: #334155;
    --dropdown-avatar-bg: linear-gradient(135deg, #3b82f6, #60a5fa);
    --dropdown-name-color: #f1f5f9;
    --dropdown-login-color: #94a3b8;
    --dropdown-badge-bg: #334155;
    --dropdown-badge-border: #475569;
    --dropdown-badge-color: #60a5fa;
    --dropdown-info-bg: #0f172a;
    --dropdown-info-border: #334155;
    --dropdown-info-title-color: #60a5fa;
    --dropdown-info-label-color: #64748b;
    --dropdown-info-value-color: #cbd5e1;
    --dropdown-section-label-color: #64748b;
    --dropdown-item-color: #cbd5e1;
    --dropdown-item-hover-bg: #334155;
    --dropdown-item-hover-color: #60a5fa;
    --dropdown-divider-color: #334155;
    --dropdown-signout-color: #f87171;
    --dropdown-signout-hover-bg: rgba(239, 68, 68, 0.1);
    --dropdown-signout-hover-color: #ef4444;
    --dropdown-signout-border: #334155;
    --dropdown-icon-profile-bg: rgba(59, 130, 246, 0.15);
    --dropdown-icon-profile-color: #60a5fa;
    --dropdown-icon-entity-bg: rgba(34, 197, 94, 0.15);
    --dropdown-icon-entity-color: #4ade80;
    --dropdown-icon-password-bg: rgba(251, 146, 60, 0.15);
    --dropdown-icon-password-color: #fb923c;
    --dropdown-icon-pin-bg: rgba(168, 85, 247, 0.15);
    --dropdown-icon-pin-color: #a855f7;
    --dropdown-icon-signout-bg: rgba(248, 113, 113, 0.15);
    --dropdown-icon-signout-color: #f87171;
    /* Layout-Specific: Header Gradients (card headers, table heads, modal headers) */
    --header-gradient-from: #1e3a5f;
    --header-gradient-to: #2b5278;
    /* Layout-Specific: Action Buttons */
    --action-btn-bg: linear-gradient(135deg, #3b82f6, #60a5fa);
    --action-btn-hover-bg: linear-gradient(135deg, #2563eb, #3b82f6);
    --action-btn-shadow: 0 2px 8px rgba(59, 130, 246, 0.3);
    --action-btn-hover-shadow: 0 4px 16px rgba(59, 130, 246, 0.4);
    /* Layout-Specific: Sidebar — darker than content for visual separation */
    --sidebar-menu-bg: #0f172a;
    --sidebar-menu-color: #cbd5e1;
    --sidebar-menu-border: #1e293b;
    --sidebar-menu-icon-color: #60a5fa;
    --sidebar-menu-hover-bg: #1e293b;
    --sidebar-menu-hover-color: #60a5fa;
    --sidebar-menu-active-bg: #1e293b;
    --sidebar-menu-active-color: #60a5fa;
    --sidebar-menu-active-border: #3b82f6;
    --sidebar-submenu-bg: #0a1120;
    --sidebar-submenu-color: #94a3b8;
    --sidebar-submenu-border: #1e293b;
    --sidebar-submenu-hover-bg: #1e293b;
    --sidebar-submenu-hover-color: #60a5fa;
    --sidebar-submenu-icon-color: #60a5fa;
    /* Layout-Specific: Footer */
    --footer-bg: transparent;
    --footer-text: #94a3b8;
    /* Dashboard Components */
    --dash-heading-color: #f1f5f9;
    --dash-breadcrumb-color: #64748b;
    --dash-breadcrumb-separator: #475569;
    --dash-breadcrumb-link: #94a3b8;
    --dash-breadcrumb-active: #60a5fa;
    --dash-card-bg: #1e293b;
    --dash-card-border: #334155;
    --dash-card-shadow: 0 1px 4px rgba(0,0,0,0.2);
    --dash-card-header-bg: linear-gradient(135deg, #0f172a, #1e293b);
    --dash-card-header-border: #334155;
    --dash-card-header-title: #f1f5f9;
    --dash-action-bg: #1e293b;
    --dash-action-border: #334155;
    --dash-action-hover-shadow: 0 8px 24px rgba(0,0,0,0.3);
    --dash-action-hover-border: #475569;
    --dash-action-label-color: #cbd5e1;
    --dash-action-label-hover: #f1f5f9;
    --dash-table-th-bg: #0f172a;
    --dash-table-th-border: #334155;
    --dash-table-th-color: #94a3b8;
    --dash-table-td-color: #cbd5e1;
    --dash-table-td-border: #334155;
    --dash-table-row-hover: #334155;
    --dash-stat-bg: #0f172a;
    --dash-stat-border: #334155;
    --dash-stat-value-color: #f1f5f9;
    --dash-stat-label-color: #64748b;
    --dash-stat-footer-bg: #0f172a;
    --dash-stat-footer-border: #334155;
    --dash-stat-footer-link: #60a5fa;
    --dash-notice-color: #94a3b8;
    /* Code Example Components (for Sample Code page) */
    --code-tab-active-text: #b04118;
    --code-copy-btn-bg: #313244;
    --code-copy-btn-text: #cdd6f4;
    --code-copy-btn-hover-text: #ffffff;
    --code-copy-btn-copied-text: #ffffff;
}

/* =================================================================
   THEME: DARK BLUE (Blue-tinted Dark Theme)
   ================================================================= */
body.theme-dark-blue {
    /* Primary Brand Colors */
    --brand-primary: #3b82f6;
    --brand-secondary: #2563eb;
    --brand-accent: #60a5fa;
    /* Text color used on top of --brand-primary surfaces */
    --brand-contrast-text: #ffffff;
    
    /* Background Colors */
    --bg-primary: #0c1a2e;
    --bg-secondary: #1a2942;
    --bg-tertiary: #2d3f5f;
    --bg-overlay: rgba(12, 26, 46, 0.7);
    
    /* Card & Panel Colors */
    --card-bg: #1a2942;
    --card-hover: #2d3f5f;
    --card-border: #2d3f5f;
    --card-shadow: rgba(0, 0, 0, 0.4);
    
    /* Header Colors */
    --header-bg: linear-gradient(135deg, #1a2942 0%, #2d3f5f 100%);
    --header-text: #e0e7ff;
    --header-border: #3f4f6f;
    --header-icon-bg: rgba(59, 130, 246, 0.15);
    --header-icon-text: #e0e7ff;
    --header-hover-bg: rgba(59, 130, 246, 0.2);
    --logo-filter: brightness(0) invert(1);
    
    /* Navbar & Sidebar Colors */
    --navbar-bg: #1a2942;
    --navbar-text: #e0e7ff;
    --navbar-hover: #2d3f5f;
    --navbar-active: #60a5fa;
    --sidebar-bg: #0c1a2e;
    --sidebar-text: #c7d2fe;
    --sidebar-hover: #1a2942;
    --sidebar-active: #3b82f6;
    
    /* Text Colors */
    --text-primary: #e0e7ff;
    --text-secondary: #c7d2fe;
    --text-tertiary: #a5b4fc;
    --text-muted: #6366f1;
    --text-inverse: #0c1a2e;
    
    /* Link Colors */
    --link-color: #60a5fa;
    --link-hover: #93c5fd;
    
    /* Border Colors */
    --border-color: #2d3f5f;
    --border-light: #3f4f6f;
    --border-dark: #1a2942;
    
    /* Form Input Colors */
    --input-bg: #0c1a2e;
    --input-border: #2d3f5f;
    --input-focus-border: #3b82f6;
    --input-focus-shadow: rgba(59, 130, 246, 0.3);
    --input-disabled-bg: #1a2942;
    --input-disabled-text: #6366f1;
    --input-text: #e0e7ff;
    --input-placeholder: #6366f1;

    /* Status/Alert Colors */
    --success-bg: rgba(16, 185, 129, 0.20);
    --success-border: rgba(16, 185, 129, 0.4);
    --success-text: #6ee7b7;
    --error-bg: rgba(239, 68, 68, 0.20);
    --error-border: rgba(239, 68, 68, 0.4);
    --error-text: #fca5a5;
    --warning-bg: rgba(245, 158, 11, 0.20);
    --warning-border: rgba(245, 158, 11, 0.4);
    --warning-text: #fcd34d;
    --info-bg: rgba(59, 130, 246, 0.20);
    --info-border: rgba(59, 130, 246, 0.4);
    --info-text: #93c5fd;

    /* Table Colors */
    --table-header-bg: #0c1a2e;
    --table-header-text: #e0e7ff;
    --table-row-hover: #2d3f5f;
    --table-border: #2d3f5f;
    --table-stripe: #1a2942;
    
    /* Modal & Overlay */
    --modal-bg: #1a2942;
    --modal-header-bg: #0c1a2e;
    --modal-overlay: rgba(12, 26, 46, 0.85);
    
    /* Scrollbar */
    --scrollbar-track: #1a2942;
    --scrollbar-thumb: #3f4f6f;
    --scrollbar-thumb-hover: #4f5f8f;

    /* Layout-Specific: TopNav */
    --topnav-bg: #1a2942;
    --topnav-shadow: 0 1px 4px rgba(0, 0, 0, 0.3), 0 2px 12px rgba(12, 26, 46, 0.3);
    --topnav-brand-color: #60a5fa;
    --topnav-brand-hover-bg: #3b82f6;
    --topnav-brand-hover-text: #ffffff;
    --topnav-user-hover-bg: #2d3f5f;
    --topnav-user-name-color: #e0e7ff;
    --topnav-user-balance-color: #a5b4fc;
    --topnav-logo-text-color: #e0e7ff;

    /* Layout-Specific: Dropdown */
    --dropdown-bg: #1a2942;
    --dropdown-border: #2d3f5f;
    --dropdown-shadow: 0 8px 24px rgba(0, 0, 0, 0.5);
    --dropdown-header-bg: linear-gradient(135deg, #0c1a2e, #1a2942);
    --dropdown-header-border: #2d3f5f;
    --dropdown-avatar-bg: linear-gradient(135deg, #3b82f6, #60a5fa);
    --dropdown-name-color: #e0e7ff;
    --dropdown-login-color: #a5b4fc;
    --dropdown-badge-bg: #2d3f5f;
    --dropdown-badge-border: #3f4f6f;
    --dropdown-badge-color: #60a5fa;
    --dropdown-info-bg: #0c1a2e;
    --dropdown-info-border: #2d3f5f;
    --dropdown-info-title-color: #60a5fa;
    --dropdown-info-label-color: #6366f1;
    --dropdown-info-value-color: #c7d2fe;
    --dropdown-section-label-color: #6366f1;
    --dropdown-item-color: #c7d2fe;
    --dropdown-item-hover-bg: #2d3f5f;
    --dropdown-item-hover-color: #60a5fa;
    --dropdown-divider-color: #2d3f5f;
    --dropdown-signout-color: #f87171;
    --dropdown-signout-hover-bg: rgba(239, 68, 68, 0.1);
    --dropdown-signout-hover-color: #ef4444;
    --dropdown-signout-border: #2d3f5f;
    --dropdown-icon-profile-bg: rgba(96, 165, 250, 0.15);
    --dropdown-icon-profile-color: #60a5fa;
    --dropdown-icon-entity-bg: rgba(52, 211, 153, 0.15);
    --dropdown-icon-entity-color: #34d399;
    --dropdown-icon-password-bg: rgba(251, 146, 60, 0.15);
    --dropdown-icon-password-color: #fb923c;
    --dropdown-icon-pin-bg: rgba(129, 140, 248, 0.15);
    --dropdown-icon-pin-color: #818cf8;
    --dropdown-icon-signout-bg: rgba(248, 113, 113, 0.15);
    --dropdown-icon-signout-color: #f87171;

    /* Layout-Specific: Header Gradients (card headers, table heads, modal headers) */
    --header-gradient-from: #1a3568;
    --header-gradient-to: #2a5298;

    /* Layout-Specific: Action Buttons */
    --action-btn-bg: linear-gradient(135deg, #3b82f6, #60a5fa);
    --action-btn-hover-bg: linear-gradient(135deg, #2563eb, #3b82f6);
    --action-btn-shadow: 0 2px 8px rgba(59, 130, 246, 0.35);
    --action-btn-hover-shadow: 0 4px 16px rgba(59, 130, 246, 0.45);

    /* Layout-Specific: Sidebar — darker than content for visual separation */
    --sidebar-menu-bg: #0c1a2e;
    --sidebar-menu-color: #c7d2fe;
    --sidebar-menu-border: #1a2942;
    --sidebar-menu-icon-color: #60a5fa;
    --sidebar-menu-hover-bg: #1a2942;
    --sidebar-menu-hover-color: #60a5fa;
    --sidebar-menu-active-bg: #1a2942;
    --sidebar-menu-active-color: #60a5fa;
    --sidebar-menu-active-border: #3b82f6;
    --sidebar-submenu-bg: #081422;
    --sidebar-submenu-color: #a5b4fc;
    --sidebar-submenu-border: #1a2942;
    --sidebar-submenu-hover-bg: #1a2942;
    --sidebar-submenu-hover-color: #60a5fa;
    --sidebar-submenu-icon-color: #60a5fa;

    /* Layout-Specific: Footer */
    --footer-bg: transparent;
    --footer-text: #a5b4fc;

    /* Dashboard Components */
    --dash-heading-color: #e0e7ff;
    --dash-breadcrumb-color: #6366f1;
    --dash-breadcrumb-separator: #3f4f6f;
    --dash-breadcrumb-link: #a5b4fc;
    --dash-breadcrumb-active: #60a5fa;
    --dash-card-bg: #1a2942;
    --dash-card-border: #2d3f5f;
    --dash-card-shadow: 0 1px 4px rgba(0,0,0,0.3);
    --dash-card-header-bg: linear-gradient(135deg, #0c1a2e, #1a2942);
    --dash-card-header-border: #2d3f5f;
    --dash-card-header-title: #e0e7ff;
    --dash-action-bg: #1a2942;
    --dash-action-border: #2d3f5f;
    --dash-action-hover-shadow: 0 8px 24px rgba(0,0,0,0.35);
    --dash-action-hover-border: #3f4f6f;
    --dash-action-label-color: #c7d2fe;
    --dash-action-label-hover: #e0e7ff;
    --dash-table-th-bg: #0c1a2e;
    --dash-table-th-border: #2d3f5f;
    --dash-table-th-color: #a5b4fc;
    --dash-table-td-color: #c7d2fe;
    --dash-table-td-border: #2d3f5f;
    --dash-table-row-hover: #2d3f5f;
    --dash-stat-bg: #0c1a2e;
    --dash-stat-border: #2d3f5f;
    --dash-stat-value-color: #e0e7ff;
    --dash-stat-label-color: #6366f1;
    --dash-stat-footer-bg: #0c1a2e;
    --dash-stat-footer-border: #2d3f5f;
    --dash-stat-footer-link: #60a5fa;
    --dash-notice-color: #a5b4fc;

    /* Code Example Components (for Sample Code page) */
    --code-tab-active-text: #93c5fd;
    --code-copy-btn-bg: #0c1a2e;
    --code-copy-btn-text: #c7d2fe;
    --code-copy-btn-hover-text: #ffffff;
    --code-copy-btn-copied-text: #ffffff;
}

/* =================================================================
   THEME: DARK PURPLE (Purple-tinted Dark Theme)
   ================================================================= */
body.theme-dark-purple {
    /* Primary Brand Colors */
    --brand-primary: #8b5cf6;
    --brand-secondary: #7c3aed;
    --brand-accent: #a78bfa;
    /* Text color used on top of --brand-primary surfaces */
    --brand-contrast-text: #ffffff;
    
    /* Background Colors */
    --bg-primary: #1a0d2e;
    --bg-secondary: #2d1b4e;
    --bg-tertiary: #3e2a5f;
    --bg-overlay: rgba(26, 13, 46, 0.7);
    
    /* Card & Panel Colors */
    --card-bg: #2d1b4e;
    --card-hover: #3e2a5f;
    --card-border: #3e2a5f;
    --card-shadow: rgba(0, 0, 0, 0.5);
    
    /* Header Colors */
    --header-bg: linear-gradient(135deg, #2d1b4e 0%, #3e2a5f 100%);
    --header-text: #ede9fe;
    --header-border: #4e3a7f;
    --header-icon-bg: rgba(139, 92, 246, 0.15);
    --header-icon-text: #ede9fe;
    --header-hover-bg: rgba(139, 92, 246, 0.2);
    --logo-filter: brightness(0) invert(1);
    
    /* Navbar & Sidebar Colors */
    --navbar-bg: #2d1b4e;
    --navbar-text: #ede9fe;
    --navbar-hover: #3e2a5f;
    --navbar-active: #a78bfa;
    --sidebar-bg: #1a0d2e;
    --sidebar-text: #ddd6fe;
    --sidebar-hover: #2d1b4e;
    --sidebar-active: #8b5cf6;
    
    /* Text Colors */
    --text-primary: #ede9fe;
    --text-secondary: #ddd6fe;
    --text-tertiary: #c4b5fd;
    --text-muted: #a78bfa;
    --text-inverse: #1a0d2e;
    
    /* Link Colors */
    --link-color: #a78bfa;
    --link-hover: #c4b5fd;
    
    /* Border Colors */
    --border-color: #3e2a5f;
    --border-light: #4e3a7f;
    --border-dark: #2d1b4e;
    
    /* Form Input Colors */
    --input-bg: #1a0d2e;
    --input-border: #3e2a5f;
    --input-focus-border: #8b5cf6;
    --input-focus-shadow: rgba(139, 92, 246, 0.3);
    --input-disabled-bg: #2d1b4e;
    --input-disabled-text: #a78bfa;
    --input-text: #ede9fe;
    --input-placeholder: #a78bfa;

    /* Status/Alert Colors */
    --success-bg: rgba(16, 185, 129, 0.20);
    --success-border: rgba(16, 185, 129, 0.4);
    --success-text: #6ee7b7;
    --error-bg: rgba(239, 68, 68, 0.20);
    --error-border: rgba(239, 68, 68, 0.4);
    --error-text: #fca5a5;
    --warning-bg: rgba(245, 158, 11, 0.20);
    --warning-border: rgba(245, 158, 11, 0.4);
    --warning-text: #fcd34d;
    --info-bg: rgba(139, 92, 246, 0.20);
    --info-border: rgba(139, 92, 246, 0.4);
    --info-text: #c4b5fd;

    /* Table Colors */
    --table-header-bg: #1a0d2e;
    --table-header-text: #ede9fe;
    --table-row-hover: #3e2a5f;
    --table-border: #3e2a5f;
    --table-stripe: #2d1b4e;
    
    /* Modal & Overlay */
    --modal-bg: #2d1b4e;
    --modal-header-bg: #1a0d2e;
    --modal-overlay: rgba(26, 13, 46, 0.85);
    
    /* Scrollbar */
    --scrollbar-track: #2d1b4e;
    --scrollbar-thumb: #4e3a7f;
    --scrollbar-thumb-hover: #5e4a9f;

    /* Layout-Specific: TopNav */
    --topnav-bg: #2d1b4e;
    --topnav-shadow: 0 1px 4px rgba(0, 0, 0, 0.3), 0 2px 12px rgba(26, 13, 46, 0.3);
    --topnav-brand-color: #a78bfa;
    --topnav-brand-hover-bg: #8b5cf6;
    --topnav-brand-hover-text: #ffffff;
    --topnav-user-hover-bg: #3e2a5f;
    --topnav-user-name-color: #ede9fe;
    --topnav-user-balance-color: #c4b5fd;
    --topnav-logo-text-color: #ede9fe;

    /* Layout-Specific: Dropdown */
    --dropdown-bg: #2d1b4e;
    --dropdown-border: #3e2a5f;
    --dropdown-shadow: 0 8px 24px rgba(0, 0, 0, 0.5);
    --dropdown-header-bg: linear-gradient(135deg, #1a0d2e, #2d1b4e);
    --dropdown-header-border: #3e2a5f;
    --dropdown-avatar-bg: linear-gradient(135deg, #8b5cf6, #a78bfa);
    --dropdown-name-color: #ede9fe;
    --dropdown-login-color: #c4b5fd;
    --dropdown-badge-bg: #3e2a5f;
    --dropdown-badge-border: #4e3a7f;
    --dropdown-badge-color: #a78bfa;
    --dropdown-info-bg: #1a0d2e;
    --dropdown-info-border: #3e2a5f;
    --dropdown-info-title-color: #a78bfa;
    --dropdown-info-label-color: #a78bfa;
    --dropdown-info-value-color: #ddd6fe;
    --dropdown-section-label-color: #a78bfa;
    --dropdown-item-color: #ddd6fe;
    --dropdown-item-hover-bg: #3e2a5f;
    --dropdown-item-hover-color: #a78bfa;
    --dropdown-divider-color: #3e2a5f;
    --dropdown-signout-color: #f87171;
    --dropdown-signout-hover-bg: rgba(239, 68, 68, 0.1);
    --dropdown-signout-hover-color: #ef4444;
    --dropdown-signout-border: #3e2a5f;
    --dropdown-icon-profile-bg: rgba(167, 139, 250, 0.15);
    --dropdown-icon-profile-color: #a78bfa;
    --dropdown-icon-entity-bg: rgba(52, 211, 153, 0.15);
    --dropdown-icon-entity-color: #34d399;
    --dropdown-icon-password-bg: rgba(251, 146, 60, 0.15);
    --dropdown-icon-password-color: #fb923c;
    --dropdown-icon-pin-bg: rgba(244, 114, 182, 0.15);
    --dropdown-icon-pin-color: #f472b6;
    --dropdown-icon-signout-bg: rgba(248, 113, 113, 0.15);
    --dropdown-icon-signout-color: #f87171;

    /* Layout-Specific: Header Gradients (card headers, table heads, modal headers) */
    --header-gradient-from: #3b2070;
    --header-gradient-to: #5a3a96;

    /* Layout-Specific: Action Buttons */
    --action-btn-bg: linear-gradient(135deg, #8b5cf6, #a78bfa);
    --action-btn-hover-bg: linear-gradient(135deg, #7c3aed, #8b5cf6);
    --action-btn-shadow: 0 2px 8px rgba(139, 92, 246, 0.35);
    --action-btn-hover-shadow: 0 4px 16px rgba(139, 92, 246, 0.45);

    /* Layout-Specific: Sidebar — darker than content for visual separation */
    --sidebar-menu-bg: #1a0d2e;
    --sidebar-menu-color: #ddd6fe;
    --sidebar-menu-border: #2d1b4e;
    --sidebar-menu-icon-color: #a78bfa;
    --sidebar-menu-hover-bg: #2d1b4e;
    --sidebar-menu-hover-color: #a78bfa;
    --sidebar-menu-active-bg: #2d1b4e;
    --sidebar-menu-active-color: #a78bfa;
    --sidebar-menu-active-border: #8b5cf6;
    --sidebar-submenu-bg: #130824;
    --sidebar-submenu-color: #c4b5fd;
    --sidebar-submenu-border: #2d1b4e;
    --sidebar-submenu-hover-bg: #2d1b4e;
    --sidebar-submenu-hover-color: #a78bfa;
    --sidebar-submenu-icon-color: #a78bfa;

    /* Layout-Specific: Footer */
    --footer-bg: transparent;
    --footer-text: #c4b5fd;

    /* Dashboard Components */
    --dash-heading-color: #ede9fe;
    --dash-breadcrumb-color: #a78bfa;
    --dash-breadcrumb-separator: #4e3a7f;
    --dash-breadcrumb-link: #c4b5fd;
    --dash-breadcrumb-active: #a78bfa;
    --dash-card-bg: #2d1b4e;
    --dash-card-border: #3e2a5f;
    --dash-card-shadow: 0 1px 4px rgba(0,0,0,0.3);
    --dash-card-header-bg: linear-gradient(135deg, #1a0d2e, #2d1b4e);
    --dash-card-header-border: #3e2a5f;
    --dash-card-header-title: #ede9fe;
    --dash-action-bg: #2d1b4e;
    --dash-action-border: #3e2a5f;
    --dash-action-hover-shadow: 0 8px 24px rgba(0,0,0,0.4);
    --dash-action-hover-border: #4e3a7f;
    --dash-action-label-color: #ddd6fe;
    --dash-action-label-hover: #ede9fe;
    --dash-table-th-bg: #1a0d2e;
    --dash-table-th-border: #3e2a5f;
    --dash-table-th-color: #c4b5fd;
    --dash-table-td-color: #ddd6fe;
    --dash-table-td-border: #3e2a5f;
    --dash-table-row-hover: #3e2a5f;
    --dash-stat-bg: #1a0d2e;
    --dash-stat-border: #3e2a5f;
    --dash-stat-value-color: #ede9fe;
    --dash-stat-label-color: #a78bfa;
    --dash-stat-footer-bg: #1a0d2e;
    --dash-stat-footer-border: #3e2a5f;
    --dash-stat-footer-link: #a78bfa;
    --dash-notice-color: #c4b5fd;

    /* Code Example Components (for Sample Code page) */
    --code-tab-active-text: #ffffff;
    --code-copy-btn-bg: #1a0d2e;
    --code-copy-btn-text: #ddd6fe;
    --code-copy-btn-hover-text: #ffffff;
    --code-copy-btn-copied-text: #ffffff;
}

/* =================================================================
   RESPONSIVE ADJUSTMENTS
   ================================================================= */
@media (max-width: 768px) {
    :root, body[class*="theme-"] {
        /* Slightly adjust shadows for mobile */
        --shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.08);
        --shadow-md: 0 2px 4px -1px rgba(0, 0, 0, 0.12);
        --shadow-lg: 0 6px 10px -2px rgba(0, 0, 0, 0.12);
        --shadow-xl: 0 12px 18px -3px rgba(0, 0, 0, 0.15);
    }
}