Modularize docker runtime core with shared store, guarded actions, and architecture tests

Author: alexphillips-dev

archive/folderview.plus-2026.03.19.17.txz.sha256

@@ -0,0 +1 @@
+a143edc48b229ec18e194434a53e346baf46bd56cac1d92fc85bde1ca6fff5b4  folderview.plus-2026.03.20.13.txz

archive/folderview.plus-2026.03.19.17.txz archive/folderview.plus-2026.03.20.13.txzarchive/folderview.plus-2026.03.19.17.txz renamed to archive/folderview.plus-2026.03.20.13.txz

@@ -0,0 +1,37 @@
+# Docker Runtime Architecture
+
+This document tracks the staged modularization of `docker.js` while preserving Unraid selector/API compatibility.
+
+## Runtime Modules
+
+- `scripts/docker.runtime.shared.js`
+  - `createRuntimeStateStore`: single source of truth for runtime UI state.
+  - `createAsyncActionBoundary`: normalized async error handling and user-safe messaging.
+  - `createContextMenuQuickStripAdapter`: resilient context-menu enhancement for icon-only quick actions.
+  - `createRuntimePerfTelemetry`: structured action timing with snapshot support.
+- `scripts/docker.modules.js`
+  - view helpers (debug logger, perf tracker, row-centering tools).
+
+## Runtime Ownership
+
+- `docker.js` keeps orchestration and Unraid integration behavior.
+- Shared modules own reusable primitives so feature logic is testable without large-file rewrites.
+- Store-backed state currently includes:
+  - `focusedFolderId`
+  - `lockedFolderIds`
+  - `pinnedFolderIds`
+
+## Guardrails
+
+- New shared module is loaded in `folderview.plus.Docker.page` before `docker.modules.js` and `docker.js`.
+- Context menu quick actions (Focus/Pin/Lock) are enhanced through the adapter rather than ad-hoc DOM logic.
+- CSS layout constants use tokenized variables with hard-coded fallback values to preserve legacy contracts.
+
+## Regression Prevention
+
+- Architecture contract tests:
+  - `tests/docker-runtime-shared-architecture.test.mjs`
+  - `tests/docker-folder-row-quick-actions.test.mjs`
+  - `tests/docker-mobile-name-alignment-guard.test.mjs`
+- Perf telemetry snapshot is exposed as:
+  - `window.getDockerRuntimePerfTelemetrySnapshot()`

archive/folderview.plus-2026.03.20.13.txz.sha256

@@ -6,13 +6,20 @@
 <!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.20.12">
-<!ENTITY md5 "53ab38d43d84b573e23ca2fa27198c3f">
+<!ENTITY version "2026.03.20.13">
+<!ENTITY md5 "dbd3de15d71be54a1a8141a2486c8cf4">
 ]>
 
 <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.20.13
+- Refactor: Added `docker.runtime.shared.js` for Docker runtime state store, async action boundaries, context-menu adapter, and perf telemetry primitives.
+- Regression guard: Added architecture and visual-contract tests for Docker quick actions, shared module wiring, and layout token fallback behavior.
+- UX: Improved Docker runtime i18n-safe quick action labels and accessibility labels for icon-only context actions.
+- Compatibility: Added centralized Docker layout tokens with hard-coded fallbacks to preserve existing selector/spacing contracts.
+
+
 ###2026.03.20.12
 - UX: Changed Docker folder click menu so `Focus`, `Pin`, and `Lock` render as icon-only quick actions on one top row.
 - Regression guard: Added runtime/test coverage for context quick-action strip detection and styling.

docs/docker-runtime-architecture.md

@@ -35,6 +35,7 @@ if (!empty($fvplusRuntimeConflicts)) {
 <script src="<?php autov('/plugins/folderview.plus/scripts/folderviewplus.utils.js')?>"></script>
 <script src="<?php autov('/plugins/folderview.plus/scripts/folderviewplus.request.js')?>"></script>
 <script src="<?php autov('/plugins/folderview.plus/scripts/runtime.column-layout.js')?>"></script>
+<script src="<?php autov('/plugins/folderview.plus/scripts/docker.runtime.shared.js')?>"></script>
 <script src="<?php autov('/plugins/folderview.plus/scripts/docker.modules.js')?>"></script>
 <script defer src="<?php autov('/plugins/folderview.plus/scripts/docker.js')?>"></script>