synabun 2.0.10 → 2.1.0

package/neural-interface/public/variant/2d/main.js

@@ -1,4 +1,5 @@
 // ═══════════════════════════════════════════
+// DEPRECATED: 2D memory map retained for compatibility; no supported page boots this entry point.
 // SynaBun Neural Interface — 2D Variant Entry Point
 // ═══════════════════════════════════════════
 //
@@ -24,7 +25,7 @@ import { initPanelSystem, initPinToggle, clampPanelsToViewport } from '../../sha
 import { initLoading, showLoadingError, hideLoading, rememberHealth } from '../../shared/ui-loading.js';
 import { initNavbar } from '../../shared/ui-navbar.js';
 import { initMenubar } from '../../shared/ui-menubar.js';
-import { initSearch } from '../../shared/ui-search.js';
+import { initSearch, clearSearch } from '../../shared/ui-search.js';
 import { buildCategorySidebar, initSidebar, loadCategories } from '../../shared/ui-sidebar.js';
 import { openMemoryCard, restoreOpenCards, initDetailPanel, setDetailCallbacks } from '../../shared/ui-detail.js';
 import { initSettings, restoreInterfaceConfig, restoreSkin, loadIfaceConfig } from '../../shared/ui-settings.js';
@@ -60,6 +61,7 @@ import { initAutomationStudio } from '../../shared/ui-automation-studio.js';
 import { initSchedulesStudio } from '../../shared/ui-schedules-studio.js';
 import { initNativeLoopRouter } from '../../shared/ui-native-loop-router.js';
 import { initCommandRunner } from '../../shared/ui-command-runner.js';
+import { initAppContextMenu, registerContextMenuArea } from '../../shared/ui-context-menu.js';
 import { stopBackground } from './background.js';
 import { initMinimap, drawMinimap, toggleMinimap, isMinimapVisible, forceHideMinimap, restoreMinimap } from './minimap.js';
 import { initLasso, clearLasso } from './lasso.js';
@@ -258,6 +260,34 @@ on('layout:frame', () => {
   const g = getGraph();
   if (g) g.zoomToFit(400, 60);
 });
