@typefm/react-markdown-viewer 0.1.0

package/dist/lib/morph.js

@@ -0,0 +1,204 @@
+import Idiomorph from 'idiomorph/dist/idiomorph.cjs.js';
+// --------------------------------------------------------------------------
+// Hashing Utility
+// --------------------------------------------------------------------------
+/** Simple djb2 hash for fast string comparison */
+function simpleHash(str) {
+    let hash = 5381;
+    for (let i = 0; i < str.length; i++) {
+        hash = ((hash << 5) + hash) ^ str.charCodeAt(i);
+    }
+    return `${str.length}:${hash >>> 0}`;
+}
+/** Per-container morph state - auto-cleaned when element is GC'd */
+const morphStates = new WeakMap();
+/** Get or create state for a container */
+function getState(container) {
+    let state = morphStates.get(container);
+    if (!state) {
+        state = {
+            prevHashes: [],
+            contentHash: '',
+            lastStats: { updated: 0, skipped: 0, added: 0, removed: 0 }
+        };
+        morphStates.set(container, state);
+    }
+    return state;
+}
+// --------------------------------------------------------------------------
+// Shared Idiomorph Configuration
+// --------------------------------------------------------------------------
+const IDIOMORPH_OPTIONS = {
+    morphStyle: 'innerHTML',
+    callbacks: {
+        // Prevent removal of nodes with data-morph-ignore attribute
+        beforeNodeRemoved: (node) => {
+            if (node instanceof Element && node.hasAttribute('data-morph-ignore')) {
+                return false;
+            }
+            return true;
+        }
+    }
+};
+// --------------------------------------------------------------------------
+// RAF-Batched Morphing (for non-streaming updates)
+// --------------------------------------------------------------------------
+// Track pending RAF to avoid stacking
+let pendingMorph = null;
+let pendingElement = null;
+let pendingHtml = null;
+/**
+ * Morph the content of an element using Idiomorph
+ * Uses requestAnimationFrame to batch updates and prevent jank
+ *
+ * @param element The container element to morph
+ * @param newHtml The new HTML content
+ */
+export function morphContent(element, newHtml) {
+    const newHash = simpleHash(newHtml);
+    const state = getState(element);
+    // Fast path: skip if content unchanged
+    if (state.contentHash === newHash)
+        return;
+    // Store for pending morph
+    pendingElement = element;
+    pendingHtml = newHtml;
+    // Cancel any pending morph and schedule new one
+    if (pendingMorph !== null) {
+        cancelAnimationFrame(pendingMorph);
+    }
+    pendingMorph = requestAnimationFrame(() => {
+        if (pendingElement && pendingHtml !== null) {
+            const pendingState = getState(pendingElement);
+            pendingState.contentHash = newHash;
+            Idiomorph.morph(pendingElement, pendingHtml, IDIOMORPH_OPTIONS);
+        }
+        pendingMorph = null;
+        pendingElement = null;
+        pendingHtml = null;
+    });
+}
+/**
+ * Morph content synchronously (for testing or immediate updates)
+ *
+ * @param element The container element to morph
+ * @param newHtml The new HTML content
+ */
+export function morphContentSync(element, newHtml) {
+    const newHash = simpleHash(newHtml);
+    const state = getState(element);
+    // Fast path: skip if content unchanged
+    if (state.contentHash === newHash)
+        return;
+    state.contentHash = newHash;
+    Idiomorph.morph(element, newHtml, IDIOMORPH_OPTIONS);
+}
+/**
+ * Reset morph state for a specific container, or clear all pending operations
+ *
+ * @param container Optional container to reset state for
+ */
+export function resetMorphCache(container) {
+    if (container) {
+        // Reset specific container's state
+        morphStates.delete(container);
+    }
+    // Cancel any pending morph
+    if (pendingMorph !== null) {
+        cancelAnimationFrame(pendingMorph);
+        pendingMorph = null;
+    }
+    pendingElement = null;
+    pendingHtml = null;
+}
+// --------------------------------------------------------------------------
+// Element-Level Optimized Morphing (for streaming)
+// --------------------------------------------------------------------------
+/**
+ * Get morph stats for a specific container
+ *
+ * @param container The container to get stats for
+ * @returns Stats from the last morph operation on this container
+ */
+export function getMorphStats(container) {
+    if (!container) {
+        // Fallback for backwards compatibility - return empty stats
+        return { updated: 0, skipped: 0, added: 0, removed: 0 };
+    }
+    return getState(container).lastStats;
+}
+/**
+ * Optimized morph that skips unchanged elements
+ *
+ * Strategy:
+ * 1. Parse new HTML into temp container
+ * 2. Hash each top-level element
+ * 3. Compare with previous hashes for this container
+ * 4. Only morph elements that changed
+ *
+ * @param container The container element to morph
+ * @param newHtml The new HTML content
+ * @returns true if any elements were updated
+ */
+export function morphContentOptimized(container, newHtml) {
+    const state = getState(container);
+    // Parse new HTML into temp container
+    const temp = document.createElement('div');
+    temp.innerHTML = newHtml;
+    const newHashes = [];
+    const stats = { updated: 0, skipped: 0, added: 0, removed: 0 };
+    const oldLen = container.children.length;
+    const newLen = temp.children.length;
+    const maxLen = Math.max(oldLen, newLen);
+    // Process each element position
+    for (let i = 0; i < maxLen; i++) {
+        const oldChild = container.children[i];
+        const newChild = temp.children[i];
+        if (!newChild && oldChild) {
+            // Element removed - will handle after loop to avoid index shifting
+            continue;
+        }
+        if (!newChild)
+            continue;
+        const newHash = simpleHash(newChild.outerHTML);
+        newHashes.push(newHash);
+        if (!oldChild) {
+            // New element - append (clone since temp will be discarded)
+            container.appendChild(newChild.cloneNode(true));
+            stats.added++;
+        }
+        else if (state.prevHashes[i] !== newHash) {
+            // Element changed - morph it
+            Idiomorph.morph(oldChild, newChild.outerHTML, {
+                morphStyle: 'outerHTML',
+                callbacks: IDIOMORPH_OPTIONS.callbacks
+            });
+            stats.updated++;
+        }
+        else {
+            // Element unchanged - skip!
+            stats.skipped++;
+        }
+    }
+    // Remove extra elements from the end (if any)
+    while (container.children.length > newLen) {
+        container.lastElementChild?.remove();
+        stats.removed++;
+    }
+    // Update state for this container
+    state.prevHashes = newHashes;
+    state.lastStats = stats;
+    return stats.updated > 0 || stats.added > 0 || stats.removed > 0;
+}
+/**
+ * Reset element-level morph state for a container
+ * Note: Usually not needed since WeakMap auto-cleans when element is GC'd
+ *
+ * @param container Optional container to reset (if omitted, does nothing - use resetMorphCache)
+ */
+export function resetElementMorphState(container) {
+    if (container) {
+        morphStates.delete(container);
+    }
+}
+//# sourceMappingURL=morph.js.map

