codebase-onboarder 0.5.0 → 0.7.0

package/public/js/state.js

@@ -9,149 +9,141 @@
 // place that can be tested.
 //
 // No DOM, no imports from the view layer: importable in Node.
-
 // The views that share the Explorer tab and its canvas.
 export const EXPLORER_VIEWS = ['map', 'files', 'patterns', 'health', 'security', 'history', 'services', 'tour', 'atlas'];
-
 // Views whose default inspector panel is their own, rather than the overview.
 const PANEL_VIEWS = { patterns: 'patterns', health: 'health', security: 'security', history: 'history' };
-
 // Per-repo state, rebuilt by `loadRepo`. Split out from the rest so "what has
 // to be reset when a new repo arrives" is a list in one place rather than a
 // thing you remember — forgetting an entry here is how a new repo inherits the
 // previous one's open tabs.
 function perRepo() {
-  return {
-    scan: null,
-    facts: null,
-    manifest: null,
-    stack: null,
-    health: null,
-    security: null,
-    history: null,
-    patterns: null,
-    treeData: null,
-    scanId: null,
-    cloneId: null,
-    browserSource: null,
-    view: 'map',
-    lastExplorer: 'map',
-    folder: '',
-    detail: null,        // file open in deep-dive, if any
-    selected: null,      // the focused FILE (the inspector's current subject)
-    focusedFolder: null, // the focused FOLDER subject, when it's a folder
-    tour: { stops: [], idx: 0 },
-    currentDiagram: { source: '', nodes: {} },
-    aiDiagrams: {},      // viewKey -> { body, caption } — unthemed, composed at render
-    aiActiveKey: null,   // which viewKey is currently showing its AI draft
-    docs: { rendered: false, writing: false, tabs: new Map(), active: 'overview' },
-    about: { rendered: false },
-    mm: { expanded: new Set(['dir:']) }, // tree map: open folder/file cells
-    filters: { text: '', showTests: true, depth: 0 },
-    atlas: { built: false, items: [] },
-    atlasOpen: null,     // an atlas card currently open on the canvas
-    code: { path: null, history: [], idx: -1, cache: {} }, // the Code tab
-    // Deep-analysis engines (semgrep, gitleaks, knip…). `status` is which are
-    // installed; `report` is the last run; `findings` merge into the security
-    // view. Only ever filled for a server-side scan — a browser-picked folder
-    // has no server-visible root for a tool to read.
-    //
-    // `install` is per-engine GUI install state ({ running, log, ok, error });
-    // `options` is the per-engine form values the Configure panel edits.
-    tools: {
-      status: null, report: null, running: false, loading: false,
-      findings: [], merged: 0, error: null,
-      install: {}, options: {},
-    },
-    // The Deep Analysis view's own controls: which findings are on screen, and
-    // whatever the AI has said about the report so far. Per-repo, so a new scan
-    // does not inherit the previous repo's filters or its explanation.
-    analysis: {
-      severity: 'all', tool: 'all', q: '',
-      ai: { text: '', error: '', running: false, question: '' },
-    },
-    history: null,
-  };
+    return {
+        scan: null,
+        facts: null,
+        manifest: null,
+        stack: null,
+        health: null,
+        security: null,
+        history: null,
+        patterns: null,
+        treeData: null,
+        scanId: null,
+        cloneId: null,
+        browserSource: null,
+        view: 'map',
+        lastExplorer: 'map',
+        folder: '',
+        detail: null, // file open in deep-dive, if any
+        selected: null, // the focused FILE (the inspector's current subject)
+        focusedFolder: null, // the focused FOLDER subject, when it's a folder
+        tour: { stops: [], idx: 0 },
+        currentDiagram: { source: '', nodes: {} },
+        aiDiagrams: {}, // viewKey -> { body, caption } — unthemed, composed at render
+        aiActiveKey: null, // which viewKey is currently showing its AI draft
+        docs: { rendered: false, writing: false, tabs: new Map(), active: 'overview', tabsEl: null, wrapEl: null, railEl: null, bar: null, pageEl: null },
+        about: { rendered: false },
+        mm: { expanded: new Set(['dir:']) }, // tree map: open folder/file cells
+        filters: { text: '', showTests: true, depth: 0 },
+        atlas: { built: false, items: [] },
+        atlasOpen: null, // an atlas card currently open on the canvas
+        code: { path: null, history: [], idx: -1, cache: {} }, // the Code tab
+        // Deep-analysis engines (semgrep, gitleaks, knip…). `status` is which are
+        // installed; `report` is the last run; `findings` merge into the security
+        // view. Only ever filled for a server-side scan — a browser-picked folder
+        // has no server-visible root for a tool to read.
+        //
+        // `install` is per-engine GUI install state ({ running, log, ok, error });
+        // `options` is the per-engine form values the Configure panel edits.
+        tools: {
+            status: null, report: null, running: false, loading: false,
+            findings: [], merged: 0, error: null,
+            install: {}, options: {},
+        },
+        // The Deep Analysis view's own controls: which findings are on screen, and
+        // whatever the AI has said about the report so far. Per-repo, so a new scan
+        // does not inherit the previous repo's filters or its explanation.
+        analysis: {
+            severity: 'all', tool: 'all', q: '',
+            ai: { text: '', error: '', running: false, question: '' },
+        },
+        review: { report: null, mode: 'working', base: 'HEAD', head: 'HEAD', profile: '', severity: 'all', query: '', showAcknowledged: false, aiText: '', error: '' },
+    };
 }
