npm - blockyard - Versions diffs - 0.1.0 → 0.1.1 - Mend

blockyard 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (71) hide show

package/CHANGELOG.md +108 -0
package/README.md +13 -11
package/SECURITY.md +2 -2
package/docs/API.md +1 -1
package/docs/ARCHITECTURE.md +36 -5
package/docs/CONFIGURATION.md +6 -4
package/docs/DEFECTS.md +4 -1
package/docs/GETTING-STARTED.md +14 -7
package/docs/INSTALL.md +7 -4
package/docs/PLAN-SCORCHED-YARD.md +456 -0
package/docs/PLAN-SKIES.md +142 -0
package/docs/SECURITY-AUDIT-2026-09-16.md +647 -0
package/docs/SECURITY.md +26 -7
package/docs/TROUBLESHOOTING.md +10 -5
package/docs/USER-GUIDE.md +239 -9
package/package.json +4 -2
package/public/css/app.css +87 -0
package/public/index.html +58 -6
package/public/js/app.js +60 -19
package/public/js/blockanoid.js +15 -7
package/public/js/blockout.js +15 -7
package/public/js/blockscene3d.js +51 -11
package/public/js/depthchart.js +1 -1
package/public/js/details3d.js +25 -2
package/public/js/explorer.js +7 -1
package/public/js/livingsky.js +494 -0
package/public/js/login.js +3 -2
package/public/js/mining.js +4 -4
package/public/js/panels.js +27 -18
package/public/js/safenext.js +14 -0
package/public/js/scorched.js +1051 -0
package/public/js/scorchedai.js +227 -0
package/public/js/scorchedair.js +286 -0
package/public/js/scorchedfx.js +376 -0
package/public/js/scorchedshop.js +105 -0
package/public/js/scorchedwind.js +69 -0
package/public/js/scorchedyard.js +1338 -0
package/public/js/settings.js +266 -80
package/public/js/tetrust.js +15 -6
package/public/js/tetsound.js +35 -5
package/scripts/check.js +46 -0
package/scripts/index-build.js +9 -2
package/scripts/pool-map.js +152 -36
package/scripts/setup.js +108 -10
package/scripts/shots.mjs +21 -0
package/scripts/smoke.sh +6 -5
package/scripts/ui.js +4 -2
package/server/auth/sessions.js +33 -13
package/server/chain/blockfile.js +64 -5
package/server/chain/index/build.js +432 -56
package/server/chain/index/heights.js +29 -3
package/server/chain/index/live.js +13 -7
package/server/chain/index/rows.js +6 -1
package/server/chain/index/store.js +28 -5
package/server/chain/index/worker.js +23 -11
package/server/collect/logparse.js +65 -18
package/server/collect/markets.js +76 -7
package/server/collect/mining.js +32 -0
package/server/collect/monitor.js +24 -11
package/server/collect/network.js +19 -9
package/server/config.js +7 -0
package/server/http/api.js +70 -13
package/server/http/server.js +22 -5
package/server/http/sse.js +53 -7
package/server/main.js +13 -3
package/server/rpc/allowlist.js +26 -0
package/server/rpc/client.js +30 -2
package/server/store/audit.js +6 -1
package/server/store/history.js +19 -3
package/server/store/ledger.js +15 -4
package/systemd/blockyard.service +34 -3

package/public/js/app.js CHANGED Viewed

@@ -11,8 +11,7 @@ import { renderMiningOverview, renderMining, renderBlockSpace, refreshLabel } fr
 import { viewerIdle } from './details3d.js';
 import {
   loadSettings, setSetting, resetSettings, seedSettings, setSettingsPush,
-  SETTINGS_KEY, PANEL as SETTINGS_PANEL, formatRangeValue,
-} from './settings.js';
+  SETTINGS_KEY, PANEL as SETTINGS_PANEL, formatRangeValue, SKY_BOARDS, SKY_CHOICES } from './settings.js';
 // APPEARANCE (2026-09-16): the theme goes on <html> before the first paint, from the browser's copy
 // of the settings, and follows every change after (followTheme); the cards' swatches are painted
 // through the CSSOM because the CSP refuses a style attribute in markup
