@bvdm/delano 0.2.3 → 0.2.5

package/.delano/viewer/README.md

@@ -3,8 +3,9 @@
 Minimal local frontend for browsing `.project` markdown contracts.
 
 - Read-only: serves files from `.project` and does not write delivery state.
-- Default URL: `http://127.0.0.1:3977`
-- Override port: `DELANO_VIEWER_PORT=3987 npm run viewer`
+- Default starting URL: `http://127.0.0.1:3977`
+- Override starting port: `DELANO_VIEWER_PORT=3987 npm run viewer`
+- Multiple viewers can run at once. If the starting port is already in use, the viewer tries the next available port and prints the actual URL.
 
 Run from the repository root:
 

package/.delano/viewer/public/app.js

@@ -771,7 +771,19 @@ function render() {
   });
   document.querySelectorAll('[data-doc]').forEach((el) => el.onclick = () => loadDoc(el.dataset.doc));
   document.querySelectorAll('[data-status]').forEach((el) => el.onclick = () => { state.status = el.dataset.status; render(); });
-  document.querySelectorAll('[data-role]').forEach((el) => el.onclick = () => { state.role = el.dataset.role; state.workstream = null; render(); });
+  document.querySelectorAll('[data-role]').forEach((el) => el.onclick = () => {
+    state.role = el.dataset.role;
+    state.workstream = null;
+    if (state.role !== 'all') {
+      const firstInRole = currentDocs().find((doc) => doc.role === state.role);
+      if (firstInRole) {
+        if (state.role === 'workstream') state.workstream = firstInRole.path;
+        loadDoc(firstInRole.path);
+        return;
+      }
+    }
+    render();
+  });
   document.querySelectorAll('[data-workstream]').forEach((el) => el.onclick = () => { state.workstream = el.dataset.workstream; state.role = 'all'; loadDoc(el.dataset.doc); });
   document.querySelectorAll('[data-clear-workstream]').forEach((el) => el.onclick = () => { state.workstream = null; render(); });
   document.querySelectorAll('[data-outline-toggle]').forEach((el) => el.onclick = () => { state.outlineOpen = !state.outlineOpen; render(); });