Improve setup wizard navigation presets and review flow

Author: alexphillips-dev

CHANGELOG-fixes.md

@@ -1,5 +1,13 @@
 # FolderView Plus Changelog
 
+## Version 2026.03.08.12
+
+- Improve Setup Assistant with in-wizard quick start bundles (Balanced, Minimal, Power, Media Stack).
+- Add clickable wizard sidebar step navigation and a one-click Review jump action.
+- Add Copy Summary action in wizard review to export the full plan snapshot to clipboard.
+- Add setup keyboard shortcuts: Alt+Left/Right for step movement, Ctrl+Enter to apply from review, Ctrl+Shift+C to copy summary.
+- Add UI regression checks for new wizard controls and styles.
+
 ## Version 2026.03.06.8
 
 - Add full rules simulator for Docker/VM to preview assignment outcomes across all items.

archive/folderview.plus-2026.03.08.12.txz

@@ -0,0 +1 @@
+043db09524842d3dc7693c2ac817a43a09127deb860e62d10ce91fe418781f4c  folderview.plus-2026.03.08.12.txz

archive/folderview.plus-2026.03.08.12.txz.sha256

@@ -6,13 +6,21 @@
 <!ENTITY launch "Settings/FolderViewPlus">
 <!ENTITY plugdir "/usr/local/emhttp/plugins/&name;">
 <!ENTITY pluginURL "https://raw.githubusercontent.com/&github;/main/folderview.plus.plg">
-<!ENTITY version "2026.03.08.11">
-<!ENTITY md5 "6d5298fbc83f5664ebaf629d164f3530">
+<!ENTITY version "2026.03.08.12">
+<!ENTITY md5 "f68aa27b853abcd8dbf1736e54fdd953">
 ]>
 
 <PLUGIN name="&name;" author="&author;" version="&version;" launch="&launch;" pluginURL="&pluginURL;" icon="folder-icon.png" support="https://github.com/alexphillips-dev/FolderView-Plus/issues" min="7.0.0">
     <CHANGES>
 
+###2026.03.08.12
+- Wizard UX: added quick start bundles directly in the Welcome step (Balanced, Minimal, Power, Media Stack) with state-aware preset tracking.
+- Wizard navigation: sidebar steps are now clickable for faster navigation, plus a one-click `Review` footer action to jump to the final step.
+- Wizard review polish: added `Copy summary` action to export a full plan snapshot (route, mode, imports, rules, warnings) to clipboard for support/debug sharing.
+- Wizard accessibility: added keyboard shortcuts (`Alt+Left/Right` step navigation, `Ctrl+Enter` apply on review, `Ctrl+Shift+C` copy summary).
+- Regression guard: expanded UI smoke assertions for new wizard controls and styling hooks.
+
+
 ###2026.03.08.11
 - UI fix: force-compact sizing for advanced module action buttons so `Add rule`, `Test rule priority`, and `Simulate all items` no longer render oversized.
 - Styling hardening: added high-priority button sizing overrides to prevent theme/CSS inheritance from stretching action controls.

folderview.plus.plg