-
 export const state = perRepo();
-
 // Replaces the per-repo state wholesale. Anything not listed in `perRepo()`
 // survives, which is what you want for preferences like the theme.
 export function loadRepo({ scan, facts, manifest, history, scanId, cloneId }, extra = {}) {
-  Object.assign(state, perRepo(), {
-    scan,
-    facts,
-    manifest: manifest || { services: [] },
-    history: history || null,
-    scanId: scanId || null,
-    cloneId: cloneId || null,
-  }, extra);
-  return state;
+    Object.assign(state, perRepo(), {
+        scan,
+        facts,
+        manifest: manifest || { services: [] },
+        history: history || null,
+        scanId: scanId || null,
+        cloneId: cloneId || null,
+    }, extra);
+    return state;
 }
-
 export function unloadRepo() {
-  Object.assign(state, perRepo());
+    Object.assign(state, perRepo());
 }
-
 // Focus: a file and a folder are alternatives, never both. Every selection path
 // in the app funnels through these, so the inspector can trust that reading
 // `selected` first and `focusedFolder` second gives an unambiguous subject.
 export function focusFile(path) {
-  state.selected = path;
-  state.focusedFolder = null;
+    state.selected = path;
+    state.focusedFolder = null;
 }
-
 export function focusFolder(path) {
-  state.focusedFolder = path;
-  state.selected = null;
+    state.focusedFolder = path;
+    state.selected = null;
 }
-
 export function clearFocus() {
-  state.selected = null;
-  state.focusedFolder = null;
-  state.detail = null;
+    state.selected = null;
+    state.focusedFolder = null;
+    state.detail = null;
 }
-
 // Which subject the inspector should show, and the label for the "back" control
 // that returns to the view's own panel. Pure function of state, so the panel
 // and the canvas can never disagree about what is focused.
 export function inspectorSubject(s = state) {
-  const backLabel = inspectorBackLabel(s);
-  if (s.selected && s.facts && s.facts.fanIn[s.selected] !== undefined) {
-    return { kind: 'file', path: s.selected, backLabel };
-  }
-  if (s.focusedFolder !== null && s.focusedFolder !== undefined) {
-    return { kind: 'folder', path: s.focusedFolder, backLabel };
-  }
-  if (PANEL_VIEWS[s.view]) return { kind: s.view, backLabel: null };
-  if (s.view === 'files') return { kind: 'folder', path: s.folder, backLabel };
-  return { kind: 'overview', backLabel: null };
+    const backLabel = inspectorBackLabel(s);
+    if (s.selected && s.facts && s.facts.fanIn[s.selected] !== undefined) {
+        return { kind: 'file', path: s.selected, backLabel };
+    }
+    if (s.focusedFolder !== null && s.focusedFolder !== undefined) {
+        return { kind: 'folder', path: s.focusedFolder, backLabel };
+    }
+    if (PANEL_VIEWS[s.view])
+        return { kind: s.view, backLabel: null };
+    if (s.view === 'files')
+        return { kind: 'folder', path: s.folder, backLabel };
+    return { kind: 'overview', backLabel: null };
 }
