Keep dashboard quick rail visible during view transitions

Author: alexphillips-dev

archive/folderview.plus-2026.03.22.35.txz.sha256

@@ -0,0 +1 @@
+d54e17f1431e5c6effc6109707d783944be4904b2a933cce561ab48379f33955  folderview.plus-2026.03.23.07.txz

archive/folderview.plus-2026.03.22.35.txz archive/folderview.plus-2026.03.23.07.txzarchive/folderview.plus-2026.03.22.35.txz renamed to archive/folderview.plus-2026.03.23.07.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.23.06">
-<!ENTITY md5 "c717f290c3bd116b976961b6ba528534">
+<!ENTITY version "2026.03.23.07">
+<!ENTITY md5 "a0c6c28a46bd8527409895ecbe64e59d">
 ]>
 
 <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.23.07
+- Fix: Kept the Dashboard widget action rail visible during `Legacy` view transitions by tracking per-widget layout rebuild state instead of hiding the rail while cards are temporarily absent.
+- Quality: Hardened the Dashboard quick-rail visibility logic so it treats local widget rebuilds as an active state rather than a collapsed/empty widget.
+- Test: Added regression coverage for transition-in-flight handling in the Dashboard layout runtime.
+
+
 ###2026.03.23.06
 - Fix: Reworked Dashboard widget `Legacy` transitions to restore native rows locally instead of forcing a full `loadlist()` refresh, removing the extra delay when cycling in and out of bypass mode.
 - Fix: Prevented one widget entering `Legacy` from short-circuiting the other widget's folder render path by scoping dashboard rebuilds to the affected type.

archive/folderview.plus-2026.03.23.07.txz.sha256

@@ -282,6 +282,10 @@ const writeDashboardCompactDensityStateForType = (type, enabled) => {
 };
 const getDashboardStartedOnlySelectorForType = (type) => (type === 'vm' ? 'input#vms' : 'input#apps');
 const isDashboardLegacyLayoutForType = (type) => normalizeDashboardPrefsForType(type).layout === 'legacy';