+// The 3D map's Frame whole map key (H by default) fits the graph here: the same function as a double-click on its empty space.
+registerAction('map-frame-all', () => emit('layout:frame'));
+
+// The app's right-click menu on the graph's empty space and the minimap (a card keeps its own menu, graph.js):
+// the graph's rows, each through what the page already does (View › Minimap / Region Glow, the navbar's 3D link).
+registerContextMenuArea({
+  id: 'graph-2d',
+  match(el) {
+    if (!el?.closest?.('#canvas-main, #minimap')) return null;
+    return {
+      kind: 'map',
+      map: {
+        variant: '2d',
+        options: { minimap: isMinimapVisible(), regionGlow: gfx.regionGlowOpacity > 0 },
+        searching: !!state.searchResults,
+        selected: state.multiSelected.size > 0,
+        label: null,
+      },
+      act: {
+        frameAll: () => emit('layout:frame'),
+        toggleOption: (key) => document.getElementById(key === 'minimap' ? 'menu-minimap' : 'menu-region-glow')?.click(),
+        clearSearch: () => clearSearch(),
+        clearSelection: () => clearMultiSelect(),
+        switchView: () => document.getElementById('nav-3d-link')?.click(), // keeps the selected memory, as the navbar does
+      },
+    };
+  },
+});
 
 // Stats update
 on('stats-changed', () => {
@@ -466,6 +496,7 @@ initWhiteboard();
 initCostWidget();
 initGames();
 initTutorial();
+initAppContextMenu(); // a graph card keeps its own menu (context-menu.js); everything else gets the app's
 
 // View switch handler
 {

package/neural-interface/public/variant/2d/minimap.js

@@ -10,6 +10,7 @@ import { storage } from '../../shared/storage.js';
 import { catColor } from '../../shared/colors.js';
 import { getViewport, getAllCards, getGraph } from './graph.js';
 import { CARD_W, CARD_H } from './layout.js';
+import { clampToFrame } from '../../shared/app-frame.js';
 
 const $ = (id) => document.getElementById(id);
 
@@ -125,13 +126,15 @@ export function drawMinimap() {
     ctx.fill();
   }
 
-  // Draw viewport rectangle (offset is in buffer coords, convert CSS to buffer)
+  // Draw viewport rectangle: the main canvas's buffer (the app frame's size × DPR, the offsets' unit)
   const vp = getViewport();
   const dpr = vp.dpr || 1;
-  const vpWorldCenterX = (window.innerWidth * dpr / 2 - vp.offsetX) / vp.scale;
-  const vpWorldCenterY = (window.innerHeight * dpr / 2 - vp.offsetY) / vp.scale;
-  const vpW = window.innerWidth * dpr / vp.scale;
-  const vpH = window.innerHeight * dpr / vp.scale;
+  const bufW = vp.width || window.innerWidth * dpr;
+  const bufH = vp.height || window.innerHeight * dpr;
+  const vpWorldCenterX = (bufW / 2 - vp.offsetX) / vp.scale;
+  const vpWorldCenterY = (bufH / 2 - vp.offsetY) / vp.scale;
+  const vpW = bufW / vp.scale;
+  const vpH = bufH / vp.scale;
   const vpX = (vpWorldCenterX - vpW / 2 - minX) * scale + offsetX;
   const vpY = (vpWorldCenterY - vpH / 2 - minY) * scale + offsetY;
   ctx.strokeStyle = 'rgba(255,255,255,0.5)';
@@ -210,14 +213,10 @@ function _onDragMove(e) {
   const newLeft = _dragStartLeft + dx;
   const newTop = _dragStartTop + dy;
 
-  // Clamp to viewport
-  const vw = window.innerWidth;
-  const vh = window.innerHeight;
+  // Clamp to the app frame
   const mw = _minimapEl.offsetWidth;
   const mh = _minimapEl.offsetHeight;
-
-  const clampedLeft = Math.max(0, Math.min(newLeft, vw - mw));
-  const clampedTop = Math.max(0, Math.min(newTop, vh - mh));
+  const { x: clampedLeft, y: clampedTop } = clampToFrame(newLeft, newTop, mw, mh);
 
   // Switch from right/bottom positioning to left/top for drag
   _minimapEl.style.right = 'auto';
@@ -264,8 +263,7 @@ function _restorePosition() {
 
     const mw = _minimapEl.offsetWidth;
     const mh = _minimapEl.offsetHeight;
-    const clampedLeft = Math.max(0, Math.min(left, window.innerWidth - mw));
-    const clampedTop = Math.max(0, Math.min(top, window.innerHeight - mh));
+    const { x: clampedLeft, y: clampedTop } = clampToFrame(left, top, mw, mh);
 
     _minimapEl.style.right = 'auto';
     _minimapEl.style.bottom = 'auto';

package/neural-interface/public/variant/3d/main.js

@@ -16,6 +16,7 @@ import { registerVariant, registerHelpSection } from '../../shared/registry.js';
 import { normalizeNodes } from '../../shared/utils.js';
 import { injectSharedHTML } from '../../shared/html-shell.js';
 import { KEYS } from '../../shared/constants.js';
+import { migrateViewPreferences, normalizeViewUrl } from '../../shared/view-variant.js';
 import { initI18n, t } from '../../shared/i18n.js';
 
 // ── Shared UI modules (side-effect: each registers its own event listeners) ──
@@ -24,7 +25,7 @@ import { initPanelSystem, initPinToggle, clampPanelsToViewport } from '../../sha
 import { initLoading, showLoadingError, hideLoading, rememberHealth } from '../../shared/ui-loading.js';
 import { initNavbar } from '../../shared/ui-navbar.js';
 import { initMenubar, closeMenubar } from '../../shared/ui-menubar.js';
-import { initSearch } from '../../shared/ui-search.js';
+import { initSearch, clearSearch } from '../../shared/ui-search.js';
 import { buildCategorySidebar, initSidebar, loadCategories } from '../../shared/ui-sidebar.js';
 import { openMemoryCard, restoreOpenCards, initDetailPanel, setDetailCallbacks } from '../../shared/ui-detail.js';
 import { initSettings, restoreInterfaceConfig, restoreSkin, loadIfaceConfig } from '../../shared/ui-settings.js';
@@ -55,6 +56,7 @@ import { initAutomationStudio } from '../../shared/ui-automation-studio.js';
 import { initSchedulesStudio } from '../../shared/ui-schedules-studio.js';
 import { initNativeLoopRouter } from '../../shared/ui-native-loop-router.js';
 import { initCommandRunner } from '../../shared/ui-command-runner.js';
+import { initAppContextMenu, openAppContextMenu, registerContextMenuArea } from '../../shared/ui-context-menu.js';
 
 // ── Memory map (three.js itself loads only when the map is shown) ──
 import { createLabelLayer } from './map-labels.js';
@@ -67,7 +69,14 @@ import { fetchMap, requestRebuild } from './map-data.js';
 // 1. REGISTER VARIANT
 // ═══════════════════════════════════════════
 
-registerVariant({ variant: '3d', capabilities: ['memory-map'] });
+// storage.js has hydrated before this runs. Rewrite legacy choices once, before any UI is built.
+let localPreferences;
+try { if (storage.persists !== false) localPreferences = window.localStorage; } catch {}
+registerVariant({ variant: migrateViewPreferences(storage, localPreferences), capabilities: ['memory-map'] });
+const canonicalUrl = normalizeViewUrl(window.location.href);
+if (canonicalUrl !== window.location.pathname + window.location.search + window.location.hash) {
+  window.history.replaceState(window.history.state, '', canonicalUrl);
+}
 
 
 // ═══════════════════════════════════════════
@@ -154,7 +163,7 @@ function ensureMap() {
       });
       labels.resize(renderer.size.width, renderer.size.height);
       v = createMapView({ renderer, labels, statusEl: statusPill(container), onMissingNodes: (ids) => addMissingMemories(ids) });
-      initMapControls({ renderer, view: v, labels });
+      initMapControls({ renderer, view: v, labels, onContextMenu: openMapMenu });
       view = v;
       applyRunState();
       syncMapMenuChecks();
@@ -387,7 +396,60 @@ registerAction('map-frame-all', () => view?.frameAll());
 
 
 // ═══════════════════════════════════════════
-// 8. BOOT
+// 8. CONTEXT MENU (shared/ui-context-menu.js)
+// ═══════════════════════════════════════════
+// A right-click (no drag) on the map opens the app's menu with the map's part on top: a memory, a name on the
+// map, or its empty space. The same functions as the map's clicks and Apps › Map.
+
+const mapActions = {
+  frameAll: () => view?.frameAll(),
+  toggleOption: (key) => { if (!view) return; view.setOption(key, !view.options[key]); syncMapMenuChecks(); },
+  toggleSelect: (id) => view?.toggleMulti(id),
+  flyToIsland: (name) => view?.flyToIsland(name),
+  clearSearch: () => clearSearch(),
+  clearSelection: () => view?.clearSelection(),
+};
+
+/** The map's part of the menu for what a press resolved to (map-controls.js resolve), null before the map exists. */
+function mapMenuArea(hit) {
+  if (!view?.map) return null;
+  if (hit && hit.i >= 0) {
+    const d = view.describe(hit.i);
+    if (d) {
+      const island = view.map.islands[view.map.islandOf[hit.i]]?.name || d.category;
+      return {
+        kind: 'memory',
+        memory: { id: d.id, onMap: true, island, selected: state.multiSelected.has(d.id) },
+        act: { ...mapActions, openMemory: () => view.clickPoint(hit.i) },
+      };
+    }
+  }
+  const label = hit?.label && hit.label.type !== 'memory' ? hit.label : null;
+  return {
+    kind: 'map',
+    map: { options: view.options, searching: view.searching, selected: !!view.selectedId, label, variant: '3d' },
+    act: { ...mapActions, flyToLabel: () => label && view.clickLabel(label) },
+  };
+}
+
+function openMapMenu({ clientX, clientY, hit }) {
+  openAppContextMenu({ x: clientX, y: clientY, target: renderer?.canvas || null, area: mapMenuArea(hit),
+    returnFocus: renderer?.canvas || null });
+}
+
+// From the keyboard (ContextMenu key, Shift+F10) on the focused map: the selected memory, else the map.
+registerContextMenuArea({
+  id: 'memory-map',
+  match(el) {
+    if (!renderer || el !== renderer.canvas) return null;
+    const i = view?.selectedId ? view.map?.indexOf.get(view.selectedId) : undefined;
+    return mapMenuArea(i === undefined ? null : { i, label: null });
+  },
+});
+
+
+// ═══════════════════════════════════════════
+// 9. BOOT
 // ═══════════════════════════════════════════
 
 async function boot() {
@@ -452,7 +514,7 @@ async function boot() {
     emit('data-loaded', data);
     restoreOpenCards();
 
-    // Handed over from the 2D view
+    // Recover a selected memory handed over by a legacy 2D tab
     const switchNodeId = sessionStorage.getItem('neural-selected-node-switch');
     if (switchNodeId) {
       sessionStorage.removeItem('neural-selected-node-switch');
@@ -482,7 +544,7 @@ async function boot() {
 
 
 // ═══════════════════════════════════════════
-// 9. INIT ALL SHARED UI SYSTEMS
+// 10. INIT ALL SHARED UI SYSTEMS
 // ═══════════════════════════════════════════
 
 initLoading({ onInit: boot });
@@ -522,6 +584,7 @@ initWhiteboard();
 initCostWidget();
 initGames();
 initTutorial();
+initAppContextMenu();
 wireMapMenu();
 
 window.addEventListener('resize', () => clampPanelsToViewport());

package/neural-interface/public/variant/3d/map-controls.js

@@ -2,17 +2,21 @@
 //
 // Hover → tooltip, click → open the memory, ⌘/Ctrl-click → multi-select,
 // click a label → fly to that island, double-click empty space → frame all,
-// Esc → clear the search, then the selection. Orbit / pan / zoom and the
+// Esc → clear the search, then the selection, right-click (no drag) → the
+// app's context menu for what is under the pointer. Orbit / pan / zoom and the
 // arrow keys belong to OrbitControls (arrows only while the map has focus, so
-// the app's single-key shortcuts keep working everywhere else).
+// the app's single-key shortcuts keep working everywhere else). OrbitControls
+// also cancels the browser's menu on the canvas, so a right-drag only pans:
+// the menu opens when the right button comes up where it went down.
 
 import { isGraphPointerActivity } from '../../shared/graph-activity.js';
 import { clearSearch } from '../../shared/ui-search.js';
 import { escapeHtml } from '../../shared/utils.js';
+import { frameRect } from '../../shared/app-frame.js';
 
 const CLICK_SLOP = 5; // px a press may move and still count as a click
 
-export function initMapControls({ renderer, view, labels }) {
+export function initMapControls({ renderer, view, labels, onContextMenu = null }) {
   const canvas = renderer.canvas;
   const tip = document.getElementById('tooltip');
   const tipCategory = document.getElementById('tooltip-category');
@@ -58,10 +62,12 @@ export function initMapControls({ renderer, view, labels }) {
     }
     const pad = 16;
     const w = tip.offsetWidth || 260, h = tip.offsetHeight || 80;
-    const x = Math.min(e.clientX + pad, window.innerWidth - w - 8);
-    const y = e.clientY + pad + h > window.innerHeight ? e.clientY - h - pad : e.clientY + pad;
-    tip.style.left = `${Math.max(8, x)}px`;
-    tip.style.top = `${Math.max(8, y)}px`;
+    // Inside the app frame, where the map is
+    const f = frameRect();
+    const x = Math.min(e.clientX + pad, f.right - w - 8);
+    const y = e.clientY + pad + h > f.bottom - 8 ? e.clientY - h - pad : e.clientY + pad;
+    tip.style.left = `${Math.max(f.left + 8, x)}px`;
+    tip.style.top = `${Math.max(f.top + 8, y)}px`;
     tip.classList.add('visible');
   }
 
@@ -107,8 +113,17 @@ export function initMapControls({ renderer, view, labels }) {
     const wasDown = canvasDown;
     down = null;
     canvasDown = false;
-    if (!d || !wasDown || d.button !== 0 || e.button !== 0) return;
-    if (Math.hypot(e.clientX - d.x, e.clientY - d.y) > CLICK_SLOP) return; // a drag, not a click
+    if (!d || !wasDown) return;
+    const still = Math.hypot(e.clientX - d.x, e.clientY - d.y) <= CLICK_SLOP; // else a drag, not a click
+    if (d.button === 2 && e.button === 2) {
+      if (still && onContextMenu) {
+        const [x, y] = local(e);
+        hideTip();
+        onContextMenu({ clientX: e.clientX, clientY: e.clientY, hit: resolve(x, y) });
+      }
+      return;
+    }
+    if (d.button !== 0 || e.button !== 0 || !still) return;
     const [x, y] = local(e);
     const { i, label } = resolve(x, y);
     if (i >= 0) view.clickPoint(i, { additive: e.metaKey || e.ctrlKey });

package/neural-interface/public/vendor/caveat/OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2014 The Caveat Project Authors (https://github.com/googlefonts/caveat)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/neural-interface/public/vendor/caveat/caveat.css

@@ -0,0 +1,17 @@
+/* Caveat, the handwriting of the whiteboard and the Workspace tour, served from SynaBun
+   itself (no font CDN). Latin subset, weights 400 and 700, from @fontsource/caveat 5.3.0.
+   SIL Open Font License 1.1: OFL.txt in this folder. */
+@font-face {
+  font-family: 'Caveat';
+  font-style: normal;
+  font-display: swap;
+  font-weight: 400;
+  src: url(./caveat-latin-400-normal.woff2) format('woff2');
+}
+@font-face {
+  font-family: 'Caveat';
+  font-style: normal;
+  font-display: swap;
+  font-weight: 700;
+  src: url(./caveat-latin-700-normal.woff2) format('woff2');
+}

package/neural-interface/public/vendor/caveat/manifest.json

@@ -0,0 +1,12 @@
+{
+  "name": "Caveat",
+  "version": "5.3.0",
+  "source": "@fontsource/caveat 5.3.0 (npm), files/caveat-latin-400-normal.woff2 and files/caveat-latin-700-normal.woff2",
+  "license": "OFL-1.1",
+  "licenseFile": "OFL.txt",
+  "copyright": "Copyright 2014 The Caveat Project Authors (https://github.com/googlefonts/caveat)",
+  "files": {
+    "caveat-latin-400-normal.woff2": "d0b7b931b8980049327e8f8f9ac264617c8200b8422d62e886473d3d9527bad3",
+    "caveat-latin-700-normal.woff2": "15f9638095ad5ec9816f93d66805ca1a87e71dc5a76b596bfce1c78d4704c405"
+  }
+}

package/neural-interface/public/vendor/yaml/LICENSE

@@ -0,0 +1,13 @@
+Copyright Eemeli Aro <eemeli@gmail.com>
+
+Permission to use, copy, modify, and/or distribute this software for any purpose
+with or without fee is hereby granted, provided that the above copyright notice
+and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
+OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
+THIS SOFTWARE.

package/neural-interface/public/vendor/yaml/manifest.json

@@ -0,0 +1,4 @@
+{
+  "version": "2.9.1",
+  "entry": "yaml-2.9.1.min.js"
+}