-
 export function inspectorBackLabel(s = state) {
-  if (s.view === 'tour') return null; // the tour drives its own focus
-  if (s.view === 'files') return s.folder ? 'the folder' : 'the overview';
-  if (PANEL_VIEWS[s.view]) return PANEL_VIEWS[s.view];
-  return 'the overview';
+    if (s.view === 'tour')
+        return null; // the tour drives its own focus
+    if (s.view === 'files')
+        return s.folder ? 'the folder' : 'the overview';
+    if (PANEL_VIEWS[s.view])
+        return PANEL_VIEWS[s.view];
+    return 'the overview';
 }
-
 export function isExplorerView(view) {
-  return EXPLORER_VIEWS.includes(view);
+    return EXPLORER_VIEWS.includes(view);
 }
-
 // Which slot in `aiDiagrams` the current view's AI draft belongs to. Two views
 // that show different pictures must never share a key, or one's draft appears
 // over the other's diagram.
 export function aiViewKey(s = state) {
-  // A tour draft belongs to the stop, not to whatever file was last selected.
-  if (s.view === 'tour') return `tour:${s.tour.idx}`;
-  if (s.view === 'atlas') {
-    return s.atlasOpen ? `atlas:${s.atlasOpen.kind}:${s.atlasOpen.path}` : 'atlas:';
-  }
-  return `${s.view}:${s.detail || s.folder || ''}`;
+    // A tour draft belongs to the stop, not to whatever file was last selected.
+    if (s.view === 'tour')
+        return `tour:${s.tour.idx}`;
+    if (s.view === 'atlas') {
+        return s.atlasOpen ? `atlas:${s.atlasOpen.kind}:${s.atlasOpen.path}` : 'atlas:';
+    }
+    return `${s.view}:${s.detail || s.folder || ''}`;
 }
-
 // ---- the Code tab's history ------------------------------------------------
 //
 // A browser-style back/forward stack over the files opened in the Code tab.