@@ -21,12 +20,32 @@ import { followTheme, presetFace, resolveScheme, resolveTheme, PRESETS, BASE_KEY
 import { renderExplorer } from './explorer.js';
 import { renderMarkets, summaryHtml as marketsSummaryHtml, REFRESH_MS as MARKETS_REFRESH_MS } from './markets.js';
 import { renderKiosk } from './kiosk.js';
-import { renderTetrust } from './tetrust.js';
-import { renderBlockout } from './blockout.js';
-import { renderBlockanoid } from './blockanoid.js';
-import { renderWolf3d } from './wolf3d.js';
-import { renderDoom } from './doom.js';
-import { renderQuake } from './quake.js';
+// THE GAMES LOAD WHEN THEY ARE OPENED (the outside review of 2026-09-16: "Move the DOOM/Wolfenstein/
+// Quake emulator and 3D games into an optional, separately loadable module ... This reduces the
+// attack and bug surface of the core monitor"). They were static imports, so the Overview of a node
+// monitor fetched and evaluated twenty game modules -- a quarter of the app's code -- before it drew
+// a chart. Each game is now an import() made the first time its page is opened; a monitor that is
+// only ever used as a monitor never runs a line of them.
+const GAMES = Object.freeze({
+  tetrust: () => import('./tetrust.js').then((m) => m.renderTetrust),
+  blockout: () => import('./blockout.js').then((m) => m.renderBlockout),
+  blockanoid: () => import('./blockanoid.js').then((m) => m.renderBlockanoid),
+  scorched: () => import('./scorchedyard.js').then((m) => m.renderScorchedYard),
+  wolf3d: () => import('./wolf3d.js').then((m) => m.renderWolf3d),
+  doom: () => import('./doom.js').then((m) => m.renderDoom),
+  quake: () => import('./quake.js').then((m) => m.renderQuake),
+});
+const gameRenderers = new Map();
+const gameLoads = new Map();
+/** Draw a game's page, loading its module the first time; the page repaints once it has arrived. */
+function renderGame(page, s) {
+  const draw = gameRenderers.get(page);
+  if (draw) { draw(s, state, helpers); return; }
+  if (gameLoads.has(page)) return;
+  gameLoads.set(page, GAMES[page]()
+    .then((fn) => { gameRenderers.set(page, fn); if (state.page === page) render(); })
+    .catch((e) => { gameLoads.delete(page); toast(`${page} could not be loaded: ${e.message}`, 'bad'); }));
+}
 import { renderAbout } from './about.js';
 import { renderChain, renderMempool, renderPeers, renderNetwork, renderLogs, renderNode, renderAdmin, ensureLogsLoaded, init as initPanels, initChainDrill } from './panels.js';
@@ -528,12 +547,9 @@ export function render() {
     case 'explorer': renderExplorer(s, state, helpers); break;
     case 'markets': renderMarkets(s, state, helpers); break;
     case 'kiosk': renderKiosk(s, state, helpers); break;
-    case 'tetrust': renderTetrust(s, state, helpers); break;
-    case 'blockout': renderBlockout(s, state, helpers); break;
-    case 'blockanoid': renderBlockanoid(s, state, helpers); break;
-    case 'wolf3d': renderWolf3d(s, state, helpers); break;
-    case 'doom': renderDoom(s, state, helpers); break;
-    case 'quake': renderQuake(s, state, helpers); break;
+    case 'tetrust': case 'blockout': case 'blockanoid': case 'scorched': case 'wolf3d': case 'doom': case 'quake':
+      renderGame(state.page, s);
+      break;
     case 'about': renderAbout(s, state, helpers); break;
   }
 }
