v0.33.3

docs/DASHBOARD_PRESET.md

@@ -1,4 +1,4 @@
-# Factory Overview dashboard preset (0.33.1)
+# Factory Overview dashboard preset (0.33.3)
 
 `src/admin/web/dashboard-defaults.json` is the single factory configuration
 for the Rust admin preference API and the authenticated JavaScript panel.
@@ -19,10 +19,37 @@ The bundled 0.33.1 preset reproduces the supplied operator layout: 78 ordered
 cards, 51 hidden, compact density and 600 initial samples. The packaged
 Web Server cards remain hidden by default.
 
+## User-selected card widths (0.33.3)
+
+The factory preset intentionally retains the original 0.33.1 widths and
+legacy grouped presentation. Version 0.33.3 adds a separate nullable preference:
+
+- `dashboard_widget_sizes: null` (including omitted in an old record): retain
+  previous size groups, so upgrades do not spontaneously rearrange cards.
+- `dashboard_widget_sizes: {}`: freely order all card types, while leaving
+  their widths at the original values.
+- `dashboard_widget_sizes: { "http_protocol": 4, "wide_transform_activity": 3 }`:
+  also override individual widths, in units of the 12-column Overview grid.
+
+Permitted widths: 2, 3, 4, 6 and 12 columns; regular charts need at least 3,
+full diagnostic panels at least 4, and the backend table at least 6. At the
+largest canvas four 3-column charts fit alongside each other. On small screens
+the renderer reduces to a six- or two-column grid; the saved dimensions do not
+change. In **Unlock layout**, click − / + or drag cards across their old groups;
+**Arrange cards visually** provides the same controls. Save persists order,
+visibility and sizes in the administrator's current preference document.
+
+**Cancel** restores the saved layout and sizes. **Restore defaults** restores
+the original factory order/visibility and width defaults, but does not change
+the independently saved Overview sample limit. Dense packing reduces gaps,
+so when columns do not divide evenly, a later narrow tile may fill an earlier
+free space without changing the saved DOM or keyboard traversal order.
+
 ## Deploying an edited preset
 
 1. Edit `src/admin/web/dashboard-defaults.json` in the source tree.
-2. Validate the JSON and identifiers
+2. Validate the JSON and identifiers (e.g. run
+   `python3 scripts/tests/dashboard_layout_0331_browser_test.py`).
 3. Rebuild RustProxy (`./dev.sh check` / the normal release build) and deploy
    the newly built binary. The preset is **embedded**; editing the installed
    source JSON alone does not update a running binary.