collabmd 0.1.43 → 0.1.45

package/src/client/browser-utils.js

@@ -0,0 +1,77 @@
+function getWindowRef() {
+  return typeof window === 'undefined' ? globalThis : window;
+}
+
+export function requestIdleRender(callback, timeout) {
+  const windowRef = getWindowRef();
+  if (typeof windowRef.requestIdleCallback === 'function') {
+    return windowRef.requestIdleCallback(callback, { timeout });
+  }
+
+  return windowRef.setTimeout(() => callback({ didTimeout: false, timeRemaining: () => 0 }), 1);
+}
+
+export function cancelIdleRender(id) {
+  if (id === null) {
+    return;
+  }
+
+  const windowRef = getWindowRef();
+  if (typeof windowRef.cancelIdleCallback === 'function') {
+    windowRef.cancelIdleCallback(id);
+    return;
+  }
+
+  windowRef.clearTimeout(id);
+}
+
+export function isNearViewport(element, root, marginPx) {
+  if (!element || !root) {
+    return false;
+  }
+
+  const rootRect = root.getBoundingClientRect();
+  const elementRect = element.getBoundingClientRect();
+  return (
+    elementRect.bottom >= (rootRect.top - marginPx)
+    && elementRect.top <= (rootRect.bottom + marginPx)
+  );
+}
+
+export function downloadBlob(blob, fileName, {
+  removeDelayMs = 30_000,
+  revokeDelayMs = removeDelayMs,
+} = {}) {
+  const windowRef = getWindowRef();
+  const downloadUrl = URL.createObjectURL(blob);
+  const anchor = document.createElement('a');
+  anchor.href = downloadUrl;
+  anchor.download = fileName;
+  if (anchor.style) {
+    anchor.style.display = 'none';
+  }
+  document.body.appendChild(anchor);
+  anchor.click();
+
+  if (removeDelayMs > 0) {
+    windowRef.setTimeout(() => anchor.remove(), removeDelayMs);
+  } else {
+    anchor.remove();
+  }
+
+  windowRef.setTimeout(() => URL.revokeObjectURL(downloadUrl), revokeDelayMs);
+}
+
+export function parseDownloadFileName(contentDisposition = '', fallbackName = 'download') {
+  const utfMatch = String(contentDisposition).match(/filename\*=UTF-8''([^;]+)/iu);
+  if (utfMatch) {
+    try {
+      return decodeURIComponent(utfMatch[1]);
+    } catch {
+      return fallbackName;
+    }
+  }
+
+  const asciiMatch = String(contentDisposition).match(/filename="([^"]+)"/iu);
+  return asciiMatch?.[1] || fallbackName;
+}

package/src/client/domain/excalidraw-api-scene-sync.js

@@ -32,7 +32,7 @@ export function buildExcalidrawFileSyncPlan(currentFiles = {}, nextFiles = {}) {
   return {
     conflictingFileIds,
     missingFiles,
-    requiresRemount: conflictingFileIds.length > 0,
+    requiresFileReplacement: conflictingFileIds.length > 0,
   };
 }
 