@@ -923,7 +939,7 @@ function shortBuild(build) {
 // subroutes; they stay on the URL so every explorer page is a link.
 // The games live behind the Diversions pop-down at the end of the nav; the menu shows as the
 // active tab while one of them is open, since its own button is out of sight inside the popup.
-const DIVERSION_PAGES = ['tetrust', 'blockout', 'blockanoid', 'wolf3d', 'doom', 'quake'];
+const DIVERSION_PAGES = ['tetrust', 'blockout', 'blockanoid', 'scorched', 'wolf3d', 'doom', 'quake'];
 function setPage(route) {
   const [page, ...rest] = String(route).split('/');
@@ -1165,6 +1181,23 @@ async function boot() {
           `<button type="button" class="cfgsegbtn${val === v ? ' on' : ''}" role="radio" aria-checked="${val === v}" data-cfgset="${g.group}.${r.key}" data-value="${val}">${label}</button>`).join('')}</span>`;
         return `<div class="cfgrow"><b><label>${r.label}</label></b><span>${seg}</span><i>${r.hint}</i></div>`;
       }
+      // WHICH SKY, WHERE (docs/PLAN-SKIES.md): the table at the top of the Sky tab. One row per board
+      // that has a sky, each a select on that board's own `sky` key -- the same setting the board's
+      // tab shows, through the same data-cfg path, so a change in either place is one change.
+      if (r.kind === 'skymap') {
+        const rows = SKY_BOARDS.map((b) => {
+          const cur = s[b.group]?.sky ?? 'galaxy';
+          const sel = `<select data-cfg="${b.group}.sky" aria-label="${b.label}: sky">${SKY_CHOICES.map(([val, label]) => `<option value="${val}"${val === cur ? ' selected' : ''}>${label}</option>`).join('')}</select>`;
+          return `<tr><th scope="row">${b.label}${b.note ? `<small>${b.note}</small>` : ''}</th><td>${sel}</td></tr>`;
+        }).join('');
+        return `<div class="cfgrow cfgskymap"><b><label>${r.label}</label></b><span><table class="skymap">${rows}</table></span><i>${r.hint}</i></div>`;
+      }
+      // a heading inside a group: the two skies of the Sky tab, each introducing its own rows
+      if (r.kind === 'heading') {
+        const close = open ? '</div>' : '';
+        open = false;
+        return `${close}<div class="cfghead"><b>${r.label}</b><i>${r.hint}</i></div>`;
+      }
       if (r.kind === 'cards') {
         const scheme = resolveScheme(s.appearance);
         const cards = r.options.map(([val, label]) => {
@@ -1186,17 +1219,25 @@ async function boot() {
             : `<span class="cfgrange"><input type="range" id="${id}" data-cfg="${g.group}.${r.key}" min="${r.min}" max="${r.max}" step="${r.step}" value="${v}"><span class="val" data-val-for="${g.group}.${r.key}">${formatRangeValue(r.step, v)}</span></span>`;
       // (and the nine custom colours of the Appearance tab the same way: two across, hint as tooltip,
       // dimmed while another theme is chosen, so the tab is a screen)
+      // A CONTROL THAT DOES NOTHING RIGHT NOW SAYS SO (operator, 2026-09-16: "It's counter
+      // intuitive in the preferences to display a spiral galaxy for a night/day scene"). A row
+      // whose `dimWhen` is true of the current settings is dimmed and says which sky it belongs
+      // to, rather than being hidden: the setting is still there, and still remembered.
+      const off = (r.custom && s.appearance.theme !== 'custom') || (typeof r.dimWhen === 'function' && r.dimWhen(s));
+      const idle = off ? ' idle' : '';
+      const note = off && r.dimNote ? ` <em>${r.dimNote}</em>` : '';
       if ((compact && r.kind === 'toggle') || r.custom) {
         const start = open ? '' : '<div class="cfgrows2">';
         open = true;
-        const idle = r.custom && s.appearance.theme !== 'custom' ? ' idle' : '';
-        return `${start}<div class="cfgrow compact${idle}" title="${String(r.hint).replace(/"/g, '&quot;')}"><b><label for="${id}">${r.label}</label></b><span>${ctl}</span></div>`;
+        return `${start}<div class="cfgrow compact${idle}" title="${String(off && r.dimNote ? `${r.dimNote} — ${r.hint}` : r.hint).replace(/"/g, '&quot;')}"><b><label for="${id}">${r.label}</label></b><span>${ctl}</span></div>`;
       }
       const close = open ? '</div>' : '';
       open = false;
-      return `${close}<div class="cfgrow"><b><label for="${id}">${r.label}</label></b><span>${ctl}</span><i>${r.hint}</i></div>`;
+      return `${close}<div class="cfgrow${idle}"><b><label for="${id}">${r.label}</label></b><span>${ctl}</span><i>${r.hint}${note}</i></div>`;
       }).join('') + (open ? '</div>' : '');
