codebase-onboarder 0.6.0 → 1.0.0

package/public/js/blameView.js

@@ -1,41 +1,40 @@
 export function initBlameView(container) {
-  return function renderBlame(blameData, options = {}) {
-    if (!blameData || !blameData.lines) {
-      container.hidden = true;
-      return;
-    }
-    container.hidden = false;
-    container.innerHTML = '';
-    
-    // Hash author to color
-    function getAuthorColor(author) {
-      let hash = 0;
-      for (let i = 0; i < author.length; i++) hash = author.charCodeAt(i) + ((hash << 5) - hash);
-      return `hsl(${Math.abs(hash) % 360}, 60%, 50%)`;
-    }
-
-    blameData.lines.forEach(line => {
-      const div = document.createElement('div');
-      div.className = 'blame-line';
-      div.style.backgroundColor = getAuthorColor(line.author || 'Unknown');
-      
-      const tooltip = document.createElement('div');
-      tooltip.className = 'blame-tooltip';
-      tooltip.textContent = `${line.author} - ${line.date || ''} (${(line.sha || '').substring(0, 7)})`;
-      
-      div.appendChild(tooltip);
-      container.appendChild(div);
-    });
-  };
+    return function renderBlame(blameData, options = {}) {
+        if (!blameData || !blameData.lines) {
+            container.hidden = true;
+            return;
+        }
+        container.hidden = false;
+        container.innerHTML = '';
+        // Hash author to color
+        function getAuthorColor(author) {
+            let hash = 0;
+            for (let i = 0; i < author.length; i++)
+                hash = author.charCodeAt(i) + ((hash << 5) - hash);
+            return `hsl(${Math.abs(hash) % 360}, 60%, 50%)`;
+        }
+        blameData.lines.forEach(line => {
+            const div = document.createElement('div');
+            div.className = 'blame-line';
+            div.style.backgroundColor = getAuthorColor(line.author || 'Unknown');
+            const tooltip = document.createElement('div');
+            tooltip.className = 'blame-tooltip';
+            tooltip.textContent = `${line.author} - ${line.date || ''} (${(line.sha || '').substring(0, 7)})`;
+            div.appendChild(tooltip);
+            container.appendChild(div);
+        });
+    };
 }
-
 export async function fetchBlame(scanId, path) {
-  try {
-    const res = await fetch(`/api/blame?scan=${encodeURIComponent(scanId)}&path=${encodeURIComponent(path)}`);
-    if (!res.ok) return null;
-    return await res.json();
-  } catch (err) {
-    console.error('Failed to fetch blame:', err);
-    return null;
-  }
+    try {
+        const res = await fetch(`/api/blame?scan=${encodeURIComponent(scanId)}&path=${encodeURIComponent(path)}`);
+        if (!res.ok)
+            return null;
+        return await res.json();
+    }
+    catch (err) {
+        console.error('Failed to fetch blame:', err);
+        return null;
+    }
 }
+//# sourceMappingURL=blameView.js.map