@@ -159,34 +151,34 @@ export function aiViewKey(s = state) {
 // opening a new file has to discard the entries in front of the cursor, exactly
 // as a browser drops the forward stack. That rule is the whole reason this lives
 // here with a test rather than inline in a render function.
-
 // Which file the Code tab should show when it is asked to render. The chain is
 // most-specific-first: what the tab already had, then whatever the rest of the
 // app is looking at, then the repo's own front door, then anything at all.
 export function defaultCodePath(s = state) {
-  const { scan, facts, code } = s;
-  // `facts.entries` holds plain path strings — `graph.js` builds it by mapping
-  // files to `f.path`. (`facts.hubs`, confusingly, holds objects.) An earlier
-  // version of this accepted either shape for `entries`; nothing has ever
-  // produced the object one, and pretending otherwise hid the asymmetry.
-  return code.path || s.detail || s.selected || facts?.entries?.[0]
-    || scan?.files?.[0]?.path || scan?.allFiles?.[0] || null;
+    const { scan, facts, code } = s;
+    // `facts.entries` holds plain path strings — `graph.js` builds it by mapping
+    // files to `f.path`. (`facts.hubs`, confusingly, holds objects.) An earlier
+    // version of this accepted either shape for `entries`; nothing has ever
+    // produced the object one, and pretending otherwise hid the asymmetry.
+    return code.path || s.detail || s.selected || facts?.entries?.[0]
+        || scan?.files?.[0]?.path || scan?.allFiles?.[0] || null;
 }
-
 export function pushCodeHistory(path, s = state) {
-  const h = s.code.history;
-  if (h[s.code.idx] === path) return; // re-opening the current file is not a move
-  h.length = s.code.idx + 1;          // drop any forward entries
-  h.push(path);
-  s.code.idx = h.length - 1;
+    const h = s.code.history;
+    if (h[s.code.idx] === path)
+        return; // re-opening the current file is not a move
+    h.length = s.code.idx + 1; // drop any forward entries
+    h.push(path);
+    s.code.idx = h.length - 1;
 }
-
 // Moves the cursor by `delta` and reports where it landed, or null if that would
 // step off either end. The caller opens the returned path; refusing to move and
 // returning null is how the disabled arrow buttons stay honest.
 export function codeHistoryTarget(delta, s = state) {
-  const next = s.code.idx + delta;
-  if (next < 0 || next >= s.code.history.length) return null;
-  s.code.idx = next;
-  return s.code.history[next];
+    const next = s.code.idx + delta;
+    if (next < 0 || next >= s.code.history.length)
+        return null;
+    s.code.idx = next;
+    return s.code.history[next];
 }
+//# sourceMappingURL=state.js.map

package/public/js/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/public/js/state.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReviewReport } from '../../shared/review/contracts.js';\n// The application's state, in one place.\n//\n// This is a plain mutable object, not a reactive store, and that is deliberate.\n// Rendering here is expensive and stateful — the canvas holds a pan/zoom\n// transform, the code tab holds a Monaco editor — so \"every mutation triggers a\n// re-render\" would be both slow and destructive. Callers still decide what to\n// redraw. What this module does own is the state's *invariants*, which used to\n// be maintained by convention in a 2,400-line file and are now enforced in one\n// place that can be tested.\n//\n// No DOM, no imports from the view layer: importable in Node.\n\n// The views that share the Explorer tab and its canvas.\nexport const EXPLORER_VIEWS = ['map', 'files', 'patterns', 'health', 'security', 'history', 'services', 'tour', 'atlas'];\n\n// Views whose default inspector panel is their own, rather than the overview.\nconst PANEL_VIEWS = { patterns: 'patterns', health: 'health', security: 'security', history: 'history' };\n\n// Per-repo state, rebuilt by `loadRepo`. Split out from the rest so \"what has\n// to be reset when a new repo arrives\" is a list in one place rather than a\n// thing you remember — forgetting an entry here is how a new repo inherits the\n// previous one's open tabs.\nfunction perRepo() {\n  return {\n    scan: null,\n    facts: null,\n    manifest: null,\n    stack: null,\n    health: null,\n    security: null,\n    history: null,\n    patterns: null,\n    treeData: null,\n    scanId: null,\n    cloneId: null,\n    browserSource: null,\n    view: 'map',\n    lastExplorer: 'map',\n    folder: '',\n    detail: null,        // file open in deep-dive, if any\n    selected: null,      // the focused FILE (the inspector's current subject)\n    focusedFolder: null, // the focused FOLDER subject, when it's a folder\n    tour: { stops: [], idx: 0 },\n    currentDiagram: { source: '', nodes: {} },\n    aiDiagrams: {},      // viewKey -> { body, caption } — unthemed, composed at render\n    aiActiveKey: null,   // which viewKey is currently showing its AI draft\n    docs: { rendered: false, writing: false, tabs: new Map(), active: 'overview', tabsEl: null as HTMLElement | null, wrapEl: null as HTMLElement | null, railEl: null as HTMLElement | null, bar: null as HTMLElement | null, pageEl: null as HTMLElement | null },\n    about: { rendered: false },\n    mm: { expanded: new Set(['dir:']) }, // tree map: open folder/file cells\n    filters: { text: '', showTests: true, depth: 0 },\n    atlas: { built: false, items: [] },\n    atlasOpen: null,     // an atlas card currently open on the canvas\n    code: { path: null, history: [], idx: -1, cache: {} }, // the Code tab\n    // Deep-analysis engines (semgrep, gitleaks, knip…). `status` is which are\n    // installed; `report` is the last run; `findings` merge into the security\n    // view. Only ever filled for a server-side scan — a browser-picked folder\n    // has no server-visible root for a tool to read.\n    //\n    // `install` is per-engine GUI install state ({ running, log, ok, error });\n    // `options` is the per-engine form values the Configure panel edits.\n    tools: {\n      status: null, report: null, running: false, loading: false,\n      findings: [], merged: 0, error: null,\n      install: {}, options: {},\n    },\n    // The Deep Analysis view's own controls: which findings are on screen, and\n    // whatever the AI has said about the report so far. Per-repo, so a new scan\n    // does not inherit the previous repo's filters or its explanation.\n    analysis: {\n      severity: 'all', tool: 'all', q: '',\n      ai: { text: '', error: '', running: false, question: '' },\n    },\n    review: { report: null as ReviewReport | null, mode: 'working', base: 'HEAD', head: 'HEAD', profile: '', severity: 'all', query: '', showAcknowledged: false, aiText: '', error: '' },\n  };\n}\n\nexport const state = perRepo();\n\n// Replaces the per-repo state wholesale. Anything not listed in `perRepo()`\n// survives, which is what you want for preferences like the theme.\nexport function loadRepo({ scan, facts, manifest, history, scanId, cloneId }, extra: Record<string, any> = {}) {\n  Object.assign(state, perRepo(), {\n    scan,\n    facts,\n    manifest: manifest || { services: [] },\n    history: history || null,\n    scanId: scanId || null,\n    cloneId: cloneId || null,\n  }, extra);\n  return state;\n}\n\nexport function unloadRepo() {\n  Object.assign(state, perRepo());\n}\n\n// Focus: a file and a folder are alternatives, never both. Every selection path\n// in the app funnels through these, so the inspector can trust that reading\n// `selected` first and `focusedFolder` second gives an unambiguous subject.\nexport function focusFile(path) {\n  state.selected = path;\n  state.focusedFolder = null;\n}\n\nexport function focusFolder(path) {\n  state.focusedFolder = path;\n  state.selected = null;\n}\n\nexport function clearFocus() {\n  state.selected = null;\n  state.focusedFolder = null;\n  state.detail = null;\n}\n\n// Which subject the inspector should show, and the label for the \"back\" control\n// that returns to the view's own panel. Pure function of state, so the panel\n// and the canvas can never disagree about what is focused.\nexport function inspectorSubject(s = state) {\n  const backLabel = inspectorBackLabel(s);\n  if (s.selected && s.facts && s.facts.fanIn[s.selected] !== undefined) {\n    return { kind: 'file', path: s.selected, backLabel };\n  }\n  if (s.focusedFolder !== null && s.focusedFolder !== undefined) {\n    return { kind: 'folder', path: s.focusedFolder, backLabel };\n  }\n  if (PANEL_VIEWS[s.view]) return { kind: s.view, backLabel: null };\n  if (s.view === 'files') return { kind: 'folder', path: s.folder, backLabel };\n  return { kind: 'overview', backLabel: null };\n}\n\nexport function inspectorBackLabel(s = state) {\n  if (s.view === 'tour') return null; // the tour drives its own focus\n  if (s.view === 'files') return s.folder ? 'the folder' : 'the overview';\n  if (PANEL_VIEWS[s.view]) return PANEL_VIEWS[s.view];\n  return 'the overview';\n}\n\nexport function isExplorerView(view) {\n  return EXPLORER_VIEWS.includes(view);\n}\n\n// Which slot in `aiDiagrams` the current view's AI draft belongs to. Two views\n// that show different pictures must never share a key, or one's draft appears\n// over the other's diagram.\nexport function aiViewKey(s = state) {\n  // A tour draft belongs to the stop, not to whatever file was last selected.\n  if (s.view === 'tour') return `tour:${s.tour.idx}`;\n  if (s.view === 'atlas') {\n    return s.atlasOpen ? `atlas:${s.atlasOpen.kind}:${s.atlasOpen.path}` : 'atlas:';\n  }\n  return `${s.view}:${s.detail || s.folder || ''}`;\n}\n\n// ---- the Code tab's history ------------------------------------------------\n//\n// A browser-style back/forward stack over the files opened in the Code tab.\n// `idx` is a cursor into `history`, not always its last entry: after going back,\n// opening a new file has to discard the entries in front of the cursor, exactly\n// as a browser drops the forward stack. That rule is the whole reason this lives\n// here with a test rather than inline in a render function.\n\n// Which file the Code tab should show when it is asked to render. The chain is\n// most-specific-first: what the tab already had, then whatever the rest of the\n// app is looking at, then the repo's own front door, then anything at all.\nexport function defaultCodePath(s = state) {\n  const { scan, facts, code } = s;\n  // `facts.entries` holds plain path strings — `graph.js` builds it by mapping\n  // files to `f.path`. (`facts.hubs`, confusingly, holds objects.) An earlier\n  // version of this accepted either shape for `entries`; nothing has ever\n  // produced the object one, and pretending otherwise hid the asymmetry.\n  return code.path || s.detail || s.selected || facts?.entries?.[0]\n    || scan?.files?.[0]?.path || scan?.allFiles?.[0] || null;\n}\n\nexport function pushCodeHistory(path, s = state) {\n  const h = s.code.history;\n  if (h[s.code.idx] === path) return; // re-opening the current file is not a move\n  h.length = s.code.idx + 1;          // drop any forward entries\n  h.push(path);\n  s.code.idx = h.length - 1;\n}\n\n// Moves the cursor by `delta` and reports where it landed, or null if that would\n// step off either end. The caller opens the returned path; refusing to move and\n// returning null is how the disabled arrow buttons stay honest.\nexport function codeHistoryTarget(delta, s = state) {\n  const next = s.code.idx + delta;\n  if (next < 0 || next >= s.code.history.length) return null;\n  s.code.idx = next;\n  return s.code.history[next];\n}\n"]}