package/dist/lib/morph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"morph.js","sourceRoot":"","sources":["../../src/lib/morph.ts"],"names":[],"mappings":"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"}

package/dist/lib/parser.d.ts

@@ -0,0 +1,32 @@
+import { onLanguageLoaded, offLanguageLoaded, getNotificationGeneration } from "./highlighter";
+import type { RenderHooks } from "../types/hooks";
+import { preloadKaTeX as defaultPreloadKaTeX, isKaTeXReady as defaultIsKaTeXReady } from "./defaults/math";
+export { onLanguageLoaded, offLanguageLoaded, getNotificationGeneration };
+export declare const preloadKaTeX: typeof defaultPreloadKaTeX;
+export declare const isKaTeXReady: typeof defaultIsKaTeXReady;
+/**
+ * Cursor marker string and HTML replacement
+ * Word Joiner (U+2060) - invisible character used to mark cursor position.
+ * We use WJ instead of ZWSP (U+200B) because source markdown may contain ZWSP
+ * which gets escaped to HTML entities. WJ is rarely used in source text.
+ */
+export declare const CURSOR_MARKER = "\u2060";
+export declare const CURSOR_HTML = "<span class='cursor' data-cursor></span>";
+/**
+ * Sanitize HTML to remove XSS vectors while preserving safe content.
+ */
+export declare function sanitizeHtml(html: string): string;
+export interface ColorOptions {
+    fences: boolean;
+    inline: boolean;
+}
+/**
+ * Render Markdown to HTML using @typefm/comrak-wasm + Post-processing.
+ *
+ * @param src Markdown source
+ * @param useSyncStrategy If true, uses sync morph path (streaming).
+ * @param colorOptions Options for color preview injection.
+ * @param hooks Optional hooks for customizing rendering.
+ */
+export declare function renderMarkdown(src: string, useSyncStrategy: boolean, colorOptions?: ColorOptions, hooks?: RenderHooks): string;
+//# sourceMappingURL=parser.d.ts.map

package/dist/lib/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/lib/parser.ts"],"names":[],"mappings":"AAIA,OAAO,EAAa,gBAAgB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC1G,OAAO,KAAK,EACX,WAAW,EAgBX,MAAM,gBAAgB,CAAC;AAMxB,OAAO,EAEN,YAAY,IAAI,mBAAmB,EACnC,YAAY,IAAI,mBAAmB,EAEnC,MAAM,iBAAiB,CAAC;AAKzB,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,CAAC;AAG1E,eAAO,MAAM,YAAY,4BAAsB,CAAC;AAChD,eAAO,MAAM,YAAY,4BAAsB,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,WAAW,CAAC;AACtC,eAAO,MAAM,WAAW,6CAA6C,CAAC;AAmFtE;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA2CjD;AA0DD,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CAChB;AA0HD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC7B,GAAG,EAAE,MAAM,EACX,eAAe,EAAE,OAAO,EACxB,YAAY,GAAE,YAA6C,EAC3D,KAAK,CAAC,EAAE,WAAW,GACjB,MAAM,CA6HR"}