package/public/js/blameView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blameView.js","sourceRoot":"","sources":["../../src/public/js/blameView.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,SAAS;IACrC,OAAO,SAAS,WAAW,CAAC,SAAS,EAAE,OAAO,GAAwB,EAAE;QACtE,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YACnC,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC;YACxB,OAAO;QACT,CAAC;QACD,SAAS,CAAC,MAAM,GAAG,KAAK,CAAC;QACzB,SAAS,CAAC,SAAS,GAAG,EAAE,CAAC;QAEzB,uBAAuB;QACvB,SAAS,cAAc,CAAC,MAAM;YAC5B,IAAI,IAAI,GAAG,CAAC,CAAC;YACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE;gBAAE,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YAC3F,OAAO,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,aAAa,CAAC;QAClD,CAAC;QAED,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YAC7B,MAAM,GAAG,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAC1C,GAAG,CAAC,SAAS,GAAG,YAAY,CAAC;YAC7B,GAAG,CAAC,KAAK,CAAC,eAAe,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC;YAErE,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAC9C,OAAO,CAAC,SAAS,GAAG,eAAe,CAAC;YACpC,OAAO,CAAC,WAAW,GAAG,GAAG,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,IAAI,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC;YAElG,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACzB,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAM,EAAE,IAAI;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,mBAAmB,kBAAkB,CAAC,MAAM,CAAC,SAAS,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1G,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACzB,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC","sourcesContent":["export function initBlameView(container) {\n  return function renderBlame(blameData, options: Record<string, any> = {}) {\n    if (!blameData || !blameData.lines) {\n      container.hidden = true;\n      return;\n    }\n    container.hidden = false;\n    container.innerHTML = '';\n    \n    // Hash author to color\n    function getAuthorColor(author) {\n      let hash = 0;\n      for (let i = 0; i < author.length; i++) hash = author.charCodeAt(i) + ((hash << 5) - hash);\n      return `hsl(${Math.abs(hash) % 360}, 60%, 50%)`;\n    }\n\n    blameData.lines.forEach(line => {\n      const div = document.createElement('div');\n      div.className = 'blame-line';\n      div.style.backgroundColor = getAuthorColor(line.author || 'Unknown');\n      \n      const tooltip = document.createElement('div');\n      tooltip.className = 'blame-tooltip';\n      tooltip.textContent = `${line.author} - ${line.date || ''} (${(line.sha || '').substring(0, 7)})`;\n      \n      div.appendChild(tooltip);\n      container.appendChild(div);\n    });\n  };\n}\n\nexport async function fetchBlame(scanId, path) {\n  try {\n    const res = await fetch(`/api/blame?scan=${encodeURIComponent(scanId)}&path=${encodeURIComponent(path)}`);\n    if (!res.ok) return null;\n    return await res.json();\n  } catch (err) {\n    console.error('Failed to fetch blame:', err);\n    return null;\n  }\n}\n"]}

package/public/js/codeTab.d.ts

@@ -0,0 +1,3 @@
+export declare function revealLineInCode(line: any): void;
+export declare function initCodeTab(options: any): void;
+export declare function renderCode(): Promise<void>;

package/public/js/codeTab.js

@@ -8,210 +8,205 @@
 //
 // The back/forward stack and the "which file should I show" decision live in
 // state.js, where they are pure and tested. What is left here is DOM.
-
 import { roleOf } from '/shared/analyzer/graph.js';
 import { escapeHtml } from './html.js';
 import { highlightCode, langOf } from './highlight.js';
 import { initViewer, showInViewer, monacoLangOf, revealLineInViewer } from './codeViewer.js';
 import { fetchBlame, initBlameView } from './blameView.js';
-import {
-  state, focusFile, defaultCodePath, pushCodeHistory, codeHistoryTarget,
-} from './state.js';
+import { state, focusFile, defaultCodePath, pushCodeHistory, codeHistoryTarget, } from './state.js';
 import { readRepoFile } from './repoFiles.js';
-
 const MAX_FALLBACK_LINES = 3000;
-
 let host = null;
 let renderBlameGutter = null;
 let hooks = {
-  onSyncInspector: () => {},
-  onRenderSidebar: () => {},
-  onOpenFile: () => {},
-  onToast: () => {},
-  getTheme: () => 'light',
-  blameGutter: null,
+    onDeepDive: (_path) => { },
+    onSyncInspector: (..._args) => { },
+    onRenderSidebar: (..._args) => { },
+    onOpenFile: (..._args) => { },
+    onToast: (..._args) => { },
+    getTheme: () => 'light',
+    blameGutter: null,
 };
-
-let codeSeq = 0;          // render generations — a slow read never overwrites a newer one
+let codeSeq = 0; // render generations — a slow read never overwrites a newer one
 let viewerFailed = false; // Monaco failed to load → hand-rolled fallback
 let pendingReveal = null; // a line a search result asked for, waiting for its file
-
 // A search result knows which line it matched. The reveal has to wait until the
 // text is on screen, and it must not leak onto the *next* file you open — which
 // is why it is taken once, at the top of `renderCode`, rather than living in
 // `state` where it would outlive the file it was meant for.
 export function revealLineInCode(line) {
-  const target = Math.floor(Number(line));
-  pendingReveal = Number.isFinite(target) && target > 0 ? target : null;
+    const target = Math.floor(Number(line));
+    pendingReveal = Number.isFinite(target) && target > 0 ? target : null;
 }
-
 // Monaco is the real answer; without it, the fallback is a single scrolling
 // `<pre>`, so the best we can do is put the line near the top. Approximate, and
 // honest about being approximate — the file is still the right file.
 function applyReveal(alt, line) {
-  if (!line) return;
-  if (!viewerFailed) {
-    revealLineInViewer(line);
-    return;
-  }
-  const shell = alt.querySelector('.code-shell');
-  if (!shell) return;
-  const gutter = shell.querySelector('.code-gutter');
-  const total = gutter ? (gutter.textContent || '').split('\n').length : 0;
-  if (!total) return;
-  const perLine = shell.scrollHeight / total;
-  shell.scrollTop = Math.max(0, (line - 2) * perLine);
+    if (!line)
+        return;
+    if (!viewerFailed) {
+        revealLineInViewer(line);
+        return;
+    }
+    const shell = alt.querySelector('.code-shell');
+    if (!shell)
+        return;
+    const gutter = shell.querySelector('.code-gutter');
+    const total = gutter ? (gutter.textContent || '').split('\n').length : 0;
+    if (!total)
+        return;
+    const perLine = shell.scrollHeight / total;
+    shell.scrollTop = Math.max(0, (line - 2) * perLine);
 }
-
 export function initCodeTab(options) {
-  host = options.host;
-  hooks = { ...hooks, ...options };
-  if (options.blameGutter) {
-    renderBlameGutter = initBlameView(options.blameGutter);
-  }
-
-  host.addEventListener('click', (event) => {
-    const b = event.target.closest('button');
-    if (!b) return;
-    if (b.dataset.codeopen) return openCodeFile(b.dataset.codeopen);
-    if (b.dataset.codenav) return codeNav(Number(b.dataset.codenav));
-    if (b.dataset.codedive !== undefined) return (hooks.onDeepDive || hooks.onOpenFile)(state.code.path); // empty attribute is falsy — test undefined
-    if (b.dataset.codeblame !== undefined) {
-      if (!hooks.blameGutter) return;
-      if (!hooks.blameGutter.hidden) {
-        hooks.blameGutter.hidden = true;
-        b.classList.remove('is-active');
-      } else {
-        hooks.onToast('Fetching git blame...');
-        fetchBlame(state.scanId, state.code.path).then((data) => {
-          if (data && data.lines && data.lines.length) {
-            renderBlameGutter(data);
-            hooks.blameGutter.hidden = false;
-            b.classList.add('is-active');
-            hooks.onToast(`Blame loaded for ${data.lines.length} lines`);
-          } else {
-            hooks.onToast(data?.reason || 'No blame available for this file.');
-          }
-        });
-      }
-      return;
-    }
-    if (b.dataset.codecopy !== undefined) {
-      const text = state.code.cache[state.code.path];
-      if (text !== undefined) {
-        navigator.clipboard.writeText(text)
-          .then(() => hooks.onToast('Copied to the clipboard.'))
-          .catch(() => hooks.onToast('Could not copy to the clipboard.'));
-      }
+    host = options.host;
+    hooks = { ...hooks, ...options };
+    if (options.blameGutter) {
+        renderBlameGutter = initBlameView(options.blameGutter);
     }
-  });
+    host.addEventListener('click', (event) => {
+        const b = event.target.closest('button');
+        if (!b)
+            return;
+        if (b.dataset.codeopen)
+            return openCodeFile(b.dataset.codeopen);
+        if (b.dataset.codenav)
+            return codeNav(Number(b.dataset.codenav));
+        if (b.dataset.codedive !== undefined)
+            return (hooks.onDeepDive || hooks.onOpenFile)(state.code.path); // empty attribute is falsy — test undefined
+        if (b.dataset.codeblame !== undefined) {
+            if (!hooks.blameGutter)
+                return;
+            if (!hooks.blameGutter.hidden) {
+                hooks.blameGutter.hidden = true;
+                b.classList.remove('is-active');
+            }
+            else {
+                hooks.onToast('Fetching git blame...');
+                fetchBlame(state.scanId, state.code.path).then((data) => {
+                    if (data && data.lines && data.lines.length) {
+                        renderBlameGutter(data);
+                        hooks.blameGutter.hidden = false;
+                        b.classList.add('is-active');
+                        hooks.onToast(`Blame loaded for ${data.lines.length} lines`);
+                    }
+                    else {
+                        hooks.onToast(data?.reason || 'No blame available for this file.');
+                    }
+                });
+            }
+            return;
+        }
+        if (b.dataset.codecopy !== undefined) {
+            const text = state.code.cache[state.code.path];
+            if (text !== undefined) {
+                navigator.clipboard.writeText(text)
+                    .then(() => hooks.onToast('Copied to the clipboard.'))
+                    .catch(() => hooks.onToast('Could not copy to the clipboard.'));
+            }
+        }
+    });
 }
-
 // In-tab navigation (the import chips) keeps the sidebar and inspector in step,
 // so the rest of the app follows along rather than pointing at the old file.
 function openCodeFile(path) {
-  state.code.path = path;
-  focusFile(path);
-  hooks.onSyncInspector();
-  hooks.onRenderSidebar();
-  renderCode();
+    state.code.path = path;
+    focusFile(path);
+    hooks.onSyncInspector();
+    hooks.onRenderSidebar();
+    renderCode();
 }
-
 function codeNav(delta) {
-  const path = codeHistoryTarget(delta);
-  if (path) openCodeFile(path);
+    const path = codeHistoryTarget(delta);
+    if (path)
+        openCodeFile(path);
 }
-
 export async function renderCode() {
-  const seq = ++codeSeq;
-  const path = defaultCodePath();
-  // Taken once and cleared, so a reveal belongs only to the render that followed
-  // the request for it — never to the next file you happen to open.
-  const revealLine = pendingReveal;
-  pendingReveal = null;
-  if (!path) {
-    host.innerHTML = '<div class="code-empty">Nothing to preview — this repo has no readable files.</div>';
-    return;
-  }
-  state.code.path = path;
-  pushCodeHistory(path);
-
-  // The shell is built once: the Monaco container must persist across file
-  // switches, or the editor instance would be destroyed on every render.
-  if (!host.querySelector('.code-page')) {
-    host.innerHTML = `<div class="code-page">
+    const seq = ++codeSeq;
+    const path = defaultCodePath();
+    // Taken once and cleared, so a reveal belongs only to the render that followed
+    // the request for it — never to the next file you happen to open.
+    const revealLine = pendingReveal;
+    pendingReveal = null;
+    if (!path) {
+        host.innerHTML = '<div class="code-empty">Nothing to preview — this repo has no readable files.</div>';
+        return;
+    }
+    state.code.path = path;
+    pushCodeHistory(path);
+    // The shell is built once: the Monaco container must persist across file
+    // switches, or the editor instance would be destroyed on every render.
+    if (!host.querySelector('.code-page')) {
+        host.innerHTML = `<div class="code-page">
       <div class="code-head" id="codeHead"></div>
       <div id="codeLinks"></div>
       <div class="code-monaco" id="codeMonaco" hidden></div>
       <div id="codeAlt"></div>
     </div>`;
-  }
-  const headEl = host.querySelector('#codeHead');
-  const linksEl = host.querySelector('#codeLinks');
-  const monacoEl = host.querySelector('#codeMonaco');
-  const alt = host.querySelector('#codeAlt');
-
-  let text = state.code.cache[path];
-  if (text === undefined) {
-    monacoEl.hidden = true;
-    alt.innerHTML = '<div class="code-empty">Reading ' + escapeHtml(path) + '…</div>';
-    try {
-      text = await readRepoFile(path);
-    } catch (err) {
-      if (seq !== codeSeq) return;
-      alt.innerHTML = '<div class="code-empty">Could not read that file: ' + escapeHtml(err.message) + '</div>';
-      return;
     }
-    if (seq !== codeSeq) return;
-    state.code.cache[path] = text;
-  }
-
-  const { facts } = state;
-  const parsed = facts.fanIn[path] !== undefined;
-  const name = path.split('/').pop();
-  const ext = (name.match(/\.([A-Za-z0-9]+)$/) || [, ''])[1].toLowerCase();
-  const isBinary = text.slice(0, 8000).includes('\0');
-
-  renderHead(headEl, { path, name, ext, text, parsed, isBinary });
-  linksEl.innerHTML = parsed ? importChips(path) : '';
-
-  if (isBinary) {
-    monacoEl.hidden = true;
-    alt.innerHTML = '<div class="code-empty">Binary file — nothing to preview.</div>';
-    return;
-  }
-
-  // Monaco first; the hand-rolled highlighter stands by if it can't load.
-  if (!viewerFailed) {
-    monacoEl.hidden = false;
-    const ok = await initViewer(monacoEl, hooks.getTheme());
-    if (seq !== codeSeq) return;
-    if (ok) {
-      alt.innerHTML = '';
-      showInViewer(text, monacoLangOf(path), hooks.getTheme());
-      applyReveal(alt, revealLine);
-      return;
+    const headEl = host.querySelector('#codeHead');
+    const linksEl = host.querySelector('#codeLinks');
+    const monacoEl = host.querySelector('#codeMonaco');
+    const alt = host.querySelector('#codeAlt');
+    let text = state.code.cache[path];
+    if (text === undefined) {
+        monacoEl.hidden = true;
+        alt.innerHTML = '<div class="code-empty">Reading ' + escapeHtml(path) + '…</div>';
+        try {
+            text = await readRepoFile(path);
+        }
+        catch (err) {
+            if (seq !== codeSeq)
+                return;
+            alt.innerHTML = '<div class="code-empty">Could not read that file: ' + escapeHtml(err.message) + '</div>';
+            return;
+        }
+        if (seq !== codeSeq)
+            return;
+        state.code.cache[path] = text;
+    }
+    const { facts } = state;
+    const parsed = facts.fanIn[path] !== undefined;
+    const name = path.split('/').pop();
+    const ext = (name.match(/\.([A-Za-z0-9]+)$/) || [, ''])[1].toLowerCase();
+    const isBinary = text.slice(0, 8000).includes('\0');
+    renderHead(headEl, { path, name, ext, text, parsed, isBinary });
+    linksEl.innerHTML = parsed ? importChips(path) : '';
+    if (isBinary) {
+        monacoEl.hidden = true;
+        alt.innerHTML = '<div class="code-empty">Binary file — nothing to preview.</div>';
+        return;
+    }
+    // Monaco first; the hand-rolled highlighter stands by if it can't load.
+    if (!viewerFailed) {
+        monacoEl.hidden = false;
+        const ok = await initViewer(monacoEl, hooks.getTheme());
+        if (seq !== codeSeq)
+            return;
+        if (ok) {
+            alt.innerHTML = '';
+            showInViewer(text, monacoLangOf(path), hooks.getTheme());
+            applyReveal(alt, revealLine);
+            return;
+        }
+        viewerFailed = true;
+        monacoEl.hidden = true;
     }
-    viewerFailed = true;
-    monacoEl.hidden = true;
-  }
-  renderFallback(alt, text, path);
-  applyReveal(alt, revealLine);
+    renderFallback(alt, text, path);
+    applyReveal(alt, revealLine);
 }
-
 // Navigation, identity, actions.
 function renderHead(headEl, { path, name, ext, text, parsed, isBinary }) {
-  const { facts } = state;
-  const canBack = state.code.idx > 0;
-  const canFwd = state.code.idx < state.code.history.length - 1;
-  const meta = [
-    (ext || 'text').toUpperCase(),
-    `${text.split('\n').length.toLocaleString()} lines`,
-    `${(new Blob([text]).size / 1024).toFixed(1)} KB`,
-    parsed ? `${roleOf(path, facts)} · ${facts.fanIn[path]} dependents · pulls in ${facts.fanOut[path]}` : 'not parsed',
-  ].join(' · ');
-
-  headEl.innerHTML = `
+    const { facts } = state;
+    const canBack = state.code.idx > 0;
+    const canFwd = state.code.idx < state.code.history.length - 1;
+    const meta = [
+        (ext || 'text').toUpperCase(),
+        `${text.split('\n').length.toLocaleString()} lines`,
+        `${(new Blob([text]).size / 1024).toFixed(1)} KB`,
+        parsed ? `${roleOf(path, facts)} · ${facts.fanIn[path]} dependents · pulls in ${facts.fanOut[path]}` : 'not parsed',
+    ].join(' · ');
+    headEl.innerHTML = `
     <div class="code-nav">
       <button class="code-navbtn" data-codenav="-1" ${canBack ? '' : 'disabled'} title="Previous file">←</button>
       <button class="code-navbtn" data-codenav="1" ${canFwd ? '' : 'disabled'} title="Next file">→</button>
@@ -227,30 +222,30 @@ function renderHead(headEl, { path, name, ext, text, parsed, isBinary }) {
       <button class="code-navbtn" data-codedive>Deep-dive →</button>
     </div>`;
 }
-
 // The file's neighbours, both directions, as one-click jumps.
 function importChips(path) {
-  const { facts } = state;
-  const chip = (p) => `<button class="code-chip" data-codeopen="${escapeHtml(p)}" title="${escapeHtml(p)}">${escapeHtml(p.split('/').pop())}</button>`;
-  const pulls = (facts.importsOf[path] || []).map(chip).join('');
-  const leans = (facts.importers[path] || []).map(chip).join('');
-  if (!pulls && !leans) return '';
-  return '<div class="code-links">'
-    + (pulls ? `<span class="code-links-label">pulls in</span>${pulls}` : '')
-    + (leans ? `<span class="code-links-label">leaned on by</span>${leans}` : '')
-    + '</div>';
+    const { facts } = state;
+    const chip = (p) => `<button class="code-chip" data-codeopen="${escapeHtml(p)}" title="${escapeHtml(p)}">${escapeHtml(p.split('/').pop())}</button>`;
+    const pulls = (facts.importsOf[path] || []).map(chip).join('');
+    const leans = (facts.importers[path] || []).map(chip).join('');
+    if (!pulls && !leans)
+        return '';
+    return '<div class="code-links">'
+        + (pulls ? `<span class="code-links-label">pulls in</span>${pulls}` : '')
+        + (leans ? `<span class="code-links-label">leaned on by</span>${leans}` : '')
+        + '</div>';
 }
-
 // Without Monaco: a gutter, a highlighted body, and a cap, because pasting a
 // 40,000-line bundle into innerHTML locks the tab.
 function renderFallback(alt, text, path) {
-  const all = text.split('\n');
-  const capped = all.length > MAX_FALLBACK_LINES;
-  const lines = capped ? all.slice(0, MAX_FALLBACK_LINES) : all;
-  const gutter = lines.map((_, i) => i + 1).join('\n');
-  const note = capped
-    ? `<div class="code-note">Showing the first ${MAX_FALLBACK_LINES.toLocaleString()} of ${all.length.toLocaleString()} lines.</div>`
-    : '';
-  alt.innerHTML = `${note}<div class="code-shell"><pre class="code-gutter">${gutter}</pre>`
-    + `<pre class="code-body"><code>${highlightCode(lines.join('\n'), langOf(path))}</code></pre></div>`;
+    const all = text.split('\n');
+    const capped = all.length > MAX_FALLBACK_LINES;
+    const lines = capped ? all.slice(0, MAX_FALLBACK_LINES) : all;
+    const gutter = lines.map((_, i) => i + 1).join('\n');
+    const note = capped
+        ? `<div class="code-note">Showing the first ${MAX_FALLBACK_LINES.toLocaleString()} of ${all.length.toLocaleString()} lines.</div>`
+        : '';
+    alt.innerHTML = `${note}<div class="code-shell"><pre class="code-gutter">${gutter}</pre>`
+        + `<pre class="code-body"><code>${highlightCode(lines.join('\n'), langOf(path))}</code></pre></div>`;
 }
+//# sourceMappingURL=codeTab.js.map

package/public/js/codeTab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeTab.js","sourceRoot":"","sources":["../../src/public/js/codeTab.ts"],"names":[],"mappings":"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","sourcesContent":["// The Code tab: one file at a time, with its imports as chips you can click.\n//\n// Two viewers, one behind the other. Monaco is loaded from the app's own\n// `vendor/` folder and used if it comes up; if it does not, a hand-rolled\n// highlighter takes over for the rest of the session. Neither is required for\n// the page to be useful — the header, the facts and the import chips are drawn\n// from the graph before any file text arrives.\n//\n// The back/forward stack and the \"which file should I show\" decision live in\n// state.js, where they are pure and tested. What is left here is DOM.\n\nimport { roleOf } from '/shared/analyzer/graph.js';\nimport { escapeHtml } from './html.js';\nimport { highlightCode, langOf } from './highlight.js';\nimport { initViewer, showInViewer, monacoLangOf, revealLineInViewer } from './codeViewer.js';\nimport { fetchBlame, initBlameView } from './blameView.js';\nimport {\n  state, focusFile, defaultCodePath, pushCodeHistory, codeHistoryTarget,\n} from './state.js';\nimport { readRepoFile } from './repoFiles.js';\n\nconst MAX_FALLBACK_LINES = 3000;\n\nlet host = null;\nlet renderBlameGutter = null;\nlet hooks = {\n  onDeepDive: (_path: string) => {},\n  onSyncInspector: (..._args: unknown[]) => {},\n  onRenderSidebar: (..._args: unknown[]) => {},\n  onOpenFile: (..._args: unknown[]) => {},\n  onToast: (..._args: unknown[]) => {},\n  getTheme: () => 'light',\n  blameGutter: null,\n};\n\nlet codeSeq = 0;          // render generations — a slow read never overwrites a newer one\nlet viewerFailed = false; // Monaco failed to load → hand-rolled fallback\nlet pendingReveal = null; // a line a search result asked for, waiting for its file\n\n// A search result knows which line it matched. The reveal has to wait until the\n// text is on screen, and it must not leak onto the *next* file you open — which\n// is why it is taken once, at the top of `renderCode`, rather than living in\n// `state` where it would outlive the file it was meant for.\nexport function revealLineInCode(line) {\n  const target = Math.floor(Number(line));\n  pendingReveal = Number.isFinite(target) && target > 0 ? target : null;\n}\n\n// Monaco is the real answer; without it, the fallback is a single scrolling\n// `<pre>`, so the best we can do is put the line near the top. Approximate, and\n// honest about being approximate — the file is still the right file.\nfunction applyReveal(alt, line) {\n  if (!line) return;\n  if (!viewerFailed) {\n    revealLineInViewer(line);\n    return;\n  }\n  const shell = alt.querySelector('.code-shell');\n  if (!shell) return;\n  const gutter = shell.querySelector('.code-gutter');\n  const total = gutter ? (gutter.textContent || '').split('\\n').length : 0;\n  if (!total) return;\n  const perLine = shell.scrollHeight / total;\n  shell.scrollTop = Math.max(0, (line - 2) * perLine);\n}\n\nexport function initCodeTab(options) {\n  host = options.host;\n  hooks = { ...hooks, ...options };\n  if (options.blameGutter) {\n    renderBlameGutter = initBlameView(options.blameGutter);\n  }\n\n  host.addEventListener('click', (event) => {\n    const b = event.target.closest('button');\n    if (!b) return;\n    if (b.dataset.codeopen) return openCodeFile(b.dataset.codeopen);\n    if (b.dataset.codenav) return codeNav(Number(b.dataset.codenav));\n    if (b.dataset.codedive !== undefined) return (hooks.onDeepDive || hooks.onOpenFile)(state.code.path); // empty attribute is falsy — test undefined\n    if (b.dataset.codeblame !== undefined) {\n      if (!hooks.blameGutter) return;\n      if (!hooks.blameGutter.hidden) {\n        hooks.blameGutter.hidden = true;\n        b.classList.remove('is-active');\n      } else {\n        hooks.onToast('Fetching git blame...');\n        fetchBlame(state.scanId, state.code.path).then((data) => {\n          if (data && data.lines && data.lines.length) {\n            renderBlameGutter(data);\n            hooks.blameGutter.hidden = false;\n            b.classList.add('is-active');\n            hooks.onToast(`Blame loaded for ${data.lines.length} lines`);\n          } else {\n            hooks.onToast(data?.reason || 'No blame available for this file.');\n          }\n        });\n      }\n      return;\n    }\n    if (b.dataset.codecopy !== undefined) {\n      const text = state.code.cache[state.code.path];\n      if (text !== undefined) {\n        navigator.clipboard.writeText(text)\n          .then(() => hooks.onToast('Copied to the clipboard.'))\n          .catch(() => hooks.onToast('Could not copy to the clipboard.'));\n      }\n    }\n  });\n}\n\n// In-tab navigation (the import chips) keeps the sidebar and inspector in step,\n// so the rest of the app follows along rather than pointing at the old file.\nfunction openCodeFile(path) {\n  state.code.path = path;\n  focusFile(path);\n  hooks.onSyncInspector();\n  hooks.onRenderSidebar();\n  renderCode();\n}\n\nfunction codeNav(delta) {\n  const path = codeHistoryTarget(delta);\n  if (path) openCodeFile(path);\n}\n\nexport async function renderCode() {\n  const seq = ++codeSeq;\n  const path = defaultCodePath();\n  // Taken once and cleared, so a reveal belongs only to the render that followed\n  // the request for it — never to the next file you happen to open.\n  const revealLine = pendingReveal;\n  pendingReveal = null;\n  if (!path) {\n    host.innerHTML = '<div class=\"code-empty\">Nothing to preview — this repo has no readable files.</div>';\n    return;\n  }\n  state.code.path = path;\n  pushCodeHistory(path);\n\n  // The shell is built once: the Monaco container must persist across file\n  // switches, or the editor instance would be destroyed on every render.\n  if (!host.querySelector('.code-page')) {\n    host.innerHTML = `<div class=\"code-page\">\n      <div class=\"code-head\" id=\"codeHead\"></div>\n      <div id=\"codeLinks\"></div>\n      <div class=\"code-monaco\" id=\"codeMonaco\" hidden></div>\n      <div id=\"codeAlt\"></div>\n    </div>`;\n  }\n  const headEl = host.querySelector('#codeHead');\n  const linksEl = host.querySelector('#codeLinks');\n  const monacoEl = host.querySelector('#codeMonaco');\n  const alt = host.querySelector('#codeAlt');\n\n  let text = state.code.cache[path];\n  if (text === undefined) {\n    monacoEl.hidden = true;\n    alt.innerHTML = '<div class=\"code-empty\">Reading ' + escapeHtml(path) + '…</div>';\n    try {\n      text = await readRepoFile(path);\n    } catch (err) {\n      if (seq !== codeSeq) return;\n      alt.innerHTML = '<div class=\"code-empty\">Could not read that file: ' + escapeHtml(err.message) + '</div>';\n      return;\n    }\n    if (seq !== codeSeq) return;\n    state.code.cache[path] = text;\n  }\n\n  const { facts } = state;\n  const parsed = facts.fanIn[path] !== undefined;\n  const name = path.split('/').pop();\n  const ext = (name.match(/\\.([A-Za-z0-9]+)$/) || [, ''])[1].toLowerCase();\n  const isBinary = text.slice(0, 8000).includes('\\0');\n\n  renderHead(headEl, { path, name, ext, text, parsed, isBinary });\n  linksEl.innerHTML = parsed ? importChips(path) : '';\n\n  if (isBinary) {\n    monacoEl.hidden = true;\n    alt.innerHTML = '<div class=\"code-empty\">Binary file — nothing to preview.</div>';\n    return;\n  }\n\n  // Monaco first; the hand-rolled highlighter stands by if it can't load.\n  if (!viewerFailed) {\n    monacoEl.hidden = false;\n    const ok = await initViewer(monacoEl, hooks.getTheme());\n    if (seq !== codeSeq) return;\n    if (ok) {\n      alt.innerHTML = '';\n      showInViewer(text, monacoLangOf(path), hooks.getTheme());\n      applyReveal(alt, revealLine);\n      return;\n    }\n    viewerFailed = true;\n    monacoEl.hidden = true;\n  }\n  renderFallback(alt, text, path);\n  applyReveal(alt, revealLine);\n}\n\n// Navigation, identity, actions.\nfunction renderHead(headEl, { path, name, ext, text, parsed, isBinary }) {\n  const { facts } = state;\n  const canBack = state.code.idx > 0;\n  const canFwd = state.code.idx < state.code.history.length - 1;\n  const meta = [\n    (ext || 'text').toUpperCase(),\n    `${text.split('\\n').length.toLocaleString()} lines`,\n    `${(new Blob([text]).size / 1024).toFixed(1)} KB`,\n    parsed ? `${roleOf(path, facts)} · ${facts.fanIn[path]} dependents · pulls in ${facts.fanOut[path]}` : 'not parsed',\n  ].join(' · ');\n\n  headEl.innerHTML = `\n    <div class=\"code-nav\">\n      <button class=\"code-navbtn\" data-codenav=\"-1\" ${canBack ? '' : 'disabled'} title=\"Previous file\">←</button>\n      <button class=\"code-navbtn\" data-codenav=\"1\" ${canFwd ? '' : 'disabled'} title=\"Next file\">→</button>\n    </div>\n    <div class=\"code-title\">\n      <h2>${escapeHtml(name)}</h2>\n      <div class=\"code-path\">${escapeHtml(path)}</div>\n      <div class=\"code-meta\">${escapeHtml(meta)}</div>\n    </div>\n    <div class=\"code-actions\">\n      <button class=\"code-navbtn\" data-codeblame ${isBinary ? 'disabled' : ''} title=\"Toggle Git blame annotations\">Blame</button>\n      <button class=\"code-navbtn\" data-codecopy ${isBinary ? 'disabled' : ''}>Copy</button>\n      <button class=\"code-navbtn\" data-codedive>Deep-dive →</button>\n    </div>`;\n}\n\n// The file's neighbours, both directions, as one-click jumps.\nfunction importChips(path) {\n  const { facts } = state;\n  const chip = (p) => `<button class=\"code-chip\" data-codeopen=\"${escapeHtml(p)}\" title=\"${escapeHtml(p)}\">${escapeHtml(p.split('/').pop())}</button>`;\n  const pulls = (facts.importsOf[path] || []).map(chip).join('');\n  const leans = (facts.importers[path] || []).map(chip).join('');\n  if (!pulls && !leans) return '';\n  return '<div class=\"code-links\">'\n    + (pulls ? `<span class=\"code-links-label\">pulls in</span>${pulls}` : '')\n    + (leans ? `<span class=\"code-links-label\">leaned on by</span>${leans}` : '')\n    + '</div>';\n}\n\n// Without Monaco: a gutter, a highlighted body, and a cap, because pasting a\n// 40,000-line bundle into innerHTML locks the tab.\nfunction renderFallback(alt, text, path) {\n  const all = text.split('\\n');\n  const capped = all.length > MAX_FALLBACK_LINES;\n  const lines = capped ? all.slice(0, MAX_FALLBACK_LINES) : all;\n  const gutter = lines.map((_, i) => i + 1).join('\\n');\n  const note = capped\n    ? `<div class=\"code-note\">Showing the first ${MAX_FALLBACK_LINES.toLocaleString()} of ${all.length.toLocaleString()} lines.</div>`\n    : '';\n  alt.innerHTML = `${note}<div class=\"code-shell\"><pre class=\"code-gutter\">${gutter}</pre>`\n    + `<pre class=\"code-body\"><code>${highlightCode(lines.join('\\n'), langOf(path))}</code></pre></div>`;\n}\n"]}

package/public/js/codeViewer.d.ts

@@ -0,0 +1,5 @@
+export declare function monacoLangOf(path: string): string;
+export declare function initViewer(container: HTMLElement, theme: string): Promise<boolean>;
+export declare function showInViewer(text: string, lang: string, theme: string): void;
+export declare function setViewerTheme(theme: string): void;
+export declare function revealLineInViewer(line: unknown): void;