Harden theme fallback resolver and compatibility modes

Author: alexphillips-dev

archive/folderview.plus-2026.03.19.21.txz.sha256

@@ -0,0 +1 @@
+d042b6ba8db495e182c6a96f566cbbb36a36fd5b02c8fb1d778485365930f76d  folderview.plus-2026.03.21.04.txz

archive/folderview.plus-2026.03.19.21.txz archive/folderview.plus-2026.03.21.04.txzarchive/folderview.plus-2026.03.19.21.txz renamed to archive/folderview.plus-2026.03.21.04.txz

@@ -6,13 +6,19 @@
 <!ENTITY launch "Settings/FolderViewPlus">
 <!ENTITY plugdir "/usr/local/emhttp/plugins/&name;">
 <!ENTITY pluginURL "https://raw.githubusercontent.com/&github;/dev/folderview.plus.plg">
-<!ENTITY version "2026.03.21.03">
-<!ENTITY md5 "de86426fa42edffd34a1458f37c6e109">
+<!ENTITY version "2026.03.21.04">
+<!ENTITY md5 "b6733917dbe8956fe54e1e88c8a785c7">
 ]>
 
 <PLUGIN name="&name;" author="&author;" version="&version;" launch="&launch;" pluginURL="&pluginURL;" icon="folder-icon.png" support="https://forums.unraid.net/topic/197631-plugin-folderview-plus/" min="7.0.0">
     <CHANGES>
 
+###2026.03.21.04
+- UX: Refined settings and on-screen update messaging for clarity and consistency.
+- Fix: Improved backend release-note parsing and category detection for accurate summaries.
+- Quality: Strengthened release automation and regression guards to prevent note drift.
+
+
 ###2026.03.21.03
 - Maintenance: Release rollup since main `2026.03.19.29`; merged all `dev` improvements through `2026.03.21.01` into `main`.
 - Feature: Expanded Docker folder quick actions with icon-row `Focus/Pin/Lock` controls plus `Open all WebUIs` and `Clone folder`.

archive/folderview.plus-2026.03.21.04.txz.sha256

@@ -8,6 +8,8 @@ DOCKER_CSS="${PLUGIN_DIR}/styles/docker.css"
 VM_CSS="${PLUGIN_DIR}/styles/vm.css"
 DASHBOARD_CSS="${PLUGIN_DIR}/styles/dashboard.css"
 SETTINGS_CSS="${PLUGIN_DIR}/styles/folderviewplus.css"
+SETTINGS_JS="${PLUGIN_DIR}/scripts/folderviewplus.js"
+SETTINGS_PAGE="${PLUGIN_DIR}/FolderViewPlus.page"
 DOCKER_JS="${PLUGIN_DIR}/scripts/docker.js"
 VM_JS="${PLUGIN_DIR}/scripts/vm.js"
 STYLES_CUSTOM_PHP="${PLUGIN_DIR}/styles/custom.php"
@@ -45,24 +47,36 @@ require_file "${DOCKER_CSS}"
 require_file "${VM_CSS}"
 require_file "${DASHBOARD_CSS}"
 require_file "${SETTINGS_CSS}"
+require_file "${SETTINGS_JS}"
+require_file "${SETTINGS_PAGE}"
 require_file "${DOCKER_JS}"
 require_file "${VM_JS}"
 require_file "${STYLES_CUSTOM_PHP}"
 require_file "${SCRIPTS_CUSTOM_PHP}"
 
-require_contains "${DOCKER_CSS}" '--fvplus-theme-foreground:[[:space:]]*var\(--text,[[:space:]]*currentColor\)' 'docker theme foreground token'
-require_contains "${VM_CSS}" '--fvplus-theme-foreground:[[:space:]]*var\(--text,[[:space:]]*currentColor\)' 'vm theme foreground token'
-require_contains "${DASHBOARD_CSS}" '--fvplus-theme-foreground:[[:space:]]*var\(--text,[[:space:]]*currentColor\)' 'dashboard theme foreground token'
-require_contains "${DOCKER_CSS}" '--fvplus-status-started:[[:space:]]*var\(--fvplus-theme-foreground\)' 'docker started token wiring'
-require_contains "${VM_CSS}" '--fvplus-status-started:[[:space:]]*var\(--fvplus-theme-foreground\)' 'vm started token wiring'
-require_contains "${DASHBOARD_CSS}" '--fvplus-status-started:[[:space:]]*var\(--fvplus-theme-foreground\)' 'dashboard started token wiring'
+require_contains "${DOCKER_CSS}" '--fvplus-theme-foreground:[[:space:]]*var\(--fvplus-runtime-theme-foreground,[[:space:]]*var\(--text,[[:space:]]*currentColor\)\)' 'docker theme foreground token'
+require_contains "${VM_CSS}" '--fvplus-theme-foreground:[[:space:]]*var\(--fvplus-runtime-theme-foreground,[[:space:]]*var\(--text,[[:space:]]*currentColor\)\)' 'vm theme foreground token'
+require_contains "${DASHBOARD_CSS}" '--fvplus-theme-foreground:[[:space:]]*var\(--fvplus-runtime-theme-foreground,[[:space:]]*var\(--text,[[:space:]]*currentColor\)\)' 'dashboard theme foreground token'
+require_contains "${DOCKER_CSS}" '--fvplus-status-started:[[:space:]]*var\(--fvplus-runtime-status-started,[[:space:]]*var\(--fvplus-theme-foreground\)\)' 'docker started token wiring'
+require_contains "${VM_CSS}" '--fvplus-status-started:[[:space:]]*var\(--fvplus-runtime-status-started,[[:space:]]*var\(--fvplus-theme-foreground\)\)' 'vm started token wiring'
+require_contains "${DASHBOARD_CSS}" '--fvplus-status-started:[[:space:]]*var\(--fvplus-runtime-status-started,[[:space:]]*var\(--fvplus-theme-foreground\)\)' 'dashboard started token wiring'
 
 require_contains "${DOCKER_CSS}" '\.folder-state\.fv-folder-state-started' 'docker started state class token selector'
 require_contains "${DOCKER_CSS}" 'i\.folder-load-status\.started' 'docker started icon selector'
 require_contains "${VM_CSS}" '\.folder-state\.fv-folder-state-started' 'vm started state class token selector'
 require_contains "${VM_CSS}" 'i\.folder-load-status\.started' 'vm started icon selector'
+require_contains "${SETTINGS_CSS}" '--fvplus-theme-text-primary:[[:space:]]*var\(--text,[[:space:]]*currentColor\)' 'settings semantic primary token'
+require_contains "${SETTINGS_CSS}" '--fvplus-settings-text-primary:[[:space:]]*var\(--fvplus-theme-text-primary,[[:space:]]*var\(--fvplus-settings-safe-text-primary\)\)' 'settings token resolver chain'
 require_contains "${SETTINGS_CSS}" '--fvplus-settings-surface-muted:' 'settings tokenized surfaces'
 require_contains "${SETTINGS_CSS}" '--fvplus-settings-accent:' 'settings tokenized accent'
+require_contains "${SETTINGS_CSS}" '#fv-setup-assistant-dialog[[:space:]]*\{' 'wizard dialog token block exists'
+require_contains "${SETTINGS_CSS}" 'color-scheme:[[:space:]]*dark' 'wizard dark color scheme'
+require_absent "${SETTINGS_CSS}" '--fv-wizard-text-primary:[[:space:]]*var\(--text' 'wizard text token must not follow host text token directly'
+require_absent "${SETTINGS_CSS}" '--fv-wizard-text-primary:[[:space:]]*var\(--fvplus-settings-text-primary\)' 'wizard text token must not follow settings token directly'
+require_contains "${SETTINGS_JS}" 'const buildResolvedThemeSnapshot = \(modeInput = null\) =>' 'theme resolver snapshot helper'
+require_contains "${SETTINGS_JS}" 'const applyResolvedThemeTokens = \(reason = '\''runtime'\''\) =>' 'theme resolver apply helper'
+require_contains "${SETTINGS_JS}" 'const runThemeSelfHeal = async \(\) =>' 'theme self-heal action'
+require_contains "${SETTINGS_PAGE}" 'runThemeSelfHeal\(\)' 'theme self-heal button wiring'
 
 require_absent "${DOCKER_JS}" '\.css\(\s*["'"'"']color["'"'"']\s*,\s*statusColors' 'docker inline status color painting'
 require_absent "${VM_JS}" '\.css\(\s*["'"'"']color["'"'"']\s*,\s*statusColors' 'vm inline status color painting'

folderview.plus.plg

@@ -157,6 +157,15 @@ if (!empty($fvplusRuntimeConflicts)) {
                         <span>Lazy threshold</span>
                         <input id="docker-lazy-preview-threshold" type="number" min="10" max="200" step="1" onchange="changeRuntimePref('docker', 'lazyPreviewThreshold', this.value)">
                     </label>
+                    <label class="setting-select" for="docker-theme-compat-mode">
+                        <span>Theme fallback mode</span>
+                        <select id="docker-theme-compat-mode" onchange="changeRuntimePref('docker', 'themeCompatibilityMode', this.value)">
+                            <option value="auto">Auto (recommended)</option>
+                            <option value="host">Force host theme</option>
+                            <option value="safe">Force safe palette</option>
+                            <option value="highcontrast">High contrast safe</option>
+                        </select>
+                    </label>
                     <div class="setting-help">Use performance mode + lazy previews for larger libraries to reduce render overhead.</div>
                 </div>
                 <div class="settings-mini-card">
@@ -353,6 +362,15 @@ if (!empty($fvplusRuntimeConflicts)) {
                         <span>Lazy threshold</span>
                         <input id="vm-lazy-preview-threshold" type="number" min="10" max="200" step="1" onchange="changeRuntimePref('vm', 'lazyPreviewThreshold', this.value)">
                     </label>
+                    <label class="setting-select" for="vm-theme-compat-mode">
+                        <span>Theme fallback mode</span>
+                        <select id="vm-theme-compat-mode" onchange="changeRuntimePref('vm', 'themeCompatibilityMode', this.value)">
+                            <option value="auto">Auto (recommended)</option>
+                            <option value="host">Force host theme</option>
+                            <option value="safe">Force safe palette</option>
+                            <option value="highcontrast">High contrast safe</option>
+                        </select>
+                    </label>
                     <div class="setting-help">Use performance mode + lazy previews for larger libraries to reduce render overhead.</div>
                 </div>
                 <div class="settings-mini-card">
@@ -874,6 +892,7 @@ if (!empty($fvplusRuntimeConflicts)) {
     <div class="backup-actions">
         <button type="button" onclick="runDiagnostics()"><i class="fa fa-stethoscope"></i> Run health check</button>
         <button type="button" onclick="runThemeDiagnostics()"><i class="fa fa-paint-brush"></i> Theme diagnostics</button>
+        <button type="button" onclick="runThemeSelfHeal()"><i class="fa fa-magic"></i> Theme self-heal now</button>
         <button type="button" onclick="repairDiagnostics('sync_docker_order')"><i class="fa fa-sort"></i> Rebuild Docker order index</button>
         <button type="button" onclick="repairDiagnostics('normalize_prefs')"><i class="fa fa-wrench"></i> Validate and normalize prefs</button>
         <button type="button" onclick="repairDiagnostics('repair_paths')"><i class="fa fa-folder-open"></i> Repair plugin paths</button>