@@ -46,15 +46,18 @@ export function applySceneUpdateWithFiles(api, {
   const currentFiles = api?.getFiles?.() || {};
   const syncPlan = buildExcalidrawFileSyncPlan(currentFiles, files);
 
-  if (syncPlan.requiresRemount) {
+  if (syncPlan.requiresFileReplacement && typeof api?.replaceFiles !== 'function') {
     onFileConflict(syncPlan);
     return {
       ...syncPlan,
       applied: false,
+      requiresRemount: true,
     };
   }
 
-  if (syncPlan.missingFiles.length > 0) {
+  if (syncPlan.requiresFileReplacement) {
+    api.replaceFiles(Object.values(files));
+  } else if (syncPlan.missingFiles.length > 0) {
     api.addFiles(syncPlan.missingFiles);
   }
 
@@ -66,5 +69,6 @@ export function applySceneUpdateWithFiles(api, {
   return {
     ...syncPlan,
     applied: true,
+    requiresRemount: false,
   };
 }

package/src/client/domain/excalidraw-collaboration.js

@@ -1,4 +1,4 @@
-import { normalizeUserName } from './excalidraw-scene.js';
+import { generatePeerId, normalizeUserName } from './room.js';
 
 export const USER_COLOR_PALETTE = [
   '#ef4444', '#f97316', '#eab308', '#22c55e', '#06b6d4',
@@ -16,12 +16,6 @@ export function hashString(value) {
   return Math.abs(hash);
 }
 
-export function generatePeerId() {
-  const bytes = new Uint8Array(8);
-  globalThis.crypto?.getRandomValues?.(bytes);
-  return Array.from(bytes, (byte) => byte.toString(16).padStart(2, '0')).join('');
-}
-
 export function pickFallbackColor(seed) {
   return USER_COLOR_PALETTE[hashString(seed) % USER_COLOR_PALETTE.length];
 }

package/src/client/domain/excalidraw-diagnostics.js

@@ -0,0 +1,111 @@
+const DEFAULT_DIAGNOSTIC_LIMIT = 500;
+
+const ALLOWED_DETAIL_KEYS = new Set([
+  'action',
+  'canWrite',
+  'connectionState',
+  'elementCount',
+  'fileCount',
+  'generation',
+  'hasPendingWrites',
+  'outcome',
+  'previousState',
+  'reason',
+  'sceneHash',
+  'state',
+  'tombstoneCount',
+]);
+
+function normalizeDetailValue(value) {
+  if (typeof value === 'boolean' || typeof value === 'string') {
+    return value;
+  }
+
+  if (typeof value === 'number' && Number.isFinite(value)) {
+    return value;
+  }
+
+  return undefined;
+}
+
+function hashString(value) {
+  let hash = 0x811c9dc5;
+  for (let index = 0; index < value.length; index += 1) {
+    hash ^= value.charCodeAt(index);
+    hash = Math.imul(hash, 0x01000193);
+  }
+  return (hash >>> 0).toString(16).padStart(8, '0');
+}
+
+export function summarizeExcalidrawScene(scene = {}) {
+  const elements = Array.isArray(scene?.elements) ? scene.elements : [];
+  const files = scene?.files && typeof scene.files === 'object' ? scene.files : {};
+  const signature = elements
+    .map((element) => [
+      element?.id || '',
+      element?.type || '',
+      Number(element?.version) || 0,
+      Number(element?.versionNonce) || 0,
+      element?.isDeleted ? 1 : 0,
+      element?.fileId || '',
+    ].join(':'))
+    .sort()
+    .join('|');
+
+  return {
+    elementCount: elements.length,
+    fileCount: Object.keys(files).length,
+    sceneHash: hashString(signature),
+    tombstoneCount: elements.filter((element) => element?.isDeleted).length,
+  };
+}
+
+export function createExcalidrawDiagnosticRing({
+  enabled = false,
+  limit = DEFAULT_DIAGNOSTIC_LIMIT,
+  now = () => performance.now(),
+} = {}) {
+  const entries = [];
+  const normalizedLimit = Math.max(1, Number(limit) || DEFAULT_DIAGNOSTIC_LIMIT);
+  let sequence = 0;
+
+  function record(event, details = {}) {
+    if (!enabled) {
+      return null;
+    }
+
+    const entry = {
+      event: String(event || 'unknown'),
+      sequence: ++sequence,
+      timestampMs: Math.round(Number(now()) || 0),
+    };
+
+    Object.entries(details).forEach(([key, value]) => {
+      if (!ALLOWED_DETAIL_KEYS.has(key)) {
+        return;
+      }
+
+      const normalizedValue = normalizeDetailValue(value);
+      if (normalizedValue !== undefined) {
+        entry[key] = normalizedValue;
+      }
+    });
+
+    entries.push(entry);
+    if (entries.length > normalizedLimit) {
+      entries.splice(0, entries.length - normalizedLimit);
+    }
+    return entry;
+  }
+
+  return {
+    clear() {
+      entries.length = 0;
+    },
+    enabled: Boolean(enabled),
+    exportTrace() {
+      return entries.map((entry) => ({ ...entry }));
+    },
+    record,
+  };
+}

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

@@ -1,6 +1,5 @@
-export function normalizeUserName(value) {
-  const normalized = String(value || '').trim().replace(/\s+/g, ' ');
-  return normalized ? normalized.slice(0, 24) : null;
+export function normalizeDocumentMode(mode) {
+  return mode === 'preview' ? 'preview' : 'edit';
 }
 
 export function createEmptyScene() {

package/src/client/domain/room.js

@@ -9,14 +9,40 @@ const USER_COLORS = [
 ];
 export const USER_NAME_MAX_LENGTH = 24;
 const LOCAL_USER_ID_STORAGE_KEY = 'collabmd-user-id';
+const HEX_COLOR_RE = /^#(?:[\da-f]{3}|[\da-f]{6})$/iu;
+
+function colorChannelToLinear(value) {
+  const channel = value / 255;
+  return channel <= 0.04045
+    ? channel / 12.92
+    : ((channel + 0.055) / 1.055) ** 2.4;
+}
+
+function getColorLuminance(color) {
+  const hex = color.length === 4
+    ? color.slice(1).split('').map((channel) => channel.repeat(2)).join('')
+    : color.slice(1);
+  const [red, green, blue] = hex.match(/../gu).map((channel) => parseInt(channel, 16));
+  return (
+    0.2126 * colorChannelToLinear(red)
+    + 0.7152 * colorChannelToLinear(green)
+    + 0.0722 * colorChannelToLinear(blue)
+  );
+}
+
+function getContrastRatio(firstLuminance, secondLuminance) {
+  const lighter = Math.max(firstLuminance, secondLuminance);
+  const darker = Math.min(firstLuminance, secondLuminance);
+  return (lighter + 0.05) / (darker + 0.05);
+}
 
 function pickRandom(items) {
   return items[Math.floor(Math.random() * items.length)];
 }
 
-function generatePeerId() {
+export function generatePeerId() {
   const array = new Uint8Array(8);
-  (globalThis.crypto ?? {}).getRandomValues?.(array);
+  globalThis.crypto?.getRandomValues?.(array);
   return Array.from(array, (b) => b.toString(16).padStart(2, '0')).join('');
 }
 
@@ -73,6 +99,18 @@ export function normalizeUserName(value) {
   return normalized || null;
 }
 
+export function getUserAvatarTextColor(value) {
+  const color = String(value ?? '').trim();
+  if (!HEX_COLOR_RE.test(color)) {
+    return '#fff';
+  }
+
+  const luminance = getColorLuminance(color.toLowerCase());
+  const whiteContrast = getContrastRatio(1, luminance);
+  const inkContrast = getContrastRatio(0, luminance);
+  return inkContrast >= whiteContrast ? '#000' : '#fff';
+}
+
 export function createRandomUser(preferredName = null) {
   const color = pickRandom(USER_COLORS);
 

package/src/client/domain/vault-paths.js

@@ -37,6 +37,20 @@ export function composeVaultChildPath(parentDir, childPath) {
   return `${normalizedParent}/${normalizedChild}`;
 }
 
+export function getVaultPathLeaf(pathValue = '') {
+  return String(pathValue ?? '')
+    .replace(/\/+$/u, '')
+    .split('/')
+    .filter(Boolean)
+    .pop() || '';
+}
+
+export function getVaultPathParent(pathValue = '') {
+  const normalized = String(pathValue ?? '').replace(/\/+$/u, '');
+  const separatorIndex = normalized.lastIndexOf('/');
+  return separatorIndex >= 0 ? normalized.slice(0, separatorIndex) : '';
+}
+
 export function ensureVaultExtension(pathValue, extension) {
   return pathValue.toLowerCase().endsWith(extension.toLowerCase())
     ? pathValue

package/src/client/domain/vault-utils.js

@@ -1,5 +1,3 @@
-import { resolveWikiTargetPath } from '../../domain/wiki-link-resolver.js';
-
 /**
  * Shared utilities for vault file operations and HTML escaping.
  */
@@ -20,22 +18,6 @@ export function escapeHtml(text) {
     .replace(/'/g, ''');
 }
 
-/**
- * Resolves a wiki-link target (e.g. "My Note") to an existing vault file path.
- *
- * Matching rules (in order):
- *   1. Exact path match (with .md appended if missing)
- *   2. Exact path without .md extension matches the target
- *   3. Filename/path suffix match at any directory depth
- *
- * @param {string} target — the raw wiki-link target text
- * @param {string[]} files — list of vault file paths
- * @returns {string | undefined} matched file path, or undefined if unresolved
- */
-export function resolveWikiTarget(target, files) {
-  return resolveWikiTargetPath(target, files) ?? undefined;
-}
-
 /**
  * Clamps a numeric value between a minimum and maximum bound.
  *
@@ -47,49 +29,3 @@ export function resolveWikiTarget(target, files) {
 export function clamp(value, min, max) {
   return Math.min(Math.max(value, min), max);
 }
-
-function normalizePathSegments(pathValue) {
-  return String(pathValue ?? '')
-    .replace(/\\/g, '/')
-    .split('/')
-    .filter(Boolean);
-}
-
-export function resolveVaultRelativePath(fromFilePath, relativePath) {
-  const sourceSegments = normalizePathSegments(fromFilePath);
-  const targetSegments = String(relativePath ?? '')
-    .split('/')
-    .map((segment) => {
-      try {
-        return decodeURIComponent(segment);
-      } catch {
-        return segment;
-      }
-    });
-
-  if (targetSegments.length === 0) {
-    return '';
-  }
-
-  sourceSegments.pop();
-  const resolvedSegments = [...sourceSegments];
-
-  for (const rawSegment of targetSegments) {
-    const segment = String(rawSegment ?? '').trim();
-    if (!segment || segment === '.') {
-      continue;
-    }
-
-    if (segment === '..') {
-      if (resolvedSegments.length === 0) {
-        return '';
-      }
-      resolvedSegments.pop();
-      continue;
-    }
-
-    resolvedSegments.push(segment);
-  }
-
-  return resolvedSegments.join('/');
-}