@bongos/core 1.21.27 → 1.21.29

package/modules/hall-ui/public/settings.html

@@ -435,7 +435,9 @@
 
 <!-- The app shell (sidebar + top bar). Dependency-free; loaded FIRST so the
      chrome exists before the page scripts run. -->
-<script src="/builders/shell.js?v=2026-10-02-trail"></script>
+<script src="/builders/shell-trail.js?v=2026-10-02-craft"></script>
+<script src="/builders/craft-mode.js?v=2026-10-02-craft"></script>
+<script src="/builders/shell.js?v=2026-10-02-craft"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- shared frontend toolkit (window.OTB) — loaded before consuming IIFEs. -->

package/modules/hall-ui/public/shell-trail.js

@@ -0,0 +1,186 @@
+// shell-trail.js — the hall top bar's way back: the Back link, the breadcrumb
+// trail, and the [data-shell-exit] links (tasks 1004430, 1004476, 1004477).
+// Carved out of shell.js in task 1004492 (shell.js sat on the 1,500-line
+// ratchet); the behaviour and its rules are unchanged, and tests/hall_fullscreen.mjs
+// still drives it through the real shell. Loaded BEFORE shell.js on every hall
+// page; shell.js calls make() once with its own esc() and nav model, and a page
+// without this file simply shows no Back link.
+(function () {
+  'use strict';
+  function make(ctx) {
+    var esc = ctx.esc;
+    var NAV = ctx.nav;
+    // ---------- the Back link (task 1004430) ----------
+    // A page reached from INSIDE another hall page (`?from=`, else a same-origin
+    // referrer) shows "← <that page>" in the top bar. A sidebar hop is not a
+    // drill-down: its click leaves a one-shot sessionStorage note, and the page it
+    // lands on shows none. task 1004477: the ONLY place a page's way back is
+    // decided. <body data-back-fallback="/work"> names where Back goes with no
+    // origin; a [data-shell-exit] link the page places is filled by the shell.
+    var NAV_HOP_KEY = 'hall-nav-hop';
+    function hallPath(url) {
+      return String(url.pathname).replace(/^\/builders(?=\/|$)/, '').replace(/\.html$/, '').replace(/\/index$/, '') || '/';
+    }
+    // The page this one was opened from: ?from=, then a same-origin referrer.
+    function linkOrigin() {
+      var from = null;
+      var viaReferrer = false;
+      try {
+        var q = new URLSearchParams(location.search || '').get('from');
+        if (q) from = new URL(q, location.origin);
+        else if (document.referrer) { from = new URL(document.referrer); viaReferrer = true; }
+      } catch (_) { return null; }
+      if (!from || from.origin !== location.origin) return null;
+      var path = hallPath(from);
+      if (/^\/(api|auth|lib)(\/|$)/.test(path)) return null;
+      // Keep the origin's query (a filtered list) but never its own ?from=, which
+      // would chain; and compare without OUR ?from=, so a self-link is refused.
+      var params = new URLSearchParams(from.search);
+      params.delete('from');
+      var search = params.toString() ? '?' + params.toString() : '';
+      var ownParams = new URLSearchParams(location.search || '');
+      ownParams.delete('from');
+      var here = hallPath(location) + (ownParams.toString() ? '?' + ownParams.toString() : '');
+      if (path + search === here) return null;
+      return { href: path + search + (from.hash || ''), path: path, label: backLabel(path, from.hash), viaReferrer: viaReferrer };
+    }
+    // <body data-back-fallback>, honoured only as a path on this host (never the API).
+    function fallbackOrigin() {
+      var f = document.body && document.body.dataset && document.body.dataset.backFallback;
+      if (!f || !/^\/(?!\/)/.test(f) || /[\\\s]/.test(f)) return null;
+      var u;
+      try { u = new URL(f, location.origin); } catch (_) { return null; }
+      if (u.origin !== location.origin) return null;
+      var path = hallPath(u);
+      if (/^\/(api|auth|lib)(\/|$)/.test(path) || path === hallPath(location)) return null;
+      return { href: path + (u.search || '') + (u.hash || ''), path: path, label: backLabel(path, u.hash), viaReferrer: false };
+    }
+    // "Back to tasks": a nav label is lowercased mid-sentence unless it has an acronym.
+    function exitWords(label) {
+      return 'Back to ' + (/[A-Z]{2}/.test(label) ? label : label.toLowerCase());
+    }
+    // Fill every [data-shell-exit] under `root` with the way back (else home); a
+    // page that renders one later (task.js's failure states) calls this again.
+    function fillExits(root) {
+      var scope = root || document;
+      if (!scope.querySelectorAll) return;
+      var target = BACK || { href: '/', label: 'Home', viaReferrer: false };
+      var links = scope.querySelectorAll('[data-shell-exit]');
+      for (var i = 0; i < links.length; i++) {
+        links[i].setAttribute('href', target.href);
+        links[i].textContent = exitWords(target.label);
+        if (!links[i].dataset.shellExitWired) {
+          links[i].dataset.shellExitWired = '1';
+          links[i].addEventListener('click', onBackClick);
+        }
+      }
+    }
+    function backLabel(path, hash) {
+      if (path === '/') {
+        var m = /^#\/(task|idea|blocker)\/(\d+)/.exec(hash || '');
+        return m ? m[1] + ' ' + m[2] : (/^#standing/.test(hash || '') ? 'Standing' : 'Home');
+      }
+      var rec = /^\/(task|idea)\/(\d+)$/.exec(path);
+      if (rec) return rec[1] + ' ' + rec[2];
+      if (path === '/goals' && /^#\/goal\/\d+/.test(hash || '')) return 'goal ' + hash.split('/')[2];
+      for (var g = 0; g < NAV.length; g++) {
+        for (var i = 0; i < NAV[g].items.length; i++) {
+          if (NAV[g].items[i].href === path) return NAV[g].items[i].label;
+        }
+      }
+      return 'Back';
+    }
+    // ---------- the trail (task 1004476) ----------
+    // Two clicks deep the bar shows the run of pages that led here, "Goals › goal
+    // 12 › task 340", the last crumb being Back. Kept per tab (sessionStorage) as
+    // crumbs ending with THIS page: a drill-down cuts after its origin and appends;
+    // returning to a crumb (the origin, if any, sits after it) trims; an unknown
+    // origin starts fresh by the ?from= / referrer / fallback rules; a sidebar hop
+    // starts over. Storage that throws, or no URL API, keeps the one-step Back.
+    var TRAIL_KEY = 'hall-nav-trail', TRAIL_MAX = 4, BACK = null;
+    function hereCrumb() {
+      var own = new URLSearchParams(location.search || ''); own.delete('from');
+      var path = hallPath(location), hash = location.hash || '';
+      return { href: path + (own.toString() ? '?' + own.toString() : '') + hash, label: backLabel(path, hash) };
+    }
+    // A stored crumb is honoured only as a path on this host with a string label.
+    function crumbOk(c) {
+      return !!c && typeof c.href === 'string' && typeof c.label === 'string' &&
+        /^\/(?!\/)/.test(c.href) && !/[\\\s]/.test(c.href) && !/^\/(api|auth|lib)(\/|[?#]|$)/.test(c.href);
+    }
+    function readTrail() {
+      try { var t = JSON.parse(window.sessionStorage.getItem(TRAIL_KEY) || '[]'); return Array.isArray(t) ? t.filter(crumbOk) : []; } catch (_) { return null; }
+    }
+    function writeTrail(t) {
+      try { window.sessionStorage.setItem(TRAIL_KEY, JSON.stringify(t.slice(-(TRAIL_MAX + 1)))); } catch (_) { /* private mode */ }
+    }
+    // Latest crumb at `href`; a referrer has no #hash, so it matches on the address alone.
+    function crumbAt(t, href, anyHash) {
+      for (var i = t.length - 1; i >= 0; i--) if (anyHash ? t[i].href.split('#')[0] === href.split('#')[0] : t[i].href === href) return i;
+      return -1;
+    }
+    // The crumbs before this page; the last is where Back goes. Sets BACK.
+    function trailCrumbs() {
+      var hop = null, here = null;
+      try { hop = window.sessionStorage.getItem(NAV_HOP_KEY); window.sessionStorage.removeItem(NAV_HOP_KEY); } catch (_) { /* private mode */ }
+      try { here = hereCrumb(); } catch (_) { /* no URL API */ }
+      var stored = here ? readTrail() : null, t = stored || [], trail = null, via = false;
+      here = here || { href: '', label: '' };
+      if (hop && hop === hallPath(location)) trail = [here];
+      var origin = trail ? null : linkOrigin();
+      var at = crumbAt(t, here.href), from = origin ? crumbAt(t, origin.href, origin.viaReferrer) : -1;
+      var f = trail || origin || at >= 0 ? null : fallbackOrigin();
+      if (!trail && at >= 0 && (!origin || from > at)) trail = t.slice(0, at + 1);
+      else if (!trail && origin) { trail = (from >= 0 ? t.slice(0, from + 1) : [origin]).concat([here]); via = origin.viaReferrer; }
+      else if (!trail) trail = f ? [f, here] : [here];
+      trail = trail.slice(-(TRAIL_MAX + 1)).map(function (c) { return { href: c.href, label: c.label }; });
+      if (stored) writeTrail(trail);
+      var crumbs = trail.slice(0, -1), last = crumbs[crumbs.length - 1];
+      BACK = last ? { href: last.href, label: last.label, viaReferrer: via } : null;
+      return crumbs;
+    }
+    // A hash route moves without a page load: a record view is a drill-down, a
+    // crumb already held is a return, any other view just renames this page's crumb.
+    function onTrailHash() {
+      var t = readTrail(), here;
+      if (!t || !t.length || t[t.length - 1].href.split(/[?#]/)[0] !== hallPath(location)) return;
+      try { here = hereCrumb(); } catch (_) { return; }
+      var at = crumbAt(t, here.href);
+      if (at >= 0) t = t.slice(0, at + 1);
+      else if (/^#\/(task|idea|blocker|goal)\/\d+/.test(location.hash || '')) t = t.concat([here]);
+      else t[t.length - 1] = here;
+      writeTrail(t);
+    }
+    var BACK_ICON = '<svg viewBox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M11 4 6 9l5 5"/></svg>';
+    // Narrower windows fold the trail (style.css): the middle goes to "…", then
+    // the first crumb joins it and "…" links to the start, then only Back is left.
+    function backLinkHtml() {
+      var crumbs = trailCrumbs(), sep = '<span class="topbar-trail__sep" aria-hidden="true">›</span>';
+      if (!BACK) return '';
+      var back = '<a class="topbar-back" id="topbar-back" href="' + esc(BACK.href) + '" title="Back to ' + esc(BACK.label) + '">' +
+        BACK_ICON + '<span class="topbar-back__label">' + esc(BACK.label) + '</span></a>';
+      if (crumbs.length < 2) return back;
+      var older = crumbs.slice(0, -1), steps = older.map(function (c, i) {
+        return '<span class="topbar-trail__step topbar-trail__step--' + (i ? 'mid' : 'first') + '"><a class="topbar-crumb" href="' +
+          esc(c.href) + '">' + esc(c.label) + '</a>' + sep + '</span>';
+      });
+      steps.splice(1, 0, '<span class="topbar-trail__more"><a class="topbar-crumb topbar-crumb--more" href="' + esc(older[0].href) + '" title="' +
+        esc(older.map(function (c) { return c.label; }).join(' › ')) + '" aria-label="' + esc(older[0].label) + '">…</a>' + sep + '</span>');
+      return '<nav class="topbar-trail' + (older.length > 1 ? ' topbar-trail--long' : '') + '" aria-label="Breadcrumb">' +
+        BACK_ICON.replace('<svg ', '<svg class="topbar-trail__mark" ') + steps.join('') + back + '</nav>';
+    }
+    // Back through history when the origin IS the previous entry (the list keeps its
+    // scroll and filters); the href stays the real address for a new tab.
+    function onBackClick(e) {
+      if (!BACK || !BACK.viaReferrer || e.metaKey || e.ctrlKey || e.shiftKey || e.button > 0) return;
+      if (window.history && window.history.length > 1) { e.preventDefault(); window.history.back(); }
+    }
+
+    // A sidebar hop is not a drill-down: the page it opens shows no Back link.
+    function noteHop(href) {
+      try { window.sessionStorage.setItem(NAV_HOP_KEY, hallPath(new URL(href, location.href))); } catch (_) { /* private mode */ }
+    }
+    return { backLinkHtml: backLinkHtml, fillExits: fillExits, onBackClick: onBackClick, onTrailHash: onTrailHash, noteHop: noteHop };
+  }
+  window.OTBShellTrail = { make: make };
+})();

package/modules/hall-ui/public/shell.js

@@ -483,7 +483,7 @@
       '<button class="topbar-menu" id="topbar-menu" type="button" aria-label="Open navigation" aria-expanded="false">' +
         '<svg viewBox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" aria-hidden="true"><path d="M3 5h12M3 9h12M3 13h12"/></svg>' +
       '</button>' +
-      backLinkHtml() +
+      TRAIL.backLinkHtml() +
       '<h2 class="topbar-title" id="topbar-title"></h2>' +
       '<div class="topbar-side"><span class="topbar-note" id="welcome-line"></span>' +
       // task 2178: the jump-palette slot. Rendered inert + hidden — palette.js
@@ -495,6 +495,7 @@
         '<span class="topbar-jump__label">Jump to…</span>' +
         '<kbd class="topbar-jump__kbd" id="topbar-jump-kbd"></kbd>' +
       '</button>' +
+      (CRAFT ? CRAFT.switchHtml() : '') +
       '<button class="zoom-toggle" id="zoom-toggle" type="button" aria-label="Text size"></button>' +
       '<button class="theme-toggle" id="theme-toggle" type="button" aria-label="Switch theme"></button>' +
       // task 1004327: the full-screen switch, LAST so it sits in the corner the
@@ -506,171 +507,13 @@
     if (t) t.textContent = title;
   }
 
-  // ---------- the Back link (task 1004430) ----------
-  // A page reached from INSIDE another hall page (`?from=`, else a same-origin
-  // referrer) shows "← <that page>" in the top bar. A sidebar hop is not a
-  // drill-down: its click leaves a one-shot sessionStorage note, and the page it
-  // lands on shows none. task 1004477: the ONLY place a page's way back is
-  // decided. <body data-back-fallback="/work"> names where Back goes with no
-  // origin; a [data-shell-exit] link the page places is filled by the shell.
-  var NAV_HOP_KEY = 'hall-nav-hop';
-  function hallPath(url) {
-    return String(url.pathname).replace(/^\/builders(?=\/|$)/, '').replace(/\.html$/, '').replace(/\/index$/, '') || '/';
-  }
-  // The page this one was opened from: ?from=, then a same-origin referrer.
-  function linkOrigin() {
-    var from = null;
-    var viaReferrer = false;
-    try {
-      var q = new URLSearchParams(location.search || '').get('from');
-      if (q) from = new URL(q, location.origin);
-      else if (document.referrer) { from = new URL(document.referrer); viaReferrer = true; }
-    } catch (_) { return null; }
-    if (!from || from.origin !== location.origin) return null;
-    var path = hallPath(from);
-    if (/^\/(api|auth|lib)(\/|$)/.test(path)) return null;
-    // Keep the origin's query (a filtered list) but never its own ?from=, which
-    // would chain; and compare without OUR ?from=, so a self-link is refused.
-    var params = new URLSearchParams(from.search);
-    params.delete('from');
-    var search = params.toString() ? '?' + params.toString() : '';
-    var ownParams = new URLSearchParams(location.search || '');
-    ownParams.delete('from');
-    var here = hallPath(location) + (ownParams.toString() ? '?' + ownParams.toString() : '');
-    if (path + search === here) return null;
-    return { href: path + search + (from.hash || ''), path: path, label: backLabel(path, from.hash), viaReferrer: viaReferrer };
-  }
-  // <body data-back-fallback>, honoured only as a path on this host (never the API).
-  function fallbackOrigin() {
-    var f = document.body && document.body.dataset && document.body.dataset.backFallback;
-    if (!f || !/^\/(?!\/)/.test(f) || /[\\\s]/.test(f)) return null;
-    var u;
-    try { u = new URL(f, location.origin); } catch (_) { return null; }
-    if (u.origin !== location.origin) return null;
-    var path = hallPath(u);
-    if (/^\/(api|auth|lib)(\/|$)/.test(path) || path === hallPath(location)) return null;
-    return { href: path + (u.search || '') + (u.hash || ''), path: path, label: backLabel(path, u.hash), viaReferrer: false };
-  }
-  // "Back to tasks": a nav label is lowercased mid-sentence unless it has an acronym.
-  function exitWords(label) {
-    return 'Back to ' + (/[A-Z]{2}/.test(label) ? label : label.toLowerCase());
-  }
-  // Fill every [data-shell-exit] under `root` with the way back (else home); a
-  // page that renders one later (task.js's failure states) calls this again.
-  function fillExits(root) {
-    var scope = root || document;
-    if (!scope.querySelectorAll) return;
-    var target = BACK || { href: '/', label: 'Home', viaReferrer: false };
-    var links = scope.querySelectorAll('[data-shell-exit]');
-    for (var i = 0; i < links.length; i++) {
-      links[i].setAttribute('href', target.href);
-      links[i].textContent = exitWords(target.label);
-      if (!links[i].dataset.shellExitWired) {
-        links[i].dataset.shellExitWired = '1';
-        links[i].addEventListener('click', onBackClick);
-      }
-    }
-  }
-  function backLabel(path, hash) {
-    if (path === '/') {
-      var m = /^#\/(task|idea|blocker)\/(\d+)/.exec(hash || '');
-      return m ? m[1] + ' ' + m[2] : (/^#standing/.test(hash || '') ? 'Standing' : 'Home');
-    }
-    var rec = /^\/(task|idea)\/(\d+)$/.exec(path);
-    if (rec) return rec[1] + ' ' + rec[2];
-    if (path === '/goals' && /^#\/goal\/\d+/.test(hash || '')) return 'goal ' + hash.split('/')[2];
-    for (var g = 0; g < NAV.length; g++) {
-      for (var i = 0; i < NAV[g].items.length; i++) {
-        if (NAV[g].items[i].href === path) return NAV[g].items[i].label;
-      }
-    }
-    return 'Back';
-  }
-  // ---------- the trail (task 1004476) ----------
-  // Two clicks deep the bar shows the run of pages that led here, "Goals › goal
-  // 12 › task 340", the last crumb being Back. Kept per tab (sessionStorage) as
-  // crumbs ending with THIS page: a drill-down cuts after its origin and appends;
-  // returning to a crumb (the origin, if any, sits after it) trims; an unknown
-  // origin starts fresh by the ?from= / referrer / fallback rules; a sidebar hop
-  // starts over. Storage that throws, or no URL API, keeps the one-step Back.
-  var TRAIL_KEY = 'hall-nav-trail', TRAIL_MAX = 4, BACK = null;
-  function hereCrumb() {
-    var own = new URLSearchParams(location.search || ''); own.delete('from');
-    var path = hallPath(location), hash = location.hash || '';
-    return { href: path + (own.toString() ? '?' + own.toString() : '') + hash, label: backLabel(path, hash) };
-  }
-  // A stored crumb is honoured only as a path on this host with a string label.
-  function crumbOk(c) {
-    return !!c && typeof c.href === 'string' && typeof c.label === 'string' &&
-      /^\/(?!\/)/.test(c.href) && !/[\\\s]/.test(c.href) && !/^\/(api|auth|lib)(\/|[?#]|$)/.test(c.href);
-  }
-  function readTrail() {
-    try { var t = JSON.parse(window.sessionStorage.getItem(TRAIL_KEY) || '[]'); return Array.isArray(t) ? t.filter(crumbOk) : []; } catch (_) { return null; }
-  }
-  function writeTrail(t) {
-    try { window.sessionStorage.setItem(TRAIL_KEY, JSON.stringify(t.slice(-(TRAIL_MAX + 1)))); } catch (_) { /* private mode */ }
-  }
-  // Latest crumb at `href`; a referrer has no #hash, so it matches on the address alone.
-  function crumbAt(t, href, anyHash) {
-    for (var i = t.length - 1; i >= 0; i--) if (anyHash ? t[i].href.split('#')[0] === href.split('#')[0] : t[i].href === href) return i;
-    return -1;
-  }
-  // The crumbs before this page; the last is where Back goes. Sets BACK.
-  function trailCrumbs() {
-    var hop = null, here = null;
-    try { hop = window.sessionStorage.getItem(NAV_HOP_KEY); window.sessionStorage.removeItem(NAV_HOP_KEY); } catch (_) { /* private mode */ }
-    try { here = hereCrumb(); } catch (_) { /* no URL API */ }
-    var stored = here ? readTrail() : null, t = stored || [], trail = null, via = false;
-    here = here || { href: '', label: '' };
-    if (hop && hop === hallPath(location)) trail = [here];
-    var origin = trail ? null : linkOrigin();
-    var at = crumbAt(t, here.href), from = origin ? crumbAt(t, origin.href, origin.viaReferrer) : -1;
-    var f = trail || origin || at >= 0 ? null : fallbackOrigin();
-    if (!trail && at >= 0 && (!origin || from > at)) trail = t.slice(0, at + 1);
-    else if (!trail && origin) { trail = (from >= 0 ? t.slice(0, from + 1) : [origin]).concat([here]); via = origin.viaReferrer; }
-    else if (!trail) trail = f ? [f, here] : [here];
-    trail = trail.slice(-(TRAIL_MAX + 1)).map(function (c) { return { href: c.href, label: c.label }; });
-    if (stored) writeTrail(trail);
-    var crumbs = trail.slice(0, -1), last = crumbs[crumbs.length - 1];
-    BACK = last ? { href: last.href, label: last.label, viaReferrer: via } : null;
-    return crumbs;
-  }
-  // A hash route moves without a page load: a record view is a drill-down, a
-  // crumb already held is a return, any other view just renames this page's crumb.
-  function onTrailHash() {
-    var t = readTrail(), here;
-    if (!t || !t.length || t[t.length - 1].href.split(/[?#]/)[0] !== hallPath(location)) return;
-    try { here = hereCrumb(); } catch (_) { return; }
-    var at = crumbAt(t, here.href);
-    if (at >= 0) t = t.slice(0, at + 1);
-    else if (/^#\/(task|idea|blocker|goal)\/\d+/.test(location.hash || '')) t = t.concat([here]);
-    else t[t.length - 1] = here;
-    writeTrail(t);
-  }
-  var BACK_ICON = '<svg viewBox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M11 4 6 9l5 5"/></svg>';
-  // Narrower windows fold the trail (style.css): the middle goes to "…", then
-  // the first crumb joins it and "…" links to the start, then only Back is left.
-  function backLinkHtml() {
-    var crumbs = trailCrumbs(), sep = '<span class="topbar-trail__sep" aria-hidden="true">›</span>';
-    if (!BACK) return '';
-    var back = '<a class="topbar-back" id="topbar-back" href="' + esc(BACK.href) + '" title="Back to ' + esc(BACK.label) + '">' +
-      BACK_ICON + '<span class="topbar-back__label">' + esc(BACK.label) + '</span></a>';
-    if (crumbs.length < 2) return back;
-    var older = crumbs.slice(0, -1), steps = older.map(function (c, i) {
-      return '<span class="topbar-trail__step topbar-trail__step--' + (i ? 'mid' : 'first') + '"><a class="topbar-crumb" href="' +
-        esc(c.href) + '">' + esc(c.label) + '</a>' + sep + '</span>';
-    });
-    steps.splice(1, 0, '<span class="topbar-trail__more"><a class="topbar-crumb topbar-crumb--more" href="' + esc(older[0].href) + '" title="' +
-      esc(older.map(function (c) { return c.label; }).join(' › ')) + '" aria-label="' + esc(older[0].label) + '">…</a>' + sep + '</span>');
-    return '<nav class="topbar-trail' + (older.length > 1 ? ' topbar-trail--long' : '') + '" aria-label="Breadcrumb">' +
-      BACK_ICON.replace('<svg ', '<svg class="topbar-trail__mark" ') + steps.join('') + back + '</nav>';
-  }
-  // Back through history when the origin IS the previous entry (the list keeps its
-  // scroll and filters); the href stays the real address for a new tab.
-  function onBackClick(e) {
-    if (!BACK || !BACK.viaReferrer || e.metaKey || e.ctrlKey || e.shiftKey || e.button > 0) return;
-    if (window.history && window.history.length > 1) { e.preventDefault(); window.history.back(); }
-  }
+  // ---------- the way back (task 1004430/1004476/1004477) — shell-trail.js ----------
+  // task 1004492: the craft mode (craft-mode.js) — the top bar's mode switch and the picker.
+  var CRAFT = window.OTBCraftMode || null;
+  var TRAIL = window.OTBShellTrail ? window.OTBShellTrail.make({ esc: esc, nav: NAV }) : {
+    backLinkHtml: function () { return ''; }, fillExits: function () {}, onBackClick: function () {},
+    onTrailHash: function () {}, noteHop: function () {},
+  };
 
   // ---------- full screen (task 1004327; standard since task 1004430) ----------
   // One switch on EVERY shelled page hides the sidebar, top bar and foot; the same
@@ -1210,6 +1053,8 @@
     // AFTER the gate loop for the same reason applyCounts is: it reads the settled
     // permission map, which the loop above is what the shell has just been told.
     maybeRenderCoreUpdate();
+    // task 1004492: a signed-in builder with no mode yet this session is asked once.
+    if (CRAFT) CRAFT.onAccess(access, state && state.builder);
     var signin = document.getElementById('shell-signin');
     if (signin) signin.hidden = access.authed !== false;
     var user = document.getElementById('shell-user');
@@ -1383,14 +1228,13 @@
       }
       var a = e.target.closest && e.target.closest('a');
       if (a) {
-        // A sidebar hop is not a drill-down: the page it opens shows no Back link.
-        try { window.sessionStorage.setItem(NAV_HOP_KEY, hallPath(new URL(a.href, location.href))); } catch (_) { /* private mode */ }
+        TRAIL.noteHop(a.href);
         closeDrawer();
       }
     });
     var back = document.getElementById('topbar-back');
-    if (back) back.addEventListener('click', onBackClick);
-    window.addEventListener('hashchange', onTrailHash);
+    if (back) back.addEventListener('click', TRAIL.onBackClick);
+    window.addEventListener('hashchange', TRAIL.onTrailHash);
     if (IS_INDEX) {
       window.addEventListener('hashchange', function () { route(); });
     }
@@ -1463,10 +1307,11 @@
   renderFoot();
   applyTheme();
   applyZoom();
+  if (CRAFT) CRAFT.mount();
   applyFullscreen(storedFullscreen());
   applyAccess(null); // default: everything gated until access is known
   wire();
-  fillExits();
+  TRAIL.fillExits();
   if (IS_INDEX) {
     route({ scroll: false });
   } else {
@@ -1494,6 +1339,6 @@
     // and street) repaints the top bar's after writing 'hall-theme'.
     applyTheme: applyTheme,
     // task 1004477: a page that renders an exit after boot asks the shell to fill it.
-    fillExits: fillExits,
+    fillExits: TRAIL.fillExits,
   };
 })();

package/modules/hall-ui/public/street.html

@@ -203,7 +203,9 @@
   </div>
 </div>
 
-<script src="/builders/shell.js?v=2026-10-02-trail"></script>
+<script src="/builders/shell-trail.js?v=2026-10-02-craft"></script>
+<script src="/builders/craft-mode.js?v=2026-10-02-craft"></script>
+<script src="/builders/shell.js?v=2026-10-02-craft"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/city-draw.js?v=2026-10-02-street1"></script>
 <script src="/builders/street-draw.js?v=2026-10-02-street1"></script>

package/modules/hall-ui/public/studio.html

@@ -176,7 +176,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-10-02-trail"></script>
+<script src="/builders/shell-trail.js?v=2026-10-02-craft"></script>
+<script src="/builders/craft-mode.js?v=2026-10-02-craft"></script>
+<script src="/builders/shell.js?v=2026-10-02-craft"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-23-contrib"></script>
 <!-- The kit, for its ONE renderer: the full-size ship-time visual figure