npm - collabmd - Versions diffs - 0.1.51 → 0.1.52 - Mend

collabmd 0.1.51 → 0.1.52

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 (584) hide show

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "collabmd",
-  "version": "0.1.51",
+  "version": "0.1.52",
   "type": "module",
   "description": "Collaborative markdown vault — like Obsidian, but online. Serve any directory of markdown files for realtime collaborative editing.",
   "repository": {
@@ -67,14 +67,17 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@excalidraw/fractional-indexing": "^0.18.0-214cd6e",
+    "@excalidraw/fractional-indexing": "^0.18.0-afa3a65",
     "@modelcontextprotocol/client": "^2.0.0",
     "@modelcontextprotocol/node": "^2.0.0",
     "@modelcontextprotocol/server": "^2.0.0",
-    "@turbodocx/html-to-docx": "^1.22.2",
+    "@turbodocx/html-to-docx": "^1.23.0",
+    "@vscode/markdown-it-katex": "^1.1.2",
     "archiver": "^8.0.0",
     "js-yaml": "^5.4.1",
+    "katex": "^0.18.7",
     "lib0": "^0.2.117",
+    "mathml2omml": "^0.5.0",
     "openid-client": "^6.8.8",
     "sharp": "^0.35.4",
     "ws": "^8.21.3",
@@ -107,7 +110,7 @@
     "@codemirror/view": "^6.43.11",
     "@embedpdf/snippet": "2.15.0",
     "@eslint/js": "^10.0.1",
-    "@excalidraw/excalidraw": "0.18.0-214cd6e",
+    "@excalidraw/excalidraw": "0.18.0-afa3a65",
     "@playwright/test": "^1.63.0",
     "@replit/codemirror-vim": "^6.4.0",
     "@vitest/browser": "^5.0.0",
@@ -115,13 +118,13 @@
     "eslint": "^10.10.0",
     "globals": "^17.12.0",
     "highlight.js": "^11.12.0",
-    "markdown-it": "^15.0.1",
-    "mermaid": "^11.17.2",
+    "markdown-it": "^15.0.2",
+    "mermaid": "^12.0.0",
     "mermaid-formatter": "^0.3.0",
     "prettier": "^3.9.6",
-    "react": "^19.2.8",
-    "react-dom": "^19.2.8",
-    "vite": "^8.2.2",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "vite": "^8.3.0",
     "vitest": "^5.0.0",
     "y-codemirror.next": "^0.3.6",
     "y-websocket": "^3.1.0"

package/src/client/app/drawio-editor.html CHANGED Viewed

@@ -4,6 +4,7 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>draw.io — CollabMD</title>
+  <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32' fill='none'><rect x='3' y='4' width='17' height='24' rx='3' stroke='%232563eb' stroke-width='2'/><rect x='12' y='4' width='17' height='24' rx='3' fill='%232563eb'/><path d='M17 12h7m-7 4h7m-7 4h4' stroke='white' stroke-width='1.5'/></svg>">
   <script vite-ignore defer src="./app-config.js"></script>
 </head>
 <body data-theme="dark" data-surface="drawio-editor">

package/src/client/app/excalidraw-editor.html CHANGED Viewed

@@ -4,6 +4,7 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>Excalidraw — CollabMD</title>
+  <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32' fill='none'><rect x='3' y='4' width='17' height='24' rx='3' stroke='%232563eb' stroke-width='2'/><rect x='12' y='4' width='17' height='24' rx='3' fill='%232563eb'/><path d='M17 12h7m-7 4h7m-7 4h4' stroke='white' stroke-width='1.5'/></svg>">
   <script vite-ignore defer src="./app-config.js"></script>
 </head>
 <body data-theme="dark" data-surface="excalidraw-editor">

package/src/client/app/export-document-entry.js CHANGED Viewed

@@ -5,6 +5,7 @@ import '../styles/foundation/themes.css';
 import '../styles/features/preview-markdown.css';
 import '../styles/overrides/highlightjs.css';
 import '../styles/export-document.css';
+import 'katex/dist/katex.min.css';
 function ensureHighlightThemeStylesheet() {
   let themeStylesheet = document.getElementById('hljs-theme');

package/src/client/app/export-document.html CHANGED Viewed

@@ -4,6 +4,7 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>CollabMD Export</title>
+  <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32' fill='none'><rect x='3' y='4' width='17' height='24' rx='3' stroke='%232563eb' stroke-width='2'/><rect x='12' y='4' width='17' height='24' rx='3' fill='%232563eb'/><path d='M17 12h7m-7 4h7m-7 4h4' stroke='white' stroke-width='1.5'/></svg>">
   <script vite-ignore defer src="./app-config.js"></script>
 </head>
 <body data-theme="light" data-surface="export-document">

package/src/client/app/index.html CHANGED Viewed

@@ -5,7 +5,7 @@
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <meta name="description" content="CollabMD — collaborative markdown vault. Edit markdown files together in realtime.">
   <title>CollabMD — Collaborative Markdown Vault</title>
-  <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'><rect x='2' y='4' width='18' height='24' rx='3' fill='%23818cf8'/><rect x='12' y='4' width='18' height='24' rx='3' fill='%234f46e5' opacity='0.8'/><path d='M18 12h6M18 16h6M18 20h4' stroke='white' stroke-width='1.5' stroke-linecap='round'/></svg>">
+  <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32' fill='none'><rect x='3' y='4' width='17' height='24' rx='3' stroke='%232563eb' stroke-width='2'/><rect x='12' y='4' width='17' height='24' rx='3' fill='%232563eb'/><path d='M17 12h7m-7 4h7m-7 4h4' stroke='white' stroke-width='1.5'/></svg>">
   <script>
     if (
       window.location.hash.includes('file=')
@@ -25,11 +25,10 @@
       <aside id="sidebar" class="sidebar">
         <div class="sidebar-header">
           <div class="sidebar-brand">
-            <svg width="20" height="20" viewBox="0 0 56 56" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
-              <rect x="6" y="8" width="28" height="38" rx="4" stroke="var(--color-primary)" stroke-width="2" fill="var(--color-primary)" fill-opacity="0.12"></rect>
-              <rect x="22" y="10" width="28" height="38" rx="4" stroke="var(--color-primary)" stroke-width="2" fill="var(--color-primary)" fill-opacity="0.25"></rect>
-              <path d="M14 20l4 10 1.5-4 4-1.5L14 20z" fill="var(--color-primary)" opacity="0.7"></path>
-              <path d="M38 28l-4-10-1.5 4-4 1.5L38 28z" fill="var(--color-primary)"></path>
+            <svg width="20" height="20" viewBox="0 0 32 32" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
+              <rect x="3" y="4" width="17" height="24" rx="3" stroke="var(--color-primary)" stroke-width="2"></rect>
+              <rect x="12" y="4" width="17" height="24" rx="3" fill="var(--color-primary)"></rect>
+              <path d="M17 12h7m-7 4h7m-7 4h4" stroke="var(--color-primary-contrast)" stroke-width="1.5"></path>
             </svg>
             <span class="sidebar-title">CollabMD</span>
           </div>
@@ -388,6 +387,15 @@
                 <span class="ui-toolbar-button-label">Search files</span>
               </button>
+              <button type="button" class="ui-button ui-button--ghost ui-button--toolbar ui-button--toggle" id="toggleCursorNamesBtn" aria-label="Hide cursor names" aria-pressed="true" title="Hide cursor names">
+                <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+                  <circle cx="12" cy="8" r="4"></circle>
+                  <path d="M5 21v-2a7 7 0 0 1 14 0v2"></path>
+                </svg>
+                <span class="ui-toolbar-button-label">Cursor names</span>
+                <span class="ui-pill-badge ui-pill-badge--muted toolbar-toggle-state" id="cursorNamesToggleLabel">On</span>
+              </button>
               <button class="ui-button ui-button--ghost ui-button--toolbar ui-button--toggle toolbar-vim-button" id="toggleVimModeBtn" aria-label="Enable Vim keybindings" aria-pressed="false" title="Enable Vim keybindings">
                 <span class="toolbar-vim-icon" aria-hidden="true">
                   <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round">
@@ -397,7 +405,7 @@
                   </svg>
                 </span>
                 <span class="ui-toolbar-button-label">Vim</span>
-                <span class="ui-pill-badge ui-pill-badge--muted toolbar-vim-state" id="vimModeToggleLabel">Off</span>
+                <span class="ui-pill-badge ui-pill-badge--muted toolbar-toggle-state" id="vimModeToggleLabel">Off</span>
               </button>
               <details class="toolbar-overflow-group hidden" id="exportMenuGroup">
@@ -455,11 +463,10 @@
         <div id="emptyState" class="empty-state">
           <div class="empty-state-content">
             <div class="empty-state-logo" aria-hidden="true">
-              <svg width="48" height="48" viewBox="0 0 56 56" fill="none" xmlns="http://www.w3.org/2000/svg">
-                <rect x="6" y="8" width="28" height="38" rx="4" stroke="var(--color-primary)" stroke-width="2" fill="var(--color-primary)" fill-opacity="0.12"></rect>
-                <rect x="22" y="10" width="28" height="38" rx="4" stroke="var(--color-primary)" stroke-width="2" fill="var(--color-primary)" fill-opacity="0.25"></rect>
-                <path d="M14 20l4 10 1.5-4 4-1.5L14 20z" fill="var(--color-primary)" opacity="0.7"></path>
-                <path d="M38 28l-4-10-1.5 4-4 1.5L38 28z" fill="var(--color-primary)"></path>
+              <svg width="48" height="48" viewBox="0 0 32 32" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
+                <rect x="3" y="4" width="17" height="24" rx="3" stroke="var(--color-primary)" stroke-width="2"></rect>
+                <rect x="12" y="4" width="17" height="24" rx="3" fill="var(--color-primary)"></rect>
+                <path d="M17 12h7m-7 4h7m-7 4h4" stroke="var(--color-primary-contrast)" stroke-width="1.5"></path>
               </svg>
             </div>
             <h2 class="empty-state-title">Welcome to CollabMD</h2>

package/src/client/application/app-shell/ui-feature-shell.js CHANGED Viewed

@@ -66,6 +66,7 @@ async function initialize() {
   this.initializePreviewLayoutObserver();
   this.syncIdentityManagementUi();
   this.syncCurrentUserName();
+  this.syncCursorNamesToggle();
   this.syncWrapToggle();
   this.syncVimModeToggle();
   this.syncToolbarOverflowVisibility?.();
@@ -351,6 +352,12 @@ function bindEvents() {
     this.toggleLineWrapping();
   });
+  this.elements.toggleCursorNamesButton?.addEventListener('click', () => {
+    const visible = this.elements.editorContainer.classList.contains('hide-cursor-names');
+    this.preferences.setCursorNamesVisible(visible);
+    this.syncCursorNamesToggle(visible);
+  });
   this.elements.toggleVimModeButton?.addEventListener('click', () => {
     this.toggleVimMode();
   });
@@ -367,7 +374,7 @@ function bindEvents() {
   this.elements.toolbarOverflowMenu?.addEventListener('click', (event) => {
     const button = event.target instanceof Element ? event.target.closest('button') : null;
-    if (button && button !== this.elements.toggleVimModeButton) {
+    if (button && button !== this.elements.toggleVimModeButton && button !== this.elements.toggleCursorNamesButton) {
       this.closeToolbarOverflowMenu();
     }
   });
@@ -1043,6 +1050,17 @@ function syncVimModeToggle(state) {
   }
 }
+/** @this {UiShellContext} */
+function syncCursorNamesToggle(visible = this.preferences.getCursorNamesVisible()) {
+  this.elements.editorContainer?.classList.toggle('hide-cursor-names', !visible);
+  const label = this.elements.cursorNamesToggleLabel;
+  if (label) label.textContent = visible ? 'On' : 'Off';
+  const button = this.elements.toggleCursorNamesButton;
+  button?.setAttribute('aria-pressed', String(visible));
+  button?.setAttribute('aria-label', `${visible ? 'Hide' : 'Show'} cursor names`);
+  button?.setAttribute('title', `${visible ? 'Hide' : 'Show'} cursor names`);
+}
 /** @this {UiShellContext} */
 function syncWrapToggle(state) {
   const enabled = state ?? this.session?.isLineWrappingEnabled() ?? this.getStoredLineWrapping();
@@ -1140,6 +1158,7 @@ export const uiFeatureShellMethods = {
   syncVisualViewportBounds,
   syncToolbarOverflowVisibility,
   syncVimModeToggle,
+  syncCursorNamesToggle,
   syncWrapToggle,
   toggleLineWrapping,
   unfoldPreviewHeading,

package/src/client/application/app-shell-elements.js CHANGED Viewed

@@ -81,6 +81,8 @@ export function bindAppShellElements(doc = document) {
     toggleVimModeButton: doc.getElementById('toggleVimModeBtn'),
     userAvatars: doc.getElementById('userAvatars'),
     userCount: doc.getElementById('userCount'),
+    cursorNamesToggleLabel: doc.getElementById('cursorNamesToggleLabel'),
+    toggleCursorNamesButton: doc.getElementById('toggleCursorNamesBtn'),
     wrapToggleLabel: doc.getElementById('wrapToggleLabel'),
     vimModeToggleLabel: doc.getElementById('vimModeToggleLabel'),
     activeFileName: doc.getElementById('activeFileName'),

package/src/client/application/diagram-preview-hydrator.js CHANGED Viewed

@@ -409,6 +409,13 @@ export class DiagramPreviewHydrator {
       return;
     }
+    if (this.observer && typeof IntersectionObserver !== 'undefined') {
+      Array.from(previewElement.querySelectorAll(this.shellSelector)).forEach((shell) => {
+        this.observer.observe(shell);
+      });
+      return;
+    }
     const margin = this.renderer.isLargeDocument ? 180 : 420;
     Array.from(previewElement.querySelectorAll(this.shellSelector)).forEach((shell) => {
       if (this.isNearViewportFn(shell, previewContainer, margin)) {

package/src/client/application/mermaid-preview-hydrator.js CHANGED Viewed

@@ -7,10 +7,27 @@ import {
   createMermaidPlaceholderCardWithMessage,
   createDiagramErrorPlaceholderCard,
   MERMAID_BATCH_SIZE,
+  MERMAID_RENDER_CACHE_LIMIT,
   normalizeDiagramError,
   normalizeMermaidSvg,
+  resolveSvgDimensions,
 } from './preview-diagram-utils.js';
+function parseCachedSvgMarkup(svgMarkup) {
+  try {
+    const template = document.createElement('template');
+    template.innerHTML = String(svgMarkup);
+    const svg = template.content?.querySelector?.('svg');
+    if (svg?.nodeName?.toLowerCase() === 'svg') {
+      return svg;
+    }
+  } catch {
+    // Fall through to a fresh render below.
+  }
+  return null;
+}
 export class MermaidPreviewHydrator extends DiagramPreviewHydrator {
   constructor(renderer, { loadFileSource = null } = {}) {
     super(renderer, {
@@ -35,6 +52,7 @@ export class MermaidPreviewHydrator extends DiagramPreviewHydrator {
     this.diagramChrome = renderer.diagramChrome;
     this.loader = null;
     this.runtime = null;
+    this.renderCache = new Map();
   }
   cancelHydration({ preserveActiveShell = false } = {}) {
@@ -45,6 +63,10 @@ export class MermaidPreviewHydrator extends DiagramPreviewHydrator {
   }
   applyTheme(theme) {
+    if (theme === this.currentTheme) {
+      return;
+    }
     this.currentTheme = theme;
     const mermaid = this.runtime;
     if (!mermaid) {
@@ -181,6 +203,16 @@ export class MermaidPreviewHydrator extends DiagramPreviewHydrator {
       const renderedSource = source;
       source = this.prepareSource(source);
+      const renderCacheKey = this.getRenderCacheKey(source);
+      if (this.tryMountCachedDiagram(shell, {
+        hydrationToken,
+        renderCacheKey,
+        renderedSource,
+        renderVersion,
+      })) {
+        return;
+      }
       shell.querySelector('.mermaid-placeholder-card')?.remove();
       const diagram = document.createElement('div');
@@ -208,7 +240,7 @@ export class MermaidPreviewHydrator extends DiagramPreviewHydrator {
           return;
         }
-        this.enhanceDiagram(shell, diagram, renderedSource);
+        this.enhanceDiagram(shell, diagram, renderedSource, renderCacheKey);
         this.markShellHydrated(shell);
       } finally {
         renderHost.remove();
@@ -326,21 +358,30 @@ export class MermaidPreviewHydrator extends DiagramPreviewHydrator {
     }
   }
-  enhanceDiagram(shell, renderedDiagram, renderedSource = '') {
+  enhanceDiagram(shell, renderedDiagram, renderedSource = '', renderCacheKey = null) {
     const svg = renderedDiagram.querySelector('svg');
     if (!svg) {
       renderedDiagram.remove();
       return;
     }
     const { width: baseWidth, height: baseHeight } = normalizeMermaidSvg(svg);
+    if (renderCacheKey) {
+      // The markup is already normalized (viewBox/size set), so a cache hit
+      // can mount without another mermaid run or layout measurement.
+      this.storeRenderCache(renderCacheKey, svg.outerHTML);
+    }
+    renderedDiagram.remove();
+    this.mountDiagramSvg(shell, svg, { baseWidth, baseHeight, renderedSource });
+  }
+  mountDiagramSvg(shell, svg, { baseWidth, baseHeight, renderedSource = '' } = {}) {
     const exportFileNames = () => createDiagramExportFileNames({
       currentFilePath: this.renderer.getSourceFilePath?.() ?? '',
       diagramKind: 'mermaid',
       sourceLine: shell.getAttribute('data-source-line') || '',
       targetPath: shell.dataset.mermaidTarget || '',
     });
-    renderedDiagram.remove();
     this.diagramChrome.mount(shell, {
       baseHeight,
       baseWidth,
@@ -353,4 +394,49 @@ export class MermaidPreviewHydrator extends DiagramPreviewHydrator {
     shell._diagramRenderedSource = renderedSource;
   }
+  tryMountCachedDiagram(shell, {
+    hydrationToken,
+    renderCacheKey,
+    renderedSource = '',
+    renderVersion,
+  } = {}) {
+    const cachedSvgMarkup = this.renderCache.get(renderCacheKey) ?? null;
+    if (!cachedSvgMarkup) {
+      return false;
+    }
+    shell.querySelector('.mermaid-placeholder-card')?.remove();
+    const svg = parseCachedSvgMarkup(cachedSvgMarkup);
+    if (
+      this.isHydrationCurrent(renderVersion, shell, hydrationToken)
+      && svg
+    ) {
+      const { width, height } = resolveSvgDimensions(svg);
+      this.mountDiagramSvg(shell, svg, { baseWidth: width, baseHeight: height, renderedSource });
+      this.markShellHydrated(shell);
+      return true;
+    }
+    this.renderCache.delete(renderCacheKey);
+    return false;
+  }
+  getRenderCacheKey(preparedSource) {
+    return `${this.currentTheme}\n${preparedSource}`;
+  }
+  storeRenderCache(key, markup) {
+    if (!key || !markup) {
+      return;
+    }
+    if (this.renderCache.has(key)) {
+      this.renderCache.delete(key);
+    }
+    while (this.renderCache.size >= MERMAID_RENDER_CACHE_LIMIT) {
+      this.renderCache.delete(this.renderCache.keys().next().value);
+    }
+    this.renderCache.set(key, markup);
+  }
 }

package/src/client/application/preview-diagram-utils.js CHANGED Viewed

@@ -1,5 +1,6 @@
 export const IDLE_RENDER_TIMEOUT_MS = 500;
 export const MERMAID_BATCH_SIZE = 2;
+export const MERMAID_RENDER_CACHE_LIMIT = 30;
 export const PLANTUML_BATCH_SIZE = 2;
 export {

package/src/client/application/preview-render-compiler.js CHANGED Viewed

@@ -1,4 +1,5 @@
 import markdownIt from 'markdown-it';
+import { enableMarkdownMath } from '../domain/markdown-math.js';
 import { isImageAttachmentFilePath } from '../../domain/file-kind.js';
 import { resolveVaultRelativePath } from '../../domain/vault-paths.js';
@@ -389,6 +390,7 @@ function createMarkdownRenderer(fileList = [], {
     linkify: true,
     typographer: true,
   });
+  enableMarkdownMath(markdown);
   markdown.core.ruler.push('collabmd-source-lines', (state) => {
     state.tokens.forEach((token) => {

package/src/client/application/preview-render-executor.js CHANGED Viewed

@@ -85,7 +85,10 @@ export class PreviewRenderExecutor {
     if (worker) {
       if (this.workerJob) {
-        this.reset('Superseded preview render');
+        // Reject the superseded job but keep the worker alive: the stale
+        // result is ignored by renderVersion in handleWorkerMessage, and
+        // respawning the worker per keystroke costs a module re-parse.
+        this.cancelWorkerJob('Superseded preview render');
       }
       const activeWorker = this.ensureWorker();

package/src/client/application/preview-render-profile.js CHANGED Viewed

@@ -4,6 +4,7 @@ export const LARGE_DOCUMENT_EXCALIDRAW_THRESHOLD = 8;
 export const LARGE_DOCUMENT_DRAWIO_THRESHOLD = 8;
 export const LARGE_DOCUMENT_PLANTUML_THRESHOLD = 12;
 export const DIAGRAM_RENDER_DEBOUNCE_MS = 300;
+export const DEFAULT_RENDER_DEBOUNCE_MS = 250;
 function countMatches(source, pattern) {
   return source.match(pattern)?.length ?? 0;
@@ -38,30 +39,25 @@ export function isLargeDocumentStats(stats) {
 }
 export function getRenderProfile(markdownText = '') {
-  const source = String(markdownText);
-  const hasMermaid = /(^|\n)```mermaid\b/i.test(source)
-    || /!\[\[[^\]]+\.(?:mmd|mermaid)(?:\|[^\]]+)?\]\]/i.test(source);
-  const hasDrawioEmbed = /!\[\[[^\]]+\.drawio(?:\|[^\]]+)?\]\]/i.test(source);
-  const hasExcalidrawEmbed = /!\[\[[^\]]+\.excalidraw(?:\|[^\]]+)?\]\]/i.test(source);
-  const hasPlantUml = /(^|\n)```(?:plantuml|puml)\b/i.test(source)
-    || /!\[\[[^\]]+\.(?:puml|plantuml)(?:\|[^\]]+)?\]\]/i.test(source);
-  const isLargeByLength = source.length >= LARGE_DOCUMENT_CHAR_THRESHOLD;
+  // Reuse the single complexity scan instead of re-running the same regexes:
+  // this previously cost ~10 full-source scans per keystroke.
+  const stats = analyzeMarkdownComplexity(markdownText);
-  if (isLargeByLength) {
+  if (stats.chars >= LARGE_DOCUMENT_CHAR_THRESHOLD) {
     return {
       debounceMs: 500,
       deferUntilIdle: true,
     };
   }
-  if (hasMermaid || hasPlantUml) {
+  if (stats.mermaidBlocks > 0 || stats.plantumlBlocks > 0) {
     return {
       debounceMs: DIAGRAM_RENDER_DEBOUNCE_MS,
       deferUntilIdle: false,
     };
   }
-  if (hasDrawioEmbed || hasExcalidrawEmbed) {
+  if (stats.drawioEmbeds > 0 || stats.excalidrawEmbeds > 0) {
     return {
       debounceMs: 0,
       deferUntilIdle: false,
@@ -69,7 +65,7 @@ export function getRenderProfile(markdownText = '') {
   }
   return {
-    debounceMs: 100,
+    debounceMs: DEFAULT_RENDER_DEBOUNCE_MS,
     deferUntilIdle: false,
   };
 }

package/src/client/application/preview-renderer.js CHANGED Viewed

@@ -313,6 +313,7 @@ export class PreviewRenderer {
   commitBaseRender({ html, stats }, renderVersion) {
+    const scrollTop = this.previewContainer?.scrollTop ?? 0;
     this.activeRenderVersion = renderVersion;
     this.readyRenderVersion = 0;
     this.currentStats = stats;
@@ -334,6 +335,8 @@ export class PreviewRenderer {
     this.applyFrontmatterState();
     this.mermaidHydrator.reconcileHydratedShells();
     this.plantUmlHydrator.reconcileHydratedShells();
+    // Detaching diagrams can temporarily shrink the document and clamp scrolling.
+    if (this.previewContainer) this.previewContainer.scrollTop = scrollTop;
     this.setPhase('base');
     this.outlineController.refresh();

package/src/client/bootstrap/collabmd-app-shell.js CHANGED Viewed

@@ -221,12 +221,21 @@ export class CollabMdAppShell {
             signal: options?.signal,
           })
         : callAgentTool(name, input, options),
-      getActiveContext: () => ({
-        activeDiagramPath: this.isExcalidrawFile(this.currentFilePath)
-          ? this.currentFilePath
-          : null,
-        activePath: this.currentFilePath,
-      }),
+      getActiveContext: async () => {
+        const activePath = this.currentFilePath;
+        const session = this.session;
+        const context = session?.activeFilePath === activePath
+          ? await session.getAgentContext()
+          : null;
+        if (activePath !== this.currentFilePath || session !== this.session) {
+          throw new Error('Active document changed; request active context again');
+        }
+        return {
+          ...context,
+          activeDiagramPath: this.isExcalidrawFile(activePath) ? activePath : null,
+          activePath,
+        };
+      },
       getIsTabActive: () => this.isTabActive,
       onDidMutate: () => {
         this.toastController.show('Agent-assisted Vault change applied. Review it before committing.');
@@ -290,7 +299,7 @@ export class CollabMdAppShell {
       enabled: this.runtimeConfig.gitEnabled !== false,
       gitApiClient: this.gitApiClient,
       onCommitStaged: () => this.openGitCommitDialog(),
-      onOpenPullBackup: (filePath) => filePath && this.navigation.navigateToFile(filePath),
+      onOpenPullBackup: (backupId) => backupId && window.open(gitApiClient.getPullBackupSummaryUrl(backupId), '_blank', 'noopener,noreferrer'),
       onPullBranch: () => this.pullGitBranch(),
       onPushBranch: () => this.pushGitBranch(),
       onRepoChange: (isGitRepo, status) => this.handleGitRepoChange(isGitRepo, status),

package/src/client/browser-utils.js CHANGED Viewed

@@ -83,7 +83,7 @@ export function isNearViewport(element, root, marginPx) {
 }
 export function downloadBlob(blob, fileName, {
-  removeDelayMs = 30_000,
+  removeDelayMs = 1000,
   revokeDelayMs = removeDelayMs,
 } = {}) {
   const windowRef = getWindowRef();

package/src/client/domain/excalidraw-scene.js CHANGED Viewed

@@ -84,17 +84,6 @@ export function createExcalidrawExportOptions(scene, {
   };
 }
-export function buildStoredScene(elements, appState, files) {
-  return normalizeScene({
-    elements: elements.filter((element) => !element.isDeleted),
-    appState: {
-      gridSize: appState.gridSize ?? null,
-      viewBackgroundColor: appState.viewBackgroundColor ?? '#ffffff',
-    },
-    files: files || {},
-  });
-}
 export function buildLiveCollaborationScene(elements, appState, files) {
   return normalizeScene({
     elements: Array.isArray(elements) ? elements : [],

package/src/client/domain/file-search.js CHANGED Viewed

@@ -40,6 +40,7 @@ export function createFileSearchEntry(filePath) {
   const rawFileName = String(filePath ?? '').split('/').pop() || String(filePath ?? '');
   return {
+    dirPath: displayName.includes('/') ? displayName.slice(0, displayName.lastIndexOf('/')) : '',
     displayName,
     fileName,
     filePath,

package/src/client/domain/highlight-runtime.js CHANGED Viewed

@@ -38,10 +38,37 @@ hljs.registerAliases(['ecmascript', 'node'], { languageName: 'javascript' });
 export { hljs };
+// Unchanged fences re-highlight on every preview compile while typing, so
+// memoize results. Huge one-off sources bypass the cache to bound memory.
+const HIGHLIGHT_CACHE_LIMIT = 200;
+const HIGHLIGHT_CACHE_MAX_SOURCE_CHARS = 20000;
+const highlightCache = new Map();
+export function getHighlightCacheSize() {
+  return highlightCache.size;
+}
 export function highlightFence(source, language, { ignoreIllegals = false } = {}) {
-  if (language && hljs.getLanguage(language)) {
-    return hljs.highlight(source, { ignoreIllegals, language }).value;
+  const text = String(source);
+  const cacheable = text.length <= HIGHLIGHT_CACHE_MAX_SOURCE_CHARS;
+  const cacheKey = cacheable ? `${language ?? ''}\n${ignoreIllegals ? 1 : 0}\n${text}` : null;
+  if (cacheKey) {
+    const cached = highlightCache.get(cacheKey);
+    if (cached !== undefined) {
+      return cached;
+    }
+  }
+  const result = language && hljs.getLanguage(language)
+    ? hljs.highlight(text, { ignoreIllegals, language }).value
+    : hljs.highlightAuto(text, AUTO_HIGHLIGHT_LANGUAGES).value;
+  if (cacheKey) {
+    if (highlightCache.size >= HIGHLIGHT_CACHE_LIMIT) {
+      highlightCache.delete(highlightCache.keys().next().value);
+    }
+    highlightCache.set(cacheKey, result);
   }
-  return hljs.highlightAuto(source, AUTO_HIGHLIGHT_LANGUAGES).value;
+  return result;
 }

package/src/client/domain/markdown-math.js ADDED Viewed

@@ -0,0 +1,14 @@
+import katex from 'katex';
+import katexPluginModule from '@vscode/markdown-it-katex';
+const katexPlugin = katexPluginModule?.default ?? katexPluginModule;
+const RENDERED_MATH_PATTERN = /class="katex(?:-block|-error)?"/u;
+export function enableMarkdownMath(markdown) {
+  markdown.use(katexPlugin, { katex, strict: false, throwOnError: false, trust: false });
+}
+export function hasRenderedMath(html = '') {
+  return RENDERED_MATH_PATTERN.test(String(html ?? ''));
+}