-      return `<div class="cfggroup"><h3>${g.title}</h3><p>${g.note}</p>${bulk}${rowsHtml}</div>`;
+      // the Space effects tab says so while the Living sky has them off (settings.js spaceOptions)
+      const held = g.group === 'effects' && s.sky.type === 'living' ? '<p class="cfgheld">Off while the sky is the Living sky (Sky tab): these play over space. Your switches are kept.</p>' : '';
+      return `<div class="cfggroup"><h3>${g.title}</h3><p>${g.note}</p>${held}${bulk}${rowsHtml}</div>`;
     }).join('');
     for (const el of cfgBody.querySelectorAll('[data-swatch]')) el.style.setProperty('background', el.dataset.swatch);
     for (const el of cfgBody.querySelectorAll('.thcard')) {

package/public/js/blockanoid.js CHANGED Viewed

@@ -10,7 +10,7 @@ import {
   newGame, advance, step, movePaddle, nudge, launch, fire, tiles, remaining, powers, setOptions,
   COLS, ROWS, LIVES, CAPSULE_LETTER, layoutFor,
 } from './arkanoid.js';
-import { loadSettings, setSetting, blockanoidOptions } from './settings.js';
+import { loadSettings, setSetting, blockanoidOptions, nextSky, SKY_LABELS } from './settings.js';
 import * as sound from './tetsound.js';
 const SCORES_KEY = 'blockyard.blockanoid.scores';
@@ -130,9 +130,20 @@ function drawScores(highlightAt = null) {
   if (t.innerHTML !== html) t.innerHTML = html;
 }
-const SWITCHES = [['baStars', 'stars'], ['baGalaxy', 'galaxy'], ['baNeon', 'neon'], ['baSfx', 'sfx']];
+const SWITCHES = [['baNeon', 'neon'], ['baSfx', 'sfx']];
+/** The sky button says which sky it is on, and lights up while there is one. */
+function skyButton(id, sky) {
+  const b = el(id);
+  if (!b) return;
+  b.textContent = `\u2600 ${SKY_LABELS[sky] ?? sky}`;
+  b.classList.toggle('on', sky !== 'none');
+  b.setAttribute('aria-pressed', sky !== 'none' ? 'true' : 'false');
+}
 function drawSwitches() {
   const b = blockanoidOptions(loadSettings());
+  // ONE SKY BUTTON (docs/PLAN-SKIES.md): Galaxy, Earth or none, round the ring, in place of the old
+  // star field and galaxy pair -- the same setting the Sky tab's table shows for this board
+  skyButton('baSkySw', b.sky.sky);
   for (const [id, key] of SWITCHES) {
     const btn = el(id);
     if (!btn) continue;
@@ -146,7 +157,6 @@ function flip(key) {
   setSetting(loadSettings(), `blockanoid.${key}`, !cur);
   sound.unlock();
   drawSwitches();
-  if (key === 'stars' || key === 'galaxy') drawSky();
   // capsules and minions change the RULES, so a flip must reach the game IN PLAY, not just the
   // next one -- otherwise the switch does nothing until you lose, which reads as a broken control
   if (G.game) { const b = blockanoidOptions(loadSettings()); setOptions(G.game, { capsules: b.capsules, enemies: b.enemies }); }
@@ -159,10 +169,7 @@ function drawSky() {
   const b = blockanoidOptions(loadSettings());
   board3d(sky, [], {
     ...SKY,
-    stars: b.stars, galaxy: b.stars && b.galaxy, galaxyAt: b.galaxyAt,
-    starDensity: b.starDensity, starBrightness: b.starBrightness,
-    nebulae: b.nebulae, galaxies: b.galaxies, dust: b.dust, clusters: b.clusters,
-    starColours: b.starColours, starGlints: b.starGlints,
+    ...b.sky,          // which sky this board chose, and what it is made of (settings.js skyFor)
   });
 }
@@ -327,6 +334,7 @@ function bind() {
   });
   court?.addEventListener('contextmenu', (e) => { if (G.running) e.preventDefault(); });
   for (const [id, key] of SWITCHES) el(id)?.addEventListener('click', () => flip(key));
+  el('baSkySw')?.addEventListener('click', () => { const s = loadSettings(); setSetting(s, 'blockanoid.sky', nextSky(blockanoidOptions(s).sky.sky)); sound.unlock(); drawSwitches(); drawSky(); draw(); });
 }
 export function renderBlockanoid(s, state, h) {

package/public/js/blockout.js CHANGED Viewed

@@ -12,7 +12,7 @@ import {
   newGame, advance, step, movePaddle, nudge, launch, tiles, remaining,
   COLS, ROWS, LIVES,
 } from './breakout.js';
-import { loadSettings, setSetting, blockoutOptions } from './settings.js';
+import { loadSettings, setSetting, blockoutOptions, nextSky, SKY_LABELS } from './settings.js';
 import * as sound from './tetsound.js';
 const SCORES_KEY = 'blockyard.blockout.scores';
@@ -145,9 +145,20 @@ function drawScores(highlightAt = null) {
   if (t.innerHTML !== html) t.innerHTML = html;
 }
-const SWITCHES = [['boStars', 'stars'], ['boGalaxy', 'galaxy'], ['boNeon', 'neon'], ['boSfx', 'sfx']];
+const SWITCHES = [['boNeon', 'neon'], ['boSfx', 'sfx']];
+/** The sky button says which sky it is on, and lights up while there is one. */
+function skyButton(id, sky) {
+  const b = el(id);
+  if (!b) return;
+  b.textContent = `\u2600 ${SKY_LABELS[sky] ?? sky}`;
+  b.classList.toggle('on', sky !== 'none');
+  b.setAttribute('aria-pressed', sky !== 'none' ? 'true' : 'false');
+}
 function drawSwitches() {
   const b = blockoutOptions(loadSettings());
+  // ONE SKY BUTTON (docs/PLAN-SKIES.md): Galaxy, Earth or none, round the ring, in place of the old
+  // star field and galaxy pair -- the same setting the Sky tab's table shows for this board
+  skyButton('boSkySw', b.sky.sky);
   for (const [id, key] of SWITCHES) {
     const btn = el(id);
     if (!btn) continue;
@@ -161,7 +172,6 @@ function flip(key) {
   setSetting(loadSettings(), `blockout.${key}`, !cur);
   sound.unlock();
   drawSwitches();
-  if (key === 'stars' || key === 'galaxy') drawSky();
   G.dirty = true;
   draw();
 }
@@ -172,10 +182,7 @@ function drawSky() {
   const b = blockoutOptions(loadSettings());
   board3d(sky, [], {
     ...SKY,
-    stars: b.stars, galaxy: b.stars && b.galaxy, galaxyAt: b.galaxyAt,
-    starDensity: b.starDensity, starBrightness: b.starBrightness,
-    nebulae: b.nebulae, galaxies: b.galaxies, dust: b.dust, clusters: b.clusters,
-    starColours: b.starColours, starGlints: b.starGlints,
+    ...b.sky,          // which sky this board chose, and what it is made of (settings.js skyFor)
   });
 }
@@ -329,6 +336,7 @@ function bind() {
   court?.addEventListener('pointermove', onPointer);
   court?.addEventListener('pointerdown', (e) => { onPointer(e); serve(); });
   for (const [id, key] of SWITCHES) el(id)?.addEventListener('click', () => flip(key));
+  el('boSkySw')?.addEventListener('click', () => { const s = loadSettings(); setSetting(s, 'blockout.sky', nextSky(blockoutOptions(s).sky.sky)); sound.unlock(); drawSwitches(); drawSky(); draw(); });
 }
 export function renderBlockout(s, state, h) {

package/public/js/blockscene3d.js CHANGED Viewed

@@ -852,21 +852,50 @@ const flipOf = (o) => (o.flipY === false ? -1 : 1);
 // settings"). Each lamp is a direction over the board for the dome's slope shading (grid x,
 // screen-up rows, up) and a direction across the screen for the side faces (x right, y down);
 // `overhead` is straight above, so no slope is in shade and every side takes the same light.
+// SIX PLACEMENTS AT THREE HEIGHTS (operator, 2026-09-16: "add more camera light angles ... Low
+// Middle and High light placement locations, top left, top right, bottom left, bottom right,
+// viewer, direct overhead"). A placement is a direction across the board (x right, y screen-up);
+// the height is the lamp's elevation over it: low 25°, middle 45°, high 65°. `overhead` ignores
+// the height. The old names (upper-left, upper-right) still answer, as top-left and top-right at
+// the middle height; `front` is the lamp at the viewer. (Not 'viewer': `light: 'viewer'` is the
+// Markets board's own flat, viewer-lit finish -- viewerLit below -- and a placement of that name
+// turned the whole block board flat-shaded, which the operator saw at once on 2026-09-16.)
+export const LIGHT_PLACES = Object.freeze({
+  'overhead': [0, 0], 'top-left': [-1, 1], 'top-right': [1, 1], 'bottom-left': [-1, -1], 'bottom-right': [1, -1], 'front': [0, -1],
+});
+export const LIGHT_HEIGHTS = Object.freeze({ low: 25, middle: 45, high: 65 });
+const LIGHT_ALIASES = Object.freeze({ 'upper-left': 'top-left', 'upper-right': 'top-right' });
+export function lampFor(place, height = 'middle') {
+  const p = LIGHT_PLACES[place] ?? LIGHT_PLACES['top-left'];
+  if (!p[0] && !p[1]) return { L: [0, 0, 1], side: [0, 0] };
+  const el = ((LIGHT_HEIGHTS[height] ?? 45) * Math.PI) / 180;
+  const n = Math.hypot(p[0], p[1]) || 1;
+  const ax = p[0] / n, ay = p[1] / n;
+  // the side faces take the lamp's direction across the screen (y down), weaker the higher it hangs
+  const k = 0.9 * Math.cos(el) / Math.cos((45 * Math.PI) / 180);
+  return { L: [ax * Math.cos(el), ay * Math.cos(el), Math.sin(el)], side: [ax * k, -ay * k] };
+}
 export const LIGHTS = Object.freeze({
-  'overhead': { L: [0, 0, 1], side: [0, 0] },
-  'upper-left': { L: [-0.55, 0.55, 0.63], side: [-0.7071, -0.7071] },
-  'upper-right': { L: [0.55, 0.55, 0.63], side: [0.7071, -0.7071] },
-  'front': { L: [0, -0.55, 0.63], side: [0, 0.9] },
+  'overhead': lampFor('overhead'),
+  'top-left': lampFor('top-left'), 'top-right': lampFor('top-right'), 'bottom-left': lampFor('bottom-left'), 'bottom-right': lampFor('bottom-right'), 'front': lampFor('front'),
+  'upper-left': lampFor('top-left'), 'upper-right': lampFor('top-right'),
 });
-export const LIGHT_DEFAULT = 'upper-left';
+export const LIGHT_DEFAULT = 'top-left';
+// the middle of the shipped brightness range: `lightGain` stretches the faces about this point
+const LIT_MID = 0.58;
 const NEON_HEX = /^#[0-9a-f]{6}$/i;
 export function lightOf(o = {}) {
-  return LIGHTS[o.light] ? o.light : o.overheadLight === true ? 'overhead' : LIGHT_DEFAULT;
+  const name = LIGHT_ALIASES[o.light] ?? o.light;
+  return LIGHT_PLACES[name] ? name : o.overheadLight === true ? 'overhead' : LIGHT_DEFAULT;
+}
+/** The lamp a board asks for: its placement at its height. */
+export function lampOf(o = {}) {
+  return lampFor(lightOf(o), LIGHT_HEIGHTS[o.lightHeight] ? o.lightHeight : 'middle');
 }
 export function domeLight(t, o = {}) {
   const { dome = 0, gridW = 0, gridH = 0 } = o;
   if (!dome || !gridW || !gridH) return 1;
-  const lamp = LIGHTS[lightOf(o)];
+  const lamp = lampOf(o);
   // straight above: the slope shades nothing -- the bottom rows, which lean away from a corner
   // lamp and sat at the 0.6 floor, read as bright as the middle
   if (lamp.L[0] === 0 && lamp.L[1] === 0) return 1;
@@ -1271,7 +1300,7 @@ export function buildScene(tiles, o = {}) {
   // among equals the one further from the vanishing point first (its sides
   // lean outward, away from its nearer neighbours).
   const vx0 = o.vanishX ?? 0, vy0 = o.vanishY ?? 0;
-  const ordered = o.oblique && o.order === 'diagonal' ? diagonalOrder(tiles) : o.oblique ? obliqueOrder(tiles, o) : tiles.map((t) => (growth.has(t) ? { ...t, boost: growth.get(t) } : t))
+  const ordered = o.order === 'given' ? tiles.slice() : o.oblique && o.order === 'diagonal' ? diagonalOrder(tiles) : o.oblique ? obliqueOrder(tiles, o) : tiles.map((t) => (growth.has(t) ? { ...t, boost: growth.get(t) } : t))
     .map((t) => { const c = project(t.x + t.s / 2, t.y + t.s / 2, 0, o); return { t, top: (t.z ?? 0) + (t.floor ?? 0) + cubeHeight(t), d: Math.hypot(c.x - vx0, c.y - vy0) }; })
     // Under the oblique camera a cube reaches STRAIGHT UP from its footprint (measured: height
     // moves screen y only, grid x moves screen x only), so it can only cover blocks at smaller
@@ -1326,7 +1355,10 @@ export function buildScene(tiles, o = {}) {
   })).filter((e) => e.k > 0.01) : [];
   // the lamp's direction across the screen, for the side faces (LIGHTS); under the overhead
   // lamp every side takes the same light, a shade under the top
-  const lampSide = LIGHTS[lightOf(o)].side;
+  const lampSide = lampOf(o).side;
+  // the lamp's hardness and how bright the tops sit under it (see the side loop below)
+  const gain = Number.isFinite(o.lightGain) ? Math.max(0.2, Math.min(3, o.lightGain)) : 1;
+  const topLit = Number.isFinite(o.topLight) ? Math.max(0.1, Math.min(1.4, o.topLight)) : 0.8;
   for (const t of ordered) {
     const fxv = (t.z ?? 0) > 0.02 ? FX_NONE : fxAt(t, o.fx);
     // GONE FOR THE DURATION, not deleted: a hidden cube is skipped this frame and drawn again the
@@ -1517,11 +1549,19 @@ export function buildScene(tiles, o = {}) {
       // brighter, one turned away falls into shadow
       const d = side.nx * lampSide[0] + side.ny * lampSide[1];
       // from the viewer: a face pointing down the screen (toward the camera) takes the most light
-      const k = viewerLit ? 0.6 + 0.42 * Math.max(0, side.ny) + 0.3 * Math.max(0, side.nx) - 0.16 * Math.max(0, -side.nx) : 0.34 + 0.26 * (d + 1);
+      const k0 = viewerLit ? 0.6 + 0.42 * Math.max(0, side.ny) + 0.3 * Math.max(0, side.nx) - 0.16 * Math.max(0, -side.nx) : 0.34 + 0.26 * (d + 1);
+      // HOW HARD THE LAMP IS (operator, 2026-09-16: "we need better lighting on the front of the
+      // blocks. Still looks too washed out and not illuminated well enough"). The shipped range put
+      // every face between 0.34 and 0.86 of its colour with the top at 0.8: a narrow band, and a
+      // board of it reads as tinted rather than lit. `lightGain` stretches that range about its
+      // middle -- above 1 the face turned to the lamp goes brighter than its own colour and the one
+      // turned away falls properly dark. 1 is exactly what every board drew before this.
+      const k = Math.max(0.06, Math.min(1.4, LIT_MID + (k0 - LIT_MID) * gain));
       out.push({ txid: t.txid, face: 'side', key: side.key, points: side.points, fill: shade(c, k * lit, a), ...(viewerLit ? { stroke: lift(c, 0.45, round3(0.5 * a)) } : {}) });
       side.points.forEach(note);
     }
-    out.push({ txid: t.txid, face: 'top', points: f.top, fill: shade(c, (viewerLit ? 1.02 : 0.8) * lit, a), stroke: viewerLit ? lift(c, 0.55, round3(0.6 * a)) : `rgba(0,0,0,${round3(seam * a)})` });
+    const topK = viewerLit ? 1.02 : Math.max(0.06, Math.min(1.4, LIT_MID + (topLit - LIT_MID) * gain));
+    out.push({ txid: t.txid, face: 'top', points: f.top, fill: shade(c, topK * lit, a), stroke: viewerLit ? lift(c, 0.55, round3(0.6 * a)) : `rgba(0,0,0,${round3(seam * a)})` });
     f.top.forEach(note);
     if (f.innerG && !viewerLit) {

package/public/js/depthchart.js CHANGED Viewed

@@ -242,7 +242,7 @@ const offText = (d) => (d?.enabled === false ? (d.polling === false ? 'market po
 export function depthNote(d, fmt) {
   if (!d) return 'asking the exchanges for their order books…';
-  if (d.enabled === false) return d.note ?? 'market data is off on this monitor';
+  if (d.enabled === false) return d.note != null ? fmt.esc(d.note) : 'market data is off on this monitor';   // markup sink: escaped (audit 2026-09-16, I2)
   if (d.warming) return 'reading the order books for the first time…';
   const agoL = AGOS.find(([s]) => s === d.ago)?.[1] ?? `${d.ago} s`;
   const parts = [`books read at ${clock(d.at)} UTC, every ${Math.round((d.bookMs ?? DEPTH_MS) / 1000)} s while this tab is open`];

package/public/js/details3d.js CHANGED Viewed

@@ -19,6 +19,7 @@ import { planTransition, frameAt, fitToBox, project, fxFront, TRANSITION, SLAB_H
 // This module keeps three seams and nothing else -- build here in startFx, frame in fxNow,
 // draw in paintFrame -- so fifty agents do not become fifty `if`s in the renderer.
 import { AGENTS, isAgent, rng, lensFlare, saucerAbove } from './agents.js';
+import { drawLivingSky } from './livingsky.js';
 const STATE = new WeakMap();
@@ -3132,7 +3133,14 @@ const NO_CANVAS = {};
 // line, so turning the stars off through it RESTYLED THE WHOLE BOARD -- which is not what a switch
 // labelled "Star field" should do. `stars` gates the sky alone; where it is absent the old
 // meaning stands, so every caller that never heard of it behaves exactly as before.
-const starsOn = (o) => !!(o.stars ?? o.space);
+// THE LIVING SKY IS NOT THE STAR FIELD (operator, 2026-09-16: "The sky is not drawing for me ...
+// The background is all black for me"). With the living sky chosen and the Star field switch off,
+// this gate turned off the day as well: a blue afternoon and a moonrise were being hidden by a
+// switch about stars. A board that asks for the living sky draws it whatever that switch says;
+// `stars` still decides the star field, which the living sky brings out at night by itself.
+// the Earth sky (settings.js calls it 'earth'; 'living' was its name for a day and still answers)
+const earthSky = (o) => o.skyType === 'earth' || o.skyType === 'living';
+const starsOn = (o) => earthSky(o) || !!(o.stars ?? o.space);
 // THE GALAXY (operator, 2026-09-12: "I want all the starts slowly rotating to form a spiral
 // galaxy in the background ... Make it a toggle").
 //
@@ -3688,7 +3696,12 @@ function paintFrame(ctx, geom, frame, opts, view, gridN, blockRows, gridH = grid
   ctx.clearRect(0, 0, pw, ph);
   ctx.fillStyle = opts.background;
   ctx.fillRect(0, 0, pw, ph);
-  if (starsOn(opts)) drawStars(ctx, pw, ph, dpr || 1, view.now ?? 0, opts);
+  // THE SKY: the star field, or the living sky (livingsky.js: a real day from the clock, with the
+  // star field coming out at night through the same drawStars)
+  if (starsOn(opts)) {
+    if (earthSky(opts)) drawLivingSky(ctx, pw, ph, dpr || 1, view.now ?? 0, opts, { softStops, drawStars: (o) => drawStars(ctx, pw, ph, dpr || 1, view.now ?? 0, o) });
+    else drawStars(ctx, pw, ph, dpr || 1, view.now ?? 0, opts);
+  }
   // with nothing on the board -- every block in the air between two layouts (a viewer-mode switch)
   // -- the oblique board still draws itself: its transform is a constant, not fitted to the blocks
   if (!frame.bounds && !opts.oblique) return;
@@ -3757,6 +3770,13 @@ function paintFrame(ctx, geom, frame, opts, view, gridN, blockRows, gridH = grid
   const agentDraw = view.fx?.kind ? AGENTS[view.fx.kind]?.draw : null;
   if (agentDraw) agentDraw(ctx, view, ctx.lineWidth, { drawCycles, drawBall, project });
   else { drawCycles(ctx, view, ctx.lineWidth); drawBall(ctx, view, ctx.lineWidth); drawFireworks(ctx, view, ctx.lineWidth); drawSupernova(ctx, view, ctx.lineWidth); drawBlackHole(ctx, view, ctx.lineWidth); drawScanCurtain(ctx, view, ctx.lineWidth); }
+  // A CALLER'S OWN LAYER, over the board and in the board's own projection (operator, 2026-09-16:
+  // "We have fucking firework and nebula effects and you're doing shitty block and sprite
+  // explosions?"). The effects above are the renderer's, chosen by cadence and seed; a game needs
+  // to draw ITS events -- a shell landing here, at this instant -- with the same primitives. The
+  // hook hands over the projector and softStops, so an explosion is built the way the fireworks
+  // are rather than out of tiles, and lands exactly where the cell it destroyed was.
+  if (typeof opts.overlay === 'function') opts.overlay(ctx, view, { project, softStops, lw: ctx.lineWidth });
   ctx.setTransform(1, 0, 0, 1, 0, 0);
 }
@@ -4104,6 +4124,7 @@ export function render3d(canvas, cells, options = {}) {
     opts.starDensity, opts.starBrightness, opts.galaxy === true, opts.galaxyAt,
     opts.nebulae !== false, opts.galaxies !== false, opts.dust !== false, opts.clusters !== false,
     opts.starColours !== false, opts.starGlints !== false,
+    opts.skyType, opts.skyClock, opts.skyHour, opts.skyWeather, opts.skyCover, opts.skyLat, opts.skyRays !== false, opts.skyRainbow === true, opts.skyShooting !== false, opts.skyHorizon, opts.skyMoon,
     opts.neon === true, opts.sheen === true, opts.sheenStyle, opts.overheadLight === true, opts.light,
     opts.neonSource, opts.neonColour, opts.neonBrightness, opts.wireWidth,
     opts.transition ? `${opts.transition.rise}/${opts.transition.travel}/${opts.transition.drop}` : 'default'].join('|');
@@ -4212,6 +4233,8 @@ export function render3d(canvas, cells, options = {}) {
       neon: opts.neon === true, sheen: opts.sheen === true, sheenStyle: opts.sheenStyle,
       overheadLight: opts.overheadLight === true,   // the lamp straight above (Tetrust)
       light: opts.light,                            // or wherever settings.js space.light puts it
+      lightHeight: opts.lightHeight,
+      lightGain: opts.lightGain, topLight: opts.topLight,   // how hard the lamp is, and how bright the tops sit under it
       neonSource: opts.neonSource, neonColour: opts.neonColour, neonBrightness: opts.neonBrightness,
       wireWidth: opts.wireWidth,
       // the paint order's memory across frames (blockscene3d obliqueOrder): a tangle keeps the

package/public/js/explorer.js CHANGED Viewed

@@ -19,8 +19,14 @@
 const X = { key: null, data: null, error: null, loading: false, shown: null, bound: false };
+// A malformed escape in a pasted link (`#explorer/tx/%E0`) made decodeURIComponent throw inside the
+// render, and the explorer stopped drawing for that tab (audit 2026-09-16, I1). Such a link is a
+// route to the explorer's home, not an exception.
+const decodePart = (x) => { try { return decodeURIComponent(x); } catch { return null; } };
 export function parseRoute(r) {
-  const [kind, id, page] = String(r ?? '').split('/').filter((x) => x !== '').map((x) => decodeURIComponent(x));
+  const parts = String(r ?? '').split('/').filter((x) => x !== '').map(decodePart);
+  if (parts.includes(null)) return { kind: 'home' };
+  const [kind, id, page] = parts;
   if ((kind === 'block' || kind === 'address') && id) return { kind, id, page: Math.max(0, Math.floor(Number(page) || 0)) };
   if (kind === 'tx' && id) return { kind, id };
   return { kind: 'home' };