@@ -1611,6 +1611,7 @@ h2[data-fv-advanced="1"] + .template-grid .rules-panel {
     .fv-setup-route-grid,
     .fv-setup-profile-grid,
     .fv-setup-env-grid,
+    .fv-setup-quick-preset-grid,
     .fv-setup-impact-grid,
     .fv-setup-field-grid {
         grid-template-columns: 1fr;
@@ -2020,15 +2021,30 @@ h2[data-fv-advanced="1"] + .template-grid .rules-panel {
 }
 
 .fv-setup-step-list li {
+    padding: 0;
+    border-radius: 8px;
+    border: 1px solid rgba(255, 255, 255, 0.08);
+    font-size: 1.03rem;
+    opacity: 0.84;
+}
+
+.fv-setup-step-jump {
+    width: 100%;
+    min-width: 0;
+    border: 0;
+    border-radius: 8px;
+    background: transparent;
+    color: inherit;
     display: grid;
     grid-template-columns: 24px minmax(0, 1fr);
     align-items: center;
     gap: 0.45rem;
     padding: 0.24rem 0.3rem;
-    border-radius: 8px;
-    border: 1px solid rgba(255, 255, 255, 0.08);
-    font-size: 1.03rem;
-    opacity: 0.84;
+    text-align: left;
+}
+
+.fv-setup-step-jump:disabled {
+    opacity: 0.9;
 }
 
 .fv-setup-step-list li.is-active {
@@ -2152,6 +2168,42 @@ h2[data-fv-advanced="1"] + .template-grid .rules-panel {
     gap: 0.45rem;
 }
 
+.fv-setup-quick-preset-grid {
+    display: grid;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+    gap: 0.45rem;
+}
+
+.fv-setup-quick-preset {
+    min-width: 0;
+    width: 100%;
+    border: 1px solid rgba(255, 255, 255, 0.12);
+    border-radius: 8px;
+    background: rgba(255, 255, 255, 0.03);
+    color: inherit;
+    display: grid;
+    gap: 0.18rem;
+    text-align: left;
+    padding: 0.42rem 0.5rem;
+}
+
+.fv-setup-quick-preset.is-active {
+    border-color: rgba(77, 163, 255, 0.6);
+    background: rgba(77, 163, 255, 0.16);
+    color: #d8ebff;
+}
+
+.fv-setup-quick-preset-title {
+    font-size: 1.03rem;
+    font-weight: 700;
+}
+
+.fv-setup-quick-preset-help {
+    font-size: 1.03rem;
+    opacity: 0.82;
+    line-height: 1.3;
+}
+
 .fv-setup-route-option,
 .fv-setup-profile-option {
     border: 1px solid rgba(255, 255, 255, 0.12);
@@ -2274,6 +2326,19 @@ h2[data-fv-advanced="1"] + .template-grid .rules-panel {
     font-size: 1.03rem;
 }
 
+.fv-setup-assistant-body kbd {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    min-width: 1.5em;
+    padding: 0.05rem 0.3rem;
+    border: 1px solid rgba(255, 255, 255, 0.24);
+    border-radius: 6px;
+    background: rgba(255, 255, 255, 0.08);
+    font-size: 1.03rem;
+    line-height: 1.2;
+}
+
 .fv-setup-rule-list {
     max-height: 270px;
     overflow: auto;

src/folderview.plus/usr/local/emhttp/plugins/folderview.plus/scripts/folderviewplus.js

@@ -108,12 +108,18 @@ test('settings runtime uses extracted chrome module and shared request wrapper',
     assert.match(settingsJs, /const getSetupAssistantStepValidation = \(stepKey = currentSetupAssistantStepKey\(\)\) =>/);
     assert.match(settingsJs, /const previewSetupAssistantRuleMatches = \(type, pattern\) =>/);
     assert.match(settingsJs, /const handleSetupAssistantDialogKeydown = \(event\) =>/);
+    assert.match(settingsJs, /const jumpSetupAssistantToStep = \(targetIndex\) =>/);
+    assert.match(settingsJs, /const buildSetupAssistantClipboardSummary = \(\) =>/);
+    assert.match(settingsJs, /const copySetupAssistantSummaryToClipboard = async \(\) =>/);
     assert.match(settingsJs, /runQuickSetupWizard = \(force = false\) => \{/);
     assert.match(settingsJs, /openSetupAssistant\(force === true\);/);
     assert.match(settingsJs, /const bindSetupAssistantEvents = \(\) =>/);
     assert.match(settingsJs, /markSetupAssistantCompletedLocal\(\);/);
     assert.match(settingsJs, /id="fv-setup-dry-run"/);
+    assert.match(settingsJs, /id="fv-setup-copy-summary"/);
     assert.match(settingsJs, /id="fv-setup-discard-draft"/);
+    assert.match(settingsJs, /id="fv-setup-skip-review"/);
+    assert.match(settingsJs, /data-fv-setup-quick-preset=/);
     assert.match(settingsJs, /Dry run only \(preview changes, do not modify folders or settings\)/);
     assert.match(settingsJs, /const shouldRunWizard = !isWizardCompletedServerSide\(\) && !isSetupAssistantCompletedLocal\(\);/);
     assert.match(settingsJs, /const apiPostJson = async \(url, data = \{\}, options = \{\}\) =>/);
@@ -163,6 +169,9 @@ test('settings runtime uses extracted chrome module and shared request wrapper',
     assert.match(settingsCss, /\.fv-setup-validation-box\s*\{/);
     assert.match(settingsCss, /\.fv-setup-impact-grid\s*\{/);
     assert.match(settingsCss, /\.fv-setup-env-grid\s*\{/);
+    assert.match(settingsCss, /\.fv-setup-step-jump\s*\{/);
+    assert.match(settingsCss, /\.fv-setup-quick-preset-grid\s*\{/);
+    assert.match(settingsCss, /\.fv-setup-quick-preset\.is-active\s*\{/);
     assert.match(settingsCss, /\.fv-setup-rule-preview\.is-match\s*\{/);
     assert.match(settingsCss, /--fv-advanced-module-height:\s*clamp\(/);
     assert.match(settingsCss, /h2\[data-fv-advanced="1"\] \+ \.backup-grid \.rules-panel[\s\S]*overflow-y:\s*auto/);