package/public/js/tour.d.ts

@@ -0,0 +1,6 @@
+import { buildTourStops } from '/shared/analyzer/tour.js';
+export { buildTourStops };
+export declare function describeStop(stop: any, index: any, total: any): {
+    title: any;
+    count: string;
+};

package/public/js/tour.js

@@ -4,14 +4,12 @@
 // same list to an agent, and two copies of "which eight files should a newcomer
 // read first" would eventually disagree. This module keeps only what is genuinely
 // the view's — the label the tour bar draws.
-
 import { buildTourStops, tourStopTitle } from '/shared/analyzer/tour.js';
-
 export { buildTourStops };
-
 export function describeStop(stop, index, total) {
-  return {
-    title: tourStopTitle(stop),
-    count: `${index + 1} / ${total}`,
-  };
+    return {
+        title: tourStopTitle(stop),
+        count: `${index + 1} / ${total}`,
+    };
 }
+//# sourceMappingURL=tour.js.map

package/public/js/tour.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour.js","sourceRoot":"","sources":["../../src/public/js/tour.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,EAAE;AACF,mFAAmF;AACnF,gFAAgF;AAChF,kFAAkF;AAClF,6CAA6C;AAE7C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,MAAM,UAAU,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK;IAC7C,OAAO;QACL,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC;QAC1B,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC,MAAM,KAAK,EAAE;KACjC,CAAC;AACJ,CAAC","sourcesContent":["// The guided walk, as the browser sees it.\n//\n// The ordering itself moved to `shared/analyzer/tour.js`: the MCP server hands the\n// same list to an agent, and two copies of \"which eight files should a newcomer\n// read first\" would eventually disagree. This module keeps only what is genuinely\n// the view's — the label the tour bar draws.\n\nimport { buildTourStops, tourStopTitle } from '/shared/analyzer/tour.js';\n\nexport { buildTourStops };\n\nexport function describeStop(stop, index, total) {\n  return {\n    title: tourStopTitle(stop),\n    count: `${index + 1} / ${total}`,\n  };\n}\n"]}

