@semanticus/semanticus-css 0.7.0 → 0.9.0

package/src/variables/_breakpoints.css

@@ -0,0 +1,10 @@
+/* ==========================================================================
+   Responsive Breakpoints (custom media queries)
+   Used consistently across semantics, variants, and utilities.
+   ========================================================================== */
+
+@custom-media --breakpoint-sm (min-width: 576px);
+@custom-media --breakpoint-md (min-width: 768px);
+@custom-media --breakpoint-lg (min-width: 1024px);
+@custom-media --breakpoint-xl (min-width: 1280px);
+@custom-media --breakpoint-xxl (min-width: 1536px);

package/src/variables/_colors.css

@@ -0,0 +1,355 @@
+/* ==========================================================================
+   Color Variables
+   ==========================================================================
+
+   Semantic color system with RGB values for opacity manipulation,
+   theme-aware variables for light/dark modes, and component color roles.
+
+   Naming convention:
+     --color-{role}           Text color for links, buttons, inline elements
+     --color-{role}-bg        Background fill
+     --color-{role}-border    Border color
+     --color-{role}-underline Semi-transparent underline for links
+     --color-{role}-hover     Text color on hover
+     --color-{role}-hover-bg  Background on hover
+     --color-{role}-focus     Focus ring / outline color
+     --color-{role}-inverse   Text on top of filled backgrounds
+
+   Roles: primary (brand CTA), secondary (neutral actions), contrast (high-emphasis)
+   ========================================================================== */
+
+/* ==========================================================================
+   Light Theme (Default)
+   ========================================================================== */
+
+[data-theme="light"],
+:root:not([data-theme="dark"]),
+:host(:not([data-theme="dark"])) {
+  color-scheme: light;
+
+  /* RGB channels */
+  --color-primary-rgb: 1, 114, 173;
+  --color-secondary-rgb: 93, 107, 137;
+  --color-contrast-rgb: 24, 28, 37;
+  --color-success-rgb: 43, 122, 76;
+  --color-info-rgb: 4, 120, 120;
+  --color-warning-rgb: 255, 191, 0;
+  --color-danger-rgb: 197, 47, 33;
+
+  /* Body & emphasis RGB */
+  --color-body-rgb: 55, 60, 68;
+  --color-text-rgb: 55, 60, 68;
+  --color-body-bg-rgb: 255, 255, 255;
+  --color-emphasis-rgb: 24, 28, 37;
+
+  /* Secondary surfaces */
+  --color-secondary-bg-rgb: 233, 236, 239;
+
+  /* Link RGB */
+  --color-link-rgb: 1, 114, 173;
+
+  /* Emphasis colors (RGB format for use with rgba()) */
+  --color-primary-emphasis-rgb: 1, 88, 135;
+  --color-secondary-emphasis-rgb: 72, 83, 107;
+  --color-success-emphasis-rgb: 32, 96, 59;
+  --color-info-emphasis-rgb: 2, 93, 93;
+  --color-warning-emphasis-rgb: 105, 77, 0;
+  --color-danger-emphasis-rgb: 155, 35, 24;
+  --color-contrast-emphasis-rgb: 248, 249, 250;
+
+  /* Subtle backgrounds (low opacity) */
+  --color-primary-bg-subtle: rgba(var(--color-primary-rgb), 0.1);
+  --color-secondary-bg-subtle: rgba(var(--color-secondary-rgb), 0.1);
+  --color-success-bg-subtle: rgba(var(--color-success-rgb), 0.1);
+  --color-info-bg-subtle: rgba(var(--color-info-rgb), 0.1);
+  --color-warning-bg-subtle: rgba(var(--color-warning-rgb), 0.1);
+  --color-danger-bg-subtle: rgba(var(--color-danger-rgb), 0.1);
+  --color-contrast-bg-subtle: rgba(var(--color-contrast-rgb), 0.85);
+
+  /* Subtle borders (medium opacity) */
+  --color-primary-border-subtle: rgba(var(--color-primary-rgb), 0.35);
+  --color-secondary-border-subtle: rgba(var(--color-secondary-rgb), 0.35);
+  --color-success-border-subtle: rgba(var(--color-success-rgb), 0.35);
+  --color-info-border-subtle: rgba(var(--color-info-rgb), 0.35);
+  --color-warning-border-subtle: rgba(var(--color-warning-rgb), 0.35);
+  --color-danger-border-subtle: rgba(var(--color-danger-rgb), 0.35);
+  --color-contrast-border-subtle: rgb(var(--color-contrast-rgb));
+
+  /* Status inverse colors */
+  --color-success-inverse: #fff;
+  --color-info-inverse: #fff;
+  --color-warning-inverse: #000;
+  --color-danger-inverse: #fff;
+
+  /* Core Colors */
+  --color-body-bg: rgb(var(--color-body-bg-rgb));
+  --color-background: var(--color-body-bg);
+  --color-text: rgb(var(--color-text-rgb));
+  --color-text-selection: rgba(2, 154, 232, 0.25);
+  --color-text-muted: color-mix(in srgb, rgb(var(--color-text-rgb)), rgb(128, 128, 128) 70%);
+  --color-border-muted: rgb(231, 234, 239.5);
+
+  /* Primary */
+  --color-primary-bg: #0172ad;
+  --color-primary-border: var(--color-primary-bg);
+  --color-primary-underline: rgba(var(--color-primary-rgb), 0.5);
+  --color-primary-hover: #015887;
+  --color-primary-hover-bg: #02659a;
+  --color-primary-hover-border: var(--color-primary-hover-bg);
+  --color-primary-hover-underline: var(--color-primary-hover);
+  --color-primary-focus: rgba(2, 154, 232, 0.5);
+  --color-primary-inverse: #fff;
+
+  /* Secondary */
+  --color-secondary-bg: #525f7a;
+  --color-secondary-border: var(--color-secondary-bg);
+  --color-secondary-underline: rgba(var(--color-secondary-rgb), 0.5);
+  --color-secondary-hover: #48536b;
+  --color-secondary-hover-bg: #48536b;
+  --color-secondary-hover-border: var(--color-secondary-hover-bg);
+  --color-secondary-hover-underline: var(--color-secondary-hover);
+  --color-secondary-focus: rgba(var(--color-secondary-rgb), 0.25);
+  --color-secondary-inverse: #fff;
+
+  /* Contrast */
+  --color-contrast-bg: #181c25;
+  --color-contrast-border: var(--color-contrast-bg);
+  --color-contrast-underline: rgba(var(--color-contrast-rgb), 0.5);
+  --color-contrast-hover: #000;
+  --color-contrast-hover-bg: #000;
+  --color-contrast-hover-border: var(--color-contrast-hover-bg);
+  --color-contrast-hover-underline: var(--color-contrast-hover);
+  --color-contrast-focus: rgba(93, 107, 137, 0.25);
+  --color-contrast-inverse: #fff;
+
+  /* Shadows */
+  --shadow-sm: 0 0.0625rem 0.125rem rgba(129, 145, 181, 0.1);
+  --shadow-md: 0.0625rem 0.125rem 0.5rem rgba(129, 145, 181, 0.15);
+  --shadow-lg: 0.0145rem 0.029rem 0.174rem rgba(129, 145, 181, 0.01698), 0.0335rem 0.067rem 0.402rem rgba(129, 145, 181, 0.024), 0.0625rem 0.125rem 0.75rem rgba(129, 145, 181, 0.03), 0.1125rem 0.225rem 1.35rem rgba(129, 145, 181, 0.036), 0.2085rem 0.417rem 2.502rem rgba(129, 145, 181, 0.04302), 0.5rem 1rem 6rem rgba(129, 145, 181, 0.06), 0 0 0 0.0625rem rgba(129, 145, 181, 0.015);
+
+  /* Headings - base color for progressive lightness via color-mix */
+  --color-heading-base: #2d3138;
+
+  /* Mark & Text */
+  --color-mark-bg: rgb(252.5, 230.5, 191.5);
+  --color-mark-text: #0f1114;
+}
+
+/* ==========================================================================
+   Dark Theme (System Preference)
+   ========================================================================== */
+
+@media only screen and (prefers-color-scheme: dark) {
+  :root:not([data-theme]),
+  :host(:not([data-theme])) {
+    color-scheme: dark;
+
+    /* RGB channels */
+    --color-primary-rgb: 1, 170, 255;
+    --color-secondary-rgb: 150, 158, 175;
+    --color-contrast-rgb: 248, 249, 250;
+    --color-success-rgb: 110, 213, 157;
+    --color-info-rgb: 10, 194, 194;
+    --color-warning-rgb: 255, 191, 0;
+    --color-danger-rgb: 243, 143, 121;
+
+    /* Body & emphasis RGB */
+    --color-body-rgb: 194, 199, 208;
+    --color-text-rgb: 194, 199, 208;
+    --color-body-bg-rgb: 19, 23, 31;
+    --color-emphasis-rgb: 223, 227, 235;
+
+    /* Secondary surfaces */
+    --color-secondary-bg-rgb: 42, 49, 64;
+
+    /* Link RGB */
+    --color-link-rgb: 1, 170, 255;
+
+    /* Emphasis colors */
+    --color-primary-emphasis-rgb: 121, 192, 255;
+    --color-secondary-emphasis-rgb: 179, 185, 197;
+    --color-success-emphasis-rgb: 147, 222, 181;
+    --color-info-emphasis-rgb: 37, 221, 221;
+    --color-warning-emphasis-rgb: 232, 174, 1;
+    --color-danger-emphasis-rgb: 245, 183, 168;
+    --color-contrast-emphasis-rgb: 24, 28, 37;
+
+    /* Subtle backgrounds */
+    --color-primary-bg-subtle: rgba(var(--color-primary-rgb), 0.15);
+    --color-secondary-bg-subtle: rgba(var(--color-secondary-rgb), 0.15);
+    --color-success-bg-subtle: rgba(var(--color-success-rgb), 0.15);
+    --color-info-bg-subtle: rgba(var(--color-info-rgb), 0.15);
+    --color-warning-bg-subtle: rgba(var(--color-warning-rgb), 0.15);
+    --color-danger-bg-subtle: rgba(var(--color-danger-rgb), 0.15);
+    --color-contrast-bg-subtle: color-mix(in srgb, rgb(var(--color-contrast-rgb)), black 7%);
+
+    /* Subtle borders */
+    --color-primary-border-subtle: rgba(var(--color-primary-rgb), 0.35);
+    --color-secondary-border-subtle: rgba(var(--color-secondary-rgb), 0.35);
+    --color-success-border-subtle: rgba(var(--color-success-rgb), 0.35);
+    --color-info-border-subtle: rgba(var(--color-info-rgb), 0.35);
+    --color-warning-border-subtle: rgba(var(--color-warning-rgb), 0.35);
+    --color-danger-border-subtle: rgba(var(--color-danger-rgb), 0.35);
+    --color-contrast-border-subtle: rgb(var(--color-contrast-rgb));
+
+    /* Core Colors */
+    --color-background: rgb(19, 22.5, 30.5);
+    --color-text: rgb(var(--color-text-rgb));
+    --color-text-selection: rgba(var(--color-primary-rgb), 0.1875);
+    --color-text-muted: color-mix(in srgb, rgb(var(--color-text-rgb)), rgb(128, 128, 128) 70%);
+    --color-border-muted: #202632;
+
+    /* Primary */
+    --color-primary-bg: #0172ad;
+    --color-primary-border: var(--color-primary-bg);
+    --color-primary-underline: rgba(var(--color-primary-rgb), 0.5);
+    --color-primary-hover: #79c0ff;
+    --color-primary-hover-bg: #017fc0;
+    --color-primary-hover-border: var(--color-primary-hover-bg);
+    --color-primary-hover-underline: var(--color-primary-hover);
+    --color-primary-focus: rgba(var(--color-primary-rgb), 0.375);
+    --color-primary-inverse: #fff;
+
+    /* Secondary */
+    --color-secondary-bg: #525f7a;
+    --color-secondary-border: var(--color-secondary-bg);
+    --color-secondary-underline: rgba(var(--color-secondary-rgb), 0.5);
+    --color-secondary-hover: #b3b9c5;
+    --color-secondary-hover-bg: #5d6b89;
+    --color-secondary-hover-border: var(--color-secondary-hover-bg);
+    --color-secondary-hover-underline: var(--color-secondary-hover);
+    --color-secondary-focus: rgba(144, 158, 190, 0.25);
+    --color-secondary-inverse: #fff;
+
+    /* Contrast */
+    --color-contrast-bg: #eff1f4;
+    --color-contrast-border: var(--color-contrast-bg);
+    --color-contrast-underline: rgba(var(--color-contrast-rgb), 0.5);
+    --color-contrast-hover: #fff;
+    --color-contrast-hover-bg: #fff;
+    --color-contrast-hover-border: var(--color-contrast-hover-bg);
+    --color-contrast-hover-underline: var(--color-contrast-hover);
+    --color-contrast-focus: rgba(207, 213, 226, 0.25);
+    --color-contrast-inverse: #000;
+
+    /* Shadows */
+    --shadow-sm: 0 0.0625rem 0.125rem rgba(7, 8.5, 12, 0.1);
+    --shadow-md: 0.0625rem 0.125rem 0.5rem rgba(7, 8.5, 12, 0.15);
+    --shadow-lg: 0.0145rem 0.029rem 0.174rem rgba(7, 8.5, 12, 0.01698), 0.0335rem 0.067rem 0.402rem rgba(7, 8.5, 12, 0.024), 0.0625rem 0.125rem 0.75rem rgba(7, 8.5, 12, 0.03), 0.1125rem 0.225rem 1.35rem rgba(7, 8.5, 12, 0.036), 0.2085rem 0.417rem 2.502rem rgba(7, 8.5, 12, 0.04302), 0.5rem 1rem 6rem rgba(7, 8.5, 12, 0.06), 0 0 0 0.0625rem rgba(7, 8.5, 12, 0.015);
+
+    /* Headings */
+    --color-heading-base: #f0f1f3;
+
+    /* Mark & Text */
+    --color-mark-bg: #014063;
+    --color-mark-text: #fff;
+  }
+}
+
+/* ==========================================================================
+   Dark Theme (Explicit)
+   ========================================================================== */
+
+[data-theme="dark"] {
+  color-scheme: dark;
+
+  /* RGB channels */
+  --color-primary-rgb: 1, 170, 255;
+  --color-secondary-rgb: 150, 158, 175;
+  --color-contrast-rgb: 248, 249, 250;
+  --color-success-rgb: 110, 213, 157;
+  --color-info-rgb: 10, 194, 194;
+  --color-warning-rgb: 255, 191, 0;
+  --color-danger-rgb: 243, 143, 121;
+
+  /* Body & emphasis RGB */
+  --color-body-rgb: 194, 199, 208;
+  --color-text-rgb: 194, 199, 208;
+  --color-body-bg-rgb: 19, 23, 31;
+  --color-emphasis-rgb: 223, 227, 235;
+
+  /* Secondary surfaces */
+  --color-secondary-bg-rgb: 42, 49, 64;
+
+  /* Link RGB */
+  --color-link-rgb: 1, 170, 255;
+
+  /* Emphasis colors */
+  --color-primary-emphasis-rgb: 121, 192, 255;
+  --color-secondary-emphasis-rgb: 179, 185, 197;
+  --color-success-emphasis-rgb: 147, 222, 181;
+  --color-info-emphasis-rgb: 37, 221, 221;
+  --color-warning-emphasis-rgb: 232, 174, 1;
+  --color-danger-emphasis-rgb: 245, 183, 168;
+  --color-contrast-emphasis-rgb: 24, 28, 37;
+
+  /* Subtle backgrounds */
+  --color-primary-bg-subtle: rgba(var(--color-primary-rgb), 0.15);
+  --color-secondary-bg-subtle: rgba(var(--color-secondary-rgb), 0.15);
+  --color-success-bg-subtle: rgba(var(--color-success-rgb), 0.15);
+  --color-info-bg-subtle: rgba(var(--color-info-rgb), 0.15);
+  --color-warning-bg-subtle: rgba(var(--color-warning-rgb), 0.15);
+  --color-danger-bg-subtle: rgba(var(--color-danger-rgb), 0.15);
+  --color-contrast-bg-subtle: color-mix(in srgb, rgb(var(--color-contrast-rgb)), black 7%);
+
+  /* Subtle borders */
+  --color-primary-border-subtle: rgba(var(--color-primary-rgb), 0.35);
+  --color-secondary-border-subtle: rgba(var(--color-secondary-rgb), 0.35);
+  --color-success-border-subtle: rgba(var(--color-success-rgb), 0.35);
+  --color-info-border-subtle: rgba(var(--color-info-rgb), 0.35);
+  --color-warning-border-subtle: rgba(var(--color-warning-rgb), 0.35);
+  --color-danger-border-subtle: rgba(var(--color-danger-rgb), 0.35);
+  --color-contrast-border-subtle: rgb(var(--color-contrast-rgb));
+
+  /* Core Colors */
+  --color-background: rgb(19, 22.5, 30.5);
+  --color-text: #c2c7d0;
+  --color-text-selection: rgba(var(--color-primary-rgb), 0.1875);
+  --color-text-muted: color-mix(in srgb, rgb(var(--color-text-rgb)), rgb(128, 128, 128) 70%);
+  --color-border-muted: #202632;
+
+  /* Primary */
+  --color-primary-bg: #0172ad;
+  --color-primary-border: var(--color-primary-bg);
+  --color-primary-underline: rgba(var(--color-primary-rgb), 0.5);
+  --color-primary-hover: #79c0ff;
+  --color-primary-hover-bg: #017fc0;
+  --color-primary-hover-border: var(--color-primary-hover-bg);
+  --color-primary-hover-underline: var(--color-primary-hover);
+  --color-primary-focus: rgba(var(--color-primary-rgb), 0.375);
+  --color-primary-inverse: #fff;
+
+  /* Secondary */
+  --color-secondary-bg: #525f7a;
+  --color-secondary-border: var(--color-secondary-bg);
+  --color-secondary-underline: rgba(var(--color-secondary-rgb), 0.5);
+  --color-secondary-hover: #b3b9c5;
+  --color-secondary-hover-bg: #5d6b89;
+  --color-secondary-hover-border: var(--color-secondary-hover-bg);
+  --color-secondary-hover-underline: var(--color-secondary-hover);
+  --color-secondary-focus: rgba(144, 158, 190, 0.25);
+  --color-secondary-inverse: #fff;
+
+  /* Contrast */
+  --color-contrast-bg: #eff1f4;
+  --color-contrast-border: var(--color-contrast-bg);
+  --color-contrast-underline: rgba(var(--color-contrast-rgb), 0.5);
+  --color-contrast-hover: #fff;
+  --color-contrast-hover-bg: #fff;
+  --color-contrast-hover-border: var(--color-contrast-hover-bg);
+  --color-contrast-hover-underline: var(--color-contrast-hover);
+  --color-contrast-focus: rgba(207, 213, 226, 0.25);
+  --color-contrast-inverse: #000;
+
+  /* Shadows */
+  --shadow-sm: 0 0.0625rem 0.125rem rgba(7, 8.5, 12, 0.1);
+  --shadow-md: 0.0625rem 0.125rem 0.5rem rgba(7, 8.5, 12, 0.15);
+  --shadow-lg: 0.0145rem 0.029rem 0.174rem rgba(7, 8.5, 12, 0.01698), 0.0335rem 0.067rem 0.402rem rgba(7, 8.5, 12, 0.024), 0.0625rem 0.125rem 0.75rem rgba(7, 8.5, 12, 0.03), 0.1125rem 0.225rem 1.35rem rgba(7, 8.5, 12, 0.036), 0.2085rem 0.417rem 2.502rem rgba(7, 8.5, 12, 0.04302), 0.5rem 1rem 6rem rgba(7, 8.5, 12, 0.06), 0 0 0 0.0625rem rgba(7, 8.5, 12, 0.015);
+
+  /* Headings */
+  --color-heading-base: #f0f1f3;
+
+  /* Mark & Text */
+  --color-mark-bg: #014063;
+  --color-mark-text: #fff;
+}

package/src/variables/_components.css

@@ -0,0 +1,330 @@
+/* ==========================================================================
+   Component Variables
+   ==========================================================================
+
+   Component-specific CSS custom properties organized by UI component.
+   These define the appearance of buttons, forms, tables, cards, modals,
+   and other interactive elements.
+
+   Each component section is self-contained with all its color, spacing,
+   and state variable definitions.
+   ========================================================================== */
+
+/* ==========================================================================
+   Light Theme Component Variables
+   ========================================================================== */
+
+[data-theme="light"],
+:root:not([data-theme="dark"]),
+:host(:not([data-theme="dark"])) {
+  /* Button */
+  --button-shadow: 0 0 0 rgba(0, 0, 0, 0);
+  --button-shadow-hover: 0 0 0 rgba(0, 0, 0, 0);
+
+  /* Table */
+  --table-border-color: var(--color-border-muted);
+  --table-row-stripe-bg: rgba(111, 120, 135, 0.0375);
+
+  /* Code */
+  --code-bg: rgb(243, 244.5, 246.75);
+  --code-color: #646b79;
+  --kbd-bg: var(--color-text);
+  --kbd-color: var(--color-background);
+
+  /* Form Elements */
+  --form-bg: rgb(251, 251.5, 252.25);
+  --form-selected-bg: #dfe3eb;
+  --form-border-color: #cfd5e2;
+  --form-text-color: #23262c;
+  --form-placeholder-color: var(--color-text-muted);
+  --form-active-bg: #fff;
+  --form-active-border: var(--color-primary-border);
+  --form-focus: var(--color-primary-border);
+  --form-disabled-opacity: 0.5;
+  --form-invalid-border: rgb(var(--color-danger-rgb));
+  --form-invalid-active-border: rgb(var(--color-danger-rgb));
+  --form-invalid-focus: rgba(var(--color-danger-rgb), 0.5);
+  --form-valid-border: rgb(var(--color-success-rgb));
+  --form-valid-active-border: rgb(var(--color-success-rgb));
+  --form-valid-focus: rgba(var(--color-success-rgb), 0.5);
+
+  /* Switch */
+  --switch-bg: #bfc7d9;
+  --switch-checked-bg: var(--color-primary-bg);
+  --switch-thumb-color: #fff;
+  --switch-thumb-shadow: 0 0 0 rgba(0, 0, 0, 0);
+
+  /* Range */
+  --range-border-color: #dfe3eb;
+  --range-active-border: #bfc7d9;
+  --range-thumb-border: var(--color-background);
+  --range-thumb-color: var(--color-secondary-bg);
+  --range-thumb-active: var(--color-primary-bg);
+
+  /* Accordion */
+  --accordion-border: var(--color-border-muted);
+  --accordion-active-summary: var(--color-primary-hover);
+  --accordion-closed-summary: var(--color-text);
+  --accordion-open-summary: var(--color-text-muted);
+
+  /* Card */
+  --pane-bg: var(--color-background);
+  --pane-border: transparent;
+  --pane-shadow: none;
+  --pane-section-border: var(--color-border-muted);
+  --pane-section-bg: rgb(251, 251.5, 252.25);
+
+  /* Menu & Dropdown */
+  --menu-bg: #fff;
+  --menu-border: #eff1f4;
+  --menu-shadow: var(--shadow-lg);
+  --menu-text: var(--color-text);
+  --menu-hover-bg: #eff1f4;
+
+  /* Loading */
+  --loading-spinner-opacity: 0.5;
+
+  /* Progress */
+  --progress-bg: #dfe3eb;
+  --progress-fill: var(--color-primary-bg);
+
+  /* Tooltip */
+  --tooltip-bg: var(--color-contrast-bg);
+  --tooltip-text: var(--color-contrast-inverse);
+
+  /* Backdrop Overlay */
+  --backdrop-overlay-filter: blur(0.375rem);
+  --backdrop-overlay-bg: rgba(232, 234, 237, 0.75);
+}
+
+/* Form focus override for actionable input types in light mode */
+[data-theme="light"] input:is(
+    [type="submit"],
+    [type="button"],
+    [type="reset"],
+    [type="checkbox"],
+    [type="radio"],
+    [type="file"]
+  ),
+:root:not([data-theme="dark"]) input:is(
+    [type="submit"],
+    [type="button"],
+    [type="reset"],
+    [type="checkbox"],
+    [type="radio"],
+    [type="file"]
+  ),
+:host(:not([data-theme="dark"])) input:is(
+    [type="submit"],
+    [type="button"],
+    [type="reset"],
+    [type="checkbox"],
+    [type="radio"],
+    [type="file"]
+  ) {
+  --form-focus: var(--color-primary-focus);
+}
+
+/* ==========================================================================
+   Dark Theme Component Variables (System Preference)
+   ========================================================================== */
+
+@media only screen and (prefers-color-scheme: dark) {
+  :root:not([data-theme]),
+  :host(:not([data-theme])) {
+    /* Button */
+    --button-shadow: 0 0 0 rgba(0, 0, 0, 0);
+    --button-shadow-hover: 0 0 0 rgba(0, 0, 0, 0);
+
+    /* Table */
+    --table-border-color: var(--color-border-muted);
+    --table-row-stripe-bg: rgba(111, 120, 135, 0.0375);
+
+    /* Code */
+    --code-bg: rgb(26, 30.5, 40.25);
+    --code-color: #8891a4;
+    --kbd-bg: var(--color-text);
+    --kbd-color: var(--color-background);
+
+    /* Form Elements */
+    --form-bg: rgb(28, 33, 43.5);
+    --form-selected-bg: #2a3140;
+    --form-border-color: #2a3140;
+    --form-text-color: #e0e3e7;
+    --form-placeholder-color: #8891a4;
+    --form-active-bg: rgb(26, 30.5, 40.25);
+    --form-active-border: var(--color-primary-border);
+    --form-focus: var(--color-primary-border);
+    --form-disabled-opacity: 0.5;
+    --form-invalid-border: rgb(var(--color-danger-rgb));
+    --form-invalid-active-border: rgb(var(--color-danger-rgb));
+    --form-invalid-focus: rgba(var(--color-danger-rgb), 0.5);
+    --form-valid-border: rgb(var(--color-success-rgb));
+    --form-valid-active-border: rgb(var(--color-success-rgb));
+    --form-valid-focus: rgba(var(--color-success-rgb), 0.5);
+
+    /* Switch */
+    --switch-bg: #333c4e;
+    --switch-checked-bg: var(--color-primary-bg);
+    --switch-thumb-color: #fff;
+    --switch-thumb-shadow: 0 0 0 rgba(0, 0, 0, 0);
+
+    /* Range */
+    --range-border-color: #202632;
+    --range-active-border: #2a3140;
+    --range-thumb-border: var(--color-background);
+    --range-thumb-color: var(--color-secondary-bg);
+    --range-thumb-active: var(--color-primary-bg);
+
+    /* Accordion */
+    --accordion-border: var(--color-border-muted);
+    --accordion-active-summary: var(--color-primary-hover);
+    --accordion-closed-summary: var(--color-text);
+    --accordion-open-summary: var(--color-text-muted);
+
+    /* Card */
+    --pane-bg: #181c25;
+    --pane-border: transparent;
+    --pane-shadow: none;
+    --pane-section-border: var(--pane-bg);
+    --pane-section-bg: rgb(26, 30.5, 40.25);
+
+    /* Dropdown */
+    --menu-bg: #181c25;
+    --menu-border: #202632;
+    --menu-shadow: var(--shadow-lg);
+    --menu-text: var(--color-text);
+    --menu-hover-bg: #202632;
+
+    /* Loading & Modal */
+    --loading-spinner-opacity: 0.5;
+
+    /* Progress */
+    --progress-bg: #202632;
+    --progress-fill: var(--color-primary-bg);
+
+    /* Tooltip */
+    --tooltip-bg: var(--color-contrast-bg);
+    --tooltip-text: var(--color-contrast-inverse);
+
+    /* Backdrop Overlay */
+    --backdrop-overlay-filter: blur(0.375rem);
+    --backdrop-overlay-bg: rgba(7.5, 8.5, 10, 0.75);
+  }
+
+  :root:not([data-theme]) input:is(
+      [type="submit"],
+      [type="button"],
+      [type="reset"],
+      [type="checkbox"],
+      [type="radio"],
+      [type="file"]
+    ),
+  :host(:not([data-theme])) input:is(
+      [type="submit"],
+      [type="button"],
+      [type="reset"],
+      [type="checkbox"],
+      [type="radio"],
+      [type="file"]
+    ) {
+    --form-focus: var(--color-primary-focus);
+  }
+}
+
+/* ==========================================================================
+   Dark Theme Component Variables (Explicit)
+   ========================================================================== */
+
+[data-theme="dark"] {
+  /* Button */
+  --button-shadow: 0 0 0 rgba(0, 0, 0, 0);
+  --button-shadow-hover: 0 0 0 rgba(0, 0, 0, 0);
+
+  /* Table */
+  --table-border-color: var(--color-border-muted);
+  --table-row-stripe-bg: rgba(111, 120, 135, 0.0375);
+
+  /* Code */
+  --code-bg: rgb(26, 30.5, 40.25);
+  --code-color: #8891a4;
+  --kbd-bg: var(--color-text);
+  --kbd-color: var(--color-background);
+
+  /* Form Elements */
+  --form-bg: rgb(28, 33, 43.5);
+  --form-selected-bg: #2a3140;
+  --form-border-color: #2a3140;
+  --form-text-color: #e0e3e7;
+  --form-placeholder-color: #8891a4;
+  --form-active-bg: rgb(26, 30.5, 40.25);
+  --form-active-border: var(--color-primary-border);
+  --form-focus: var(--color-primary-border);
+  --form-disabled-opacity: 0.5;
+  --form-invalid-border: rgb(var(--color-danger-rgb));
+  --form-invalid-active-border: rgb(var(--color-danger-rgb));
+  --form-invalid-focus: rgba(var(--color-danger-rgb), 0.5);
+  --form-valid-border: rgb(var(--color-success-rgb));
+  --form-valid-active-border: rgb(var(--color-success-rgb));
+  --form-valid-focus: rgba(var(--color-success-rgb), 0.5);
+
+  /* Switch */
+  --switch-bg: #333c4e;
+  --switch-checked-bg: var(--color-primary-bg);
+  --switch-thumb-color: #fff;
+  --switch-thumb-shadow: 0 0 0 rgba(0, 0, 0, 0);
+
+  /* Range */
+  --range-border-color: #202632;
+  --range-active-border: #2a3140;
+  --range-thumb-border: var(--color-background);
+  --range-thumb-color: var(--color-secondary-bg);
+  --range-thumb-active: var(--color-primary-bg);
+
+  /* Accordion */
+  --accordion-border: var(--color-border-muted);
+  --accordion-active-summary: var(--color-primary-hover);
+  --accordion-closed-summary: var(--color-text);
+  --accordion-open-summary: var(--color-text-muted);
+
+  /* Card */
+  --pane-bg: #181c25;
+  --pane-border: transparent;
+  --pane-shadow: none;
+  --pane-section-border: var(--pane-bg);
+  --pane-section-bg: rgb(26, 30.5, 40.25);
+
+  /* Dropdown */
+  --menu-bg: #181c25;
+  --menu-border: #202632;
+  --menu-shadow: var(--shadow-lg);
+  --menu-text: var(--color-text);
+  --menu-hover-bg: #202632;
+
+  /* Loading */
+  --loading-spinner-opacity: 0.5;
+
+  /* Progress */
+  --progress-bg: #202632;
+  --progress-fill: var(--color-primary-bg);
+
+  /* Tooltip */
+  --tooltip-bg: var(--color-contrast-bg);
+  --tooltip-text: var(--color-contrast-inverse);
+
+  /* Backdrop Overlay */
+  --backdrop-overlay-filter: blur(0.375rem);
+  --backdrop-overlay-bg: rgba(7.5, 8.5, 10, 0.75);
+}
+
+/* Form focus override for actionable input types in explicit dark mode */
+[data-theme="dark"] input:is(
+    [type="submit"],
+    [type="button"],
+    [type="reset"],
+    [type="checkbox"],
+    [type="radio"],
+    [type="file"]
+  ) {
+  --form-focus: var(--color-primary-focus);
+}