+const isDashboardLayoutTransitionInFlightForType = (type) => {
+    const resolvedType = type === 'vm' ? 'vm' : 'docker';
+    return dashboardLayoutTransitionInFlightByType?.[resolvedType] === true;
+};
 const getDashboardNativeRowSelectorForType = (type) => (
     type === 'vm'
         ? 'span.outer.vms:not(.folder-vm)'
@@ -561,7 +565,11 @@ const syncDashboardWidgetQuickRailVisibilityForType = (type) => {
     const shouldShow = !!parentNode
         && isDashboardNodeVisible(parentNode)
         && isDashboardWidgetCollapsedForType(resolvedType) !== true
-        && (hasVisibleDashboardFolderCardsForType(resolvedType) || isDashboardLegacyLayoutForType(resolvedType));
+        && (
+            hasVisibleDashboardFolderCardsForType(resolvedType)
+            || isDashboardLegacyLayoutForType(resolvedType)
+            || isDashboardLayoutTransitionInFlightForType(resolvedType)
+        );
     $host.toggleClass('is-hidden', !shouldShow);
     if (shouldShow) {
         syncDashboardWidgetQuickRailAlignmentForType(resolvedType);
@@ -717,16 +725,23 @@ const saveDashboardLayoutPrefForType = async (type, prefsPayload) => {
 };
 const rerenderDashboardWidgetStructureForType = async (type) => {
     const resolvedType = type === 'vm' ? 'vm' : 'docker';
-    await restoreDashboardNativeRowsForType(resolvedType);
-    if (isDashboardLegacyLayoutForType(resolvedType)) {
-        scheduleDashboardLayoutApplyForType(resolvedType);
-        syncDashboardWidgetLayoutQuickControlForType(resolvedType);
+    dashboardLayoutTransitionInFlightByType[resolvedType] = true;
+    scheduleDashboardWidgetVisibilitySyncForType(resolvedType, 0);
+    try {
+        await restoreDashboardNativeRowsForType(resolvedType);
+        if (isDashboardLegacyLayoutForType(resolvedType)) {
+            scheduleDashboardLayoutApplyForType(resolvedType);
+            syncDashboardWidgetLayoutQuickControlForType(resolvedType);
+            scheduleDashboardWidgetVisibilitySyncForType(resolvedType, 0);
+            return;
+        }
+        prepareDashboardFolderRequestsForType(resolvedType);
+        await createFolders([resolvedType]);
+        scheduleDashboardWidgetVisibilitySyncForType(resolvedType, 0);
+    } finally {
+        dashboardLayoutTransitionInFlightByType[resolvedType] = false;
         scheduleDashboardWidgetVisibilitySyncForType(resolvedType, 0);
-        return;
     }
-    prepareDashboardFolderRequestsForType(resolvedType);
-    await createFolders([resolvedType]);
-    scheduleDashboardWidgetVisibilitySyncForType(resolvedType, 0);
 };
 const handleDashboardWidgetLayoutQuickSwitch = async (type, value) => {
     const resolvedType = type === 'vm' ? 'vm' : 'docker';
@@ -3315,6 +3330,10 @@ let dashboardWidgetVisibilitySyncTimerByType = {
     docker: 0,
     vm: 0
 };
+let dashboardLayoutTransitionInFlightByType = {
+    docker: false,
+    vm: false
+};
 let dashboardQuickActionSyncBound = false;
 let dashboardThemeReflowBound = false;
 let dashboardThemeReflowObserver = null;

folderview.plus.plg

@@ -84,6 +84,7 @@ test('server normalizes compact matrix dashboard layout', () => {
 test('dashboard runtime supports layout classes, accordion guards, and overflow metadata', () => {
     assert.match(dashboardScript, /const DASHBOARD_LAYOUT_MODES = \['classic', 'legacy', 'fullwidth', 'accordion', 'inset', 'compactmatrix'\]/);
     assert.match(dashboardScript, /const isDashboardLegacyLayoutForType = \(type\) =>/);
+    assert.match(dashboardScript, /const isDashboardLayoutTransitionInFlightForType = \(type\) =>/);
     assert.match(dashboardScript, /const restoreDashboardNativeRowsForType = async \(type\) =>/);
     assert.match(dashboardScript, /const rerenderDashboardWidgetStructureForType = async \(type\) =>/);
     assert.match(dashboardScript, /const prepareDashboardFolderRequestsForType = \(type\) =>/);
@@ -123,9 +124,12 @@ test('dashboard runtime supports layout classes, accordion guards, and overflow
     assert.match(dashboardScript, /const applyDashboardLayoutStateForType = \(type\) =>/);
     assert.match(dashboardScript, /const scheduleDashboardLayoutApplyForType = \(type\) =>/);
     assert.match(dashboardScript, /const requiresStructureReload = previousDashboard\.layout === 'legacy' \|\| nextLayout === 'legacy';/);
+    assert.match(dashboardScript, /dashboardLayoutTransitionInFlightByType\[resolvedType\] = true;/);
+    assert.match(dashboardScript, /dashboardLayoutTransitionInFlightByType\[resolvedType\] = false;/);
     assert.match(dashboardScript, /await rerenderDashboardWidgetStructureForType\(resolvedType\);/);
     assert.match(dashboardScript, /if \(isDashboardLegacyLayoutForType\('docker'\)\) \{/);
     assert.match(dashboardScript, /if \(isDashboardLegacyLayoutForType\('vm'\)\) \{/);
+    assert.match(dashboardScript, /\|\| isDashboardLayoutTransitionInFlightForType\(resolvedType\)/);
     assert.match(dashboardScript, /\|\| isDashboardLegacyLayoutForType\(resolvedType\)/);
     assert.match(dashboardScript, /\$host\.parent\(\)\.is\(\$container\)/);
     assert.match(dashboardScript, /\$container\.prepend\(\$host\)/);