package/public/js/transitions.d.ts

@@ -0,0 +1,2 @@
+export declare function withTransition(callback: any): void;
+export declare function setupViewTransitionNames(elements: Record<string, string>): void;

package/public/js/transitions.js

@@ -1,15 +1,14 @@
 export function withTransition(callback) {
-  if (document.startViewTransition) {
-    document.startViewTransition(callback);
-  } else {
+    // Switching a workbench view should not snapshot and animate the entire page.
+    // That retains both heavy views during a transition and delays rapid tab changes.
     callback();
-  }
 }
-
 export function setupViewTransitionNames(elements) {
-  // Utility for adding transition names if needed
-  Object.entries(elements).forEach(([id, name]) => {
-    const el = document.getElementById(id);
-    if (el) el.style.viewTransitionName = name;
-  });
+    // Utility for adding transition names if needed
+    Object.entries(elements).forEach(([id, name]) => {
+        const el = document.getElementById(id);
+        if (el)
+            el.style.viewTransitionName = name;
+    });
 }
+//# sourceMappingURL=transitions.js.map

package/public/js/transitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transitions.js","sourceRoot":"","sources":["../../src/public/js/transitions.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,QAAQ;IACrC,8EAA8E;IAC9E,kFAAkF;IAClF,QAAQ,EAAE,CAAC;AACb,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAgC;IACvE,gDAAgD;IAChD,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE;QAC9C,MAAM,EAAE,GAAG,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,EAAE;YAAE,EAAE,CAAC,KAAK,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["export function withTransition(callback) {\n  // Switching a workbench view should not snapshot and animate the entire page.\n  // That retains both heavy views during a transition and delays rapid tab changes.\n  callback();\n}\n\nexport function setupViewTransitionNames(elements: Record<string, string>) {\n  // Utility for adding transition names if needed\n  Object.entries(elements).forEach(([id, name]) => {\n    const el = document.getElementById(id);\n    if (el) el.style.viewTransitionName = name;\n  });\n}\n"]}

package/public/js/tree.d.ts

@@ -0,0 +1,12 @@
+export declare function buildTree(allFiles: any): {
+    name: string;
+    path: string;
+    dirs: Map<any, any>;
+    files: any[];
+};
+export declare function findNode(root: any, path: any): any;
+export declare function countFiles(node: any): any;
+export declare function pruneTree(root: any, include: any, matchesFolder?: any): any;
+export declare function expandedToDepth(root: any, maxDepth: any): Set<string>;
+export declare function resetOpenState(): void;
+export declare function renderTree(container: any, tree: any, ctx: any): void;