Harden setup wizard contrast across themes

Author: alexphillips-dev

src/folderview.plus/usr/local/emhttp/plugins/folderview.plus/styles/folderviewplus.css

@@ -3765,10 +3765,12 @@ body.fv-mobile-compact .fv-setup-field-grid {
     background: rgba(8, 12, 18, 0.985);
     box-shadow: 0 30px 80px rgba(0, 0, 0, 0.55);
     overflow: hidden;
-    color: var(--fvplus-settings-text-primary);
-    --fv-wizard-text-primary: var(--fvplus-settings-text-primary);
-    --fv-wizard-text-muted: var(--fvplus-settings-text-muted);
-    --fv-wizard-text-dim: var(--fvplus-settings-text-dim);
+    /* Keep wizard contrast stable regardless of host Unraid theme tokens. */
+    color-scheme: dark;
+    color: #e7eef9;
+    --fv-wizard-text-primary: #e7eef9;
+    --fv-wizard-text-muted: #c5d4e8;
+    --fv-wizard-text-dim: #a7bad1;
     --fv-wizard-font-103: 1.03rem;
     --fv-wizard-font-108: 1.08rem;
     --fv-wizard-font-115: 1.15rem;
@@ -3781,6 +3783,40 @@ body.fv-mobile-compact .fv-setup-field-grid {
     color: var(--fv-wizard-text-primary);
 }
 
+#fv-setup-assistant-dialog :is(
+    h1,
+    h2,
+    h3,
+    h4,
+    h5,
+    h6,
+    p,
+    span,
+    label,
+    legend,
+    li,
+    strong,
+    small,
+    dt,
+    dd,
+    th,
+    td
+) {
+    color: inherit;
+}
+
+#fv-setup-assistant-dialog .fv-setup-assistant-shell button,
+#fv-setup-assistant-dialog .fv-setup-assistant-shell .btn {
+    color: var(--fv-wizard-text-primary);
+    border-color: rgba(255, 255, 255, 0.22);
+    background: rgba(255, 255, 255, 0.05);
+}
+
+#fv-setup-assistant-dialog .fv-setup-assistant-shell button:disabled,
+#fv-setup-assistant-dialog .fv-setup-assistant-shell .btn:disabled {
+    color: rgba(231, 238, 249, 0.68);
+}
+
 .fv-setup-assistant-shell input:not([type="checkbox"]):not([type="radio"]),
 .fv-setup-assistant-shell select,
 .fv-setup-assistant-shell textarea {

tests/theme-compatibility.test.mjs

@@ -15,6 +15,8 @@ const settingsCssPath = path.join(
 
 const settingsPage = fs.readFileSync(settingsPagePath, 'utf8');
 const settingsCss = fs.readFileSync(settingsCssPath, 'utf8');
+const wizardDialogBlocks = Array.from(settingsCss.matchAll(/#fv-setup-assistant-dialog\s*\{[\s\S]*?\n\}/g)).map((match) => match[0]);
+const wizardTokenBlock = wizardDialogBlocks.find((block) => /--fv-wizard-text-primary/.test(block)) || '';
 
 test('settings page wraps plugin UI in a theme-safe root container', () => {
     assert.match(settingsPage, /<div id="fv-settings-root" class="fv-theme-safe">/);
@@ -32,3 +34,17 @@ test('theme compatibility: global focus and body selectors are scoped to plugin
     assert.doesNotMatch(settingsCss, /\nbody\s*\{/);
     assert.doesNotMatch(settingsCss, /\nbutton:focus-visible,\s*\ninput:focus-visible,/);
 });
+
+test('theme compatibility: setup wizard enforces theme-safe dark contrast tokens', () => {
+    assert.ok(wizardTokenBlock, 'Wizard token block should exist in settings CSS.');
+    assert.match(wizardTokenBlock, /color-scheme:\s*dark/);
+    assert.match(wizardTokenBlock, /--fv-wizard-text-primary:\s*#e7eef9/);
+    assert.match(wizardTokenBlock, /--fv-wizard-text-muted:\s*#c5d4e8/);
+    assert.match(wizardTokenBlock, /--fv-wizard-text-dim:\s*#a7bad1/);
+    assert.doesNotMatch(wizardTokenBlock, /--fv-wizard-text-primary:\s*var\(--fvplus-settings-text-primary\)/);
+    assert.doesNotMatch(wizardTokenBlock, /--fv-wizard-text-primary:\s*var\(--text/);
+    assert.match(
+        settingsCss,
+        /#fv-setup-assistant-dialog\s+\.fv-setup-assistant-shell button,\s*\n#fv-setup-assistant-dialog\s+\.fv-setup-assistant-shell \.btn\s*\{[\s\S]*color:\s*var\(--fv-wizard-text-primary\)/
+    );
+});