@typefm/react-markdown-viewer 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Janos Veres
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,217 @@
+<p align="center">
+  <img src="./assets/logo.png" alt="react-markdown-viewer" width="80" />
+</p>
+
+<h1 align="center">@typefm/react-markdown-viewer</h1>
+
+<p align="center">
+  <strong>High-performance React component for rendering markdown with streaming support</strong>
+  <br />
+  <em>GitHub-style rendering optimized for LLM chat interfaces</em>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/react-19+-087ea4" alt="React 19+" />
+  <img src="https://img.shields.io/badge/typescript-5+-3178c6" alt="TypeScript" />
+  <img src="https://img.shields.io/badge/license-MIT-green" alt="MIT License" />
+  <img src="https://img.shields.io/badge/styling-GitHub%20Primer-24292f" alt="GitHub Primer" />
+</p>
+
+<p align="center">
+  <a href="#features">Features</a> •
+  <a href="#installation">Installation</a> •
+  <a href="#usage">Usage</a> •
+  <a href="#security">Security</a> •
+  <a href="#demo">Demo</a>
+</p>
+
+---
+
+## Features
+
+- **GitHub-Style Rendering** — Visual parity with GitHub's markdown using Primer design tokens
+- **Streaming Support** — Optimized for real-time LLM output with adaptive throttling and DOM morphing
+- **Element-Level Diffing** — Skips unchanged blocks during streaming (~99% skip rate)
+- **Syntax Highlighting** — GitHub Prettylights theme, 40+ languages via highlight.js with dynamic loading
+- **Math Rendering** — KaTeX with lazy loading
+- **Color Previews** — Auto-detects hex, rgb, hsl colors and shows visual swatches
+- **GitHub Flavored Markdown** — Tables, task lists, strikethrough, alerts, footnotes
+- **Smart Caching** — LRU caches for rendered content, syntax highlighting, and KaTeX output
+- **Cursor Animation** — Blinking cursor during streaming with focus-aware styling
+- **Dark Mode** — CSS-based theming (Tailwind `.dark`, `data-theme`, or OS preference)
+- **Error Boundary** — Built-in error handling with customizable fallback UI
+- **Markdown Healing** — `healMarkdown()` closes unclosed delimiters during streaming
+
+## Architecture
+
+See **[docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md)** for the full internal architecture:
+
+- Rendering pipeline (markdown → WASM parse → sanitize → post-process → DOM)
+- Dual rendering modes (static `dangerouslySetInnerHTML` vs streaming Idiomorph morphing)
+- WASM initialization, streaming throttling, cursor system
+- Caching strategy, hook system, lazy loading
+
+```
+Markdown → comrak-wasm → HTML → Sanitization → Post-Processing → DOM
+               │                      │
+          GFM Extensions          • KaTeX math
+          • Tables                • Syntax highlighting
+          • Task lists            • Color previews
+          • Alerts                • Link security
+          • Math syntax           • Copy buttons
+```
+
+## Installation
+
+```bash
+pnpm add @typefm/react-markdown-viewer
+```
+
+Requires React 19:
+
+```json
+{
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  }
+}
+```
+
+## Usage
+
+```tsx
+import { initMarkdownViewer, MarkdownViewer } from '@typefm/react-markdown-viewer';
+import '@typefm/react-markdown-viewer/styles.css';
+import 'katex/dist/katex.min.css';
+
+// Initialize WASM once at app startup
+await initMarkdownViewer();
+
+function ChatMessage({ content, isStreaming }) {
+  return (
+    <MarkdownViewer
+      text={content}
+      isStreaming={isStreaming}
+      throttleMs={50}
+    />
+  );
+}
+```
+
+### With Error Boundary
+
+```tsx
+import { MarkdownViewerSafe } from '@typefm/react-markdown-viewer';
+
+<MarkdownViewerSafe
+  text={content}
+  isStreaming={isStreaming}
+  fallback={<div>Failed to render markdown</div>}
+  onError={(error) => console.error(error)}
+/>
+```
+
+## Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `text` | `string` | `''` | Markdown source text |
+| `isStreaming` | `boolean` | `false` | Enable streaming mode (throttling + cursor) |
+| `throttleMs` | `number` | `50` | Minimum ms between updates during streaming |
+| `className` | `string` | — | Additional CSS class names |
+| `onStreamingEnd` | `() => void` | — | Callback when streaming ends |
+| `hooks` | `RenderHooks` | — | Customize element rendering |
+
+## Render Hooks
+
+Customize how specific markdown elements are rendered:
+
+```tsx
+import { MarkdownViewer, escapeHtml, type RenderHooks } from '@typefm/react-markdown-viewer';
+
+const hooks: RenderHooks = {
+  onCodeBlock: ({ code, language }) => {
+    if (language === 'mermaid') {
+      return `<div class="mermaid">${escapeHtml(code)}</div>`;
+    }
+    return null; // use default
+  },
+  onLink: ({ href, text }) => {
+    if (href.includes('youtube.com')) {
+      return `<div class="youtube-embed">...</div>`;
+    }
+    return null; // use default
+  },
+  onRender: (html) => html.replace(/TODO/g, '<mark>TODO</mark>'),
+};
+
+<MarkdownViewer text={content} hooks={hooks} />
+```
+
+**Return `string`** for custom HTML, **`null`** to use the default processor.
+
+Available hooks: `onCodeBlock`, `onInlineCode`, `onMath`, `onTable`, `onLink`, `onImage`, `onHeading`, `onBlockquote`, `onAlert`, `onList`, `onHorizontalRule`, `onFootnoteRef`, `onFootnoteDef`, `onRender`.
+
+## Security
+
+See **[docs/SECURITY.md](./docs/SECURITY.md)** for complete security documentation.
+
+7-layer defense-in-depth against XSS:
+
+1. **Comrak tagfilter** — escapes `<script>`, `<iframe>`, `<style>`, etc.
+2. **Tag removal** — removes `<object>`, `<embed>`, `<form>`, `<meta>`, etc.
+3. **Tag unwrapping** — strips `<noscript>`, `<template>` (keeps content)
+4. **Event handler filter** — strips all `on*` attributes
+5. **URL sanitizer** — blocks `javascript:`, `vbscript:`, `data:`, `file:` schemes
+6. **DOM clobbering filter** — removes dangerous `name`/`id` values
+7. **SVG sanitizer** — removes SVG with embedded scripts or event handler injection
+
+```tsx
+// Safe to render untrusted content
+<MarkdownViewer text={userInput} />
+```
+
+## Styling
+
+See **[docs/STYLING.md](./docs/STYLING.md)** for complete styling documentation.
+
+```tsx
+import '@typefm/react-markdown-viewer/styles.css';
+```
+
+Dark mode works automatically via `.dark` class, `data-theme="dark"`, or OS preference. Override CSS custom properties on `.markdown-viewer` to customize colors, fonts, and cursor.
+
+## Demo
+
+```bash
+cd packages/react-markdown-viewer
+pnpm install
+pnpm dev
+```
+
+The playground includes:
+
+- **Playground** — Full showcase, AI chat simulation, stress test, edge cases with custom markdown input
+- **GitHub Comparison** — Side-by-side rendering comparison with GitHub's Markdown API
+
+## Testing
+
+```bash
+pnpm test
+```
+
+Test coverage includes: parser rendering, XSS prevention, streaming edge cases, DOM morphing, syntax highlighting, KaTeX lazy loading, component API, error boundary, cursor placement, and DoS prevention.
+
+## Dependencies
+
+| Package | Purpose | Loading |
+|---------|---------|---------|
+| `@typefm/comrak-wasm` | Markdown parser (Rust/WASM) | Requires init |
+| `highlight.js` | Syntax highlighting | Core bundled, languages lazy loaded |
+| `katex` | Math rendering | Lazy loaded |
+| `idiomorph` | DOM morphing | Bundled |
+
+## License
+
+MIT

package/dist/ErrorBoundary.d.ts

@@ -0,0 +1,25 @@
+import { Component, type ReactNode, type ErrorInfo } from 'react';
+export interface ErrorBoundaryProps {
+    /** Content to render */
+    children: ReactNode;
+    /** Fallback UI when an error occurs */
+    fallback?: ReactNode;
+    /** Callback when an error is caught */
+    onError?: (error: Error, errorInfo: ErrorInfo) => void;
+}
+interface ErrorBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+}
+/**
+ * Error boundary for MarkdownViewer
+ * Catches rendering errors and displays fallback UI
+ */
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    constructor(props: ErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+    render(): ReactNode;
+}
+export {};
+//# sourceMappingURL=ErrorBoundary.d.ts.map

package/dist/ErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../src/ErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAElE,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,QAAQ,EAAE,SAAS,CAAC;IACpB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,uCAAuC;IACvC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;CACxD;AAED,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;gBACtE,KAAK,EAAE,kBAAkB;IAKrC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,kBAAkB;IAIjE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAI3D,MAAM,IAAI,SAAS;CAgBpB"}

package/dist/ErrorBoundary.js

@@ -0,0 +1,29 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Component } from 'react';
+/**
+ * Error boundary for MarkdownViewer
+ * Catches rendering errors and displays fallback UI
+ */
+export class ErrorBoundary extends Component {
+    constructor(props) {
+        super(props);
+        this.state = { hasError: false, error: null };
+    }
+    static getDerivedStateFromError(error) {
+        return { hasError: true, error };
+    }
+    componentDidCatch(error, errorInfo) {
+        this.props.onError?.(error, errorInfo);
+    }
+    render() {
+        if (this.state.hasError) {
+            if (this.props.fallback !== undefined) {
+                return this.props.fallback;
+            }
+            // Default fallback
+            return (_jsx("div", { className: "markdown-viewer-error", role: "alert", children: _jsx("p", { children: "Failed to render markdown" }) }));
+        }
+        return this.props.children;
+    }
+}
+//# sourceMappingURL=ErrorBoundary.js.map

package/dist/ErrorBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.js","sourceRoot":"","sources":["../src/ErrorBoundary.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAkC,MAAM,OAAO,CAAC;AAgBlE;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,SAAiD;IAClF,YAAY,KAAyB;QACnC,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,KAAK,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,wBAAwB,CAAC,KAAY;QAC1C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACnC,CAAC;IAED,iBAAiB,CAAC,KAAY,EAAE,SAAoB;QAClD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACzC,CAAC;IAED,MAAM;QACJ,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACxB,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACtC,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YAC7B,CAAC;YAED,mBAAmB;YACnB,OAAO,CACL,cAAK,SAAS,EAAC,uBAAuB,EAAC,IAAI,EAAC,OAAO,YACjD,oDAAgC,GAC5B,CACP,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;CACF"}

package/dist/MarkdownViewer.d.ts

@@ -0,0 +1,41 @@
+import { type ReactNode, type ComponentProps, type Ref } from 'react';
+import type { RenderHooks } from './types/hooks';
+export interface MarkdownViewerRef {
+    /** Reset the component state (call when switching content sources) */
+    reset: () => void;
+    /** Get the container element */
+    getContainer: () => HTMLDivElement | null;
+    /** Focus the viewer (activates cursor) */
+    focus: () => void;
+}
+export interface MarkdownViewerProps extends Omit<ComponentProps<'div'>, 'children' | 'ref'> {
+    /** Markdown source text */
+    text: string;
+    /** Enable streaming mode (throttling + cursor) */
+    isStreaming?: boolean;
+    /** Minimum ms between updates during streaming (default: 50) */
+    throttleMs?: number;
+    /** Callback when streaming ends */
+    onStreamingEnd?: () => void;
+    /** Ref to access imperative methods (React 19+) */
+    ref?: Ref<MarkdownViewerRef>;
+    /** Hooks for customizing markdown rendering */
+    hooks?: RenderHooks;
+}
+/**
+ * High-performance React component for rendering markdown with streaming support,
+ * optimized for LLM chat interfaces.
+ */
+export declare const MarkdownViewer: import("react").NamedExoticComponent<MarkdownViewerProps>;
+export interface MarkdownViewerSafeProps extends Omit<MarkdownViewerProps, 'onError'> {
+    /** Fallback UI when an error occurs */
+    fallback?: ReactNode;
+    /** Callback when a rendering error is caught by the error boundary */
+    onError?: (error: Error) => void;
+}
+/**
+ * MarkdownViewer wrapped with an error boundary.
+ * Catches rendering errors and displays fallback UI instead of crashing.
+ */
+export declare const MarkdownViewerSafe: import("react").NamedExoticComponent<MarkdownViewerSafeProps>;
+//# sourceMappingURL=MarkdownViewer.d.ts.map

package/dist/MarkdownViewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownViewer.d.ts","sourceRoot":"","sources":["../src/MarkdownViewer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,KAAK,GAAG,EAAE,MAAM,OAAO,CAAC;AAGzG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,gCAAgC;IAChC,YAAY,EAAE,MAAM,cAAc,GAAG,IAAI,CAAC;IAC1C,0CAA0C;IAC1C,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;IAC1F,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,mDAAmD;IACnD,GAAG,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC7B,+CAA+C;IAC/C,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,2DAuFzB,CAAC;AAEH,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC;IACnF,uCAAuC;IACvC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,sEAAsE;IACtE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,+DAU7B,CAAC"}

package/dist/MarkdownViewer.js

@@ -0,0 +1,69 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useImperativeHandle, memo, useRef } from 'react';
+import { useMarkdownViewer } from './useMarkdownViewer';
+import { ErrorBoundary } from './ErrorBoundary';
+/**
+ * High-performance React component for rendering markdown with streaming support,
+ * optimized for LLM chat interfaces.
+ */
+export const MarkdownViewer = memo(function MarkdownViewer({ text, isStreaming = false, throttleMs = 50, className, onStreamingEnd, ref, onClick, hooks, ...props }) {
+    const { containerRef, syncMorphEnabled, getRenderedContent, handleClick, reset, } = useMarkdownViewer({
+        text,
+        isStreaming,
+        throttleMs,
+        onStreamingEnd,
+        hooks,
+    });
+    const wrapperRef = useRef(null);
+    // Expose imperative methods
+    useImperativeHandle(ref, () => ({
+        reset,
+        getContainer: () => containerRef.current,
+        focus: () => wrapperRef.current?.focus(),
+    }), [reset]);
+    // Build className without array allocation
+    let rootClassName = 'markdown-viewer';
+    if (className)
+        rootClassName += ' ' + className;
+    // Merge click handlers
+    const handleRootClick = (e) => {
+        handleClick(e);
+        onClick?.(e);
+    };
+    // Shared props for both render paths
+    const rootProps = {
+        ref: wrapperRef,
+        className: rootClassName,
+        onClick: handleRootClick,
+        tabIndex: 0,
+        // Data attributes for state-based styling
+        'data-slot': 'markdown-viewer',
+        'data-state': isStreaming ? 'streaming' : 'idle',
+        // ARIA attributes for accessibility
+        role: 'article',
+        'aria-label': props['aria-label'] ?? 'Markdown content',
+        'aria-busy': isStreaming,
+        ...props,
+    };
+    /*
+     * If `syncMorphEnabled` is TRUE (Streaming or Finished Streaming):
+     * We use DOM morphing via `morphContent`. This patches the DOM intelligently.
+     * It prevents full re-renders and preserves selection.
+     * The content is rendered empty initially and morphed in the hook.
+     *
+     * If `syncMorphEnabled` is FALSE (Initial Static Load):
+     * We use dangerouslySetInnerHTML for speed.
+     */
+    if (syncMorphEnabled) {
+        return (_jsx("div", { ...rootProps, children: _jsx("div", { ref: containerRef, className: "markdown", "data-slot": "markdown-content" }) }));
+    }
+    return (_jsx("div", { ...rootProps, children: _jsx("div", { ref: containerRef, className: "markdown", "data-slot": "markdown-content", dangerouslySetInnerHTML: { __html: getRenderedContent() } }) }));
+});
+/**
+ * MarkdownViewer wrapped with an error boundary.
+ * Catches rendering errors and displays fallback UI instead of crashing.
+ */
+export const MarkdownViewerSafe = memo(function MarkdownViewerSafe({ fallback, onError, ...props }) {
+    return (_jsx(ErrorBoundary, { fallback: fallback, onError: onError, children: _jsx(MarkdownViewer, { ...props }) }));
+});
+//# sourceMappingURL=MarkdownViewer.js.map

package/dist/MarkdownViewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownViewer.js","sourceRoot":"","sources":["../src/MarkdownViewer.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,EAAiD,MAAM,OAAO,CAAC;AACzG,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA2BhD;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,cAAc,CAAC,EACzD,IAAI,EACJ,WAAW,GAAG,KAAK,EACnB,UAAU,GAAG,EAAE,EACf,SAAS,EACT,cAAc,EACd,GAAG,EACH,OAAO,EACP,KAAK,EACL,GAAG,KAAK,EACY;IACpB,MAAM,EACJ,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,KAAK,GACN,GAAG,iBAAiB,CAAC;QACpB,IAAI;QACJ,WAAW;QACX,UAAU;QACV,cAAc;QACd,KAAK;KACN,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAEhD,4BAA4B;IAC5B,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAC9B,KAAK;QACL,YAAY,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO;QACxC,KAAK,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE;KACzC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEb,2CAA2C;IAC3C,IAAI,aAAa,GAAG,iBAAiB,CAAC;IACtC,IAAI,SAAS;QAAE,aAAa,IAAI,GAAG,GAAG,SAAS,CAAC;IAEhD,uBAAuB;IACvB,MAAM,eAAe,GAAG,CAAC,CAAmC,EAAE,EAAE;QAC9D,WAAW,CAAC,CAAC,CAAC,CAAC;QACf,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IACf,CAAC,CAAC;IAEF,qCAAqC;IACrC,MAAM,SAAS,GAAG;QAChB,GAAG,EAAE,UAAU;QACf,SAAS,EAAE,aAAa;QACxB,OAAO,EAAE,eAAe;QACxB,QAAQ,EAAE,CAAC;QACX,0CAA0C;QAC1C,WAAW,EAAE,iBAAiB;QAC9B,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM;QAChD,oCAAoC;QACpC,IAAI,EAAE,SAAkB;QACxB,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,IAAI,kBAAkB;QACvD,WAAW,EAAE,WAAW;QACxB,GAAG,KAAK;KACT,CAAC;IAEF;;;;;;;;OAQG;IACH,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO,CACL,iBAAS,SAAS,YAChB,cAAK,GAAG,EAAE,YAAY,EAAE,SAAS,EAAC,UAAU,eAAW,kBAAkB,GAAG,GACxE,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,iBAAS,SAAS,YAChB,cACE,GAAG,EAAE,YAAY,EACjB,SAAS,EAAC,UAAU,eACV,kBAAkB,EAC5B,uBAAuB,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,GACzD,GACE,CACP,CAAC;AACJ,CAAC,CAAC,CAAC;AASH;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,SAAS,kBAAkB,CAAC,EACjE,QAAQ,EACR,OAAO,EACP,GAAG,KAAK,EACgB;IACxB,OAAO,CACL,KAAC,aAAa,IAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,YACjD,KAAC,cAAc,OAAK,KAAK,GAAI,GACf,CACjB,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export { MarkdownViewer, MarkdownViewerSafe } from "./MarkdownViewer";
+export type { MarkdownViewerProps, MarkdownViewerRef, MarkdownViewerSafeProps, } from "./MarkdownViewer";
+export { ErrorBoundary } from "./ErrorBoundary";
+export type { ErrorBoundaryProps } from "./ErrorBoundary";
+export { useMarkdownViewer } from "./useMarkdownViewer";
+export type { UseMarkdownViewerOptions } from "./useMarkdownViewer";
+export { initMarkdownViewer, initMarkdownViewerSync, isWasmReady, } from "./lib/wasm-init";
+export type { RenderHooks, HookResult, CodeBlockData, InlineCodeData, MathData, TableData, LinkData, ImageData, HeadingData, BlockquoteData, AlertData, AlertType, ListData, HorizontalRuleData, FootnoteRefData, FootnoteDefData, } from "./types/hooks";
+export { processCodeBlock, processInlineCode, injectColorPreviews, type CodeBlockOptions, type InlineCodeOptions, } from "./lib/defaults/code-block";
+export { processMathBlock } from "./lib/defaults/math";
+export { processTable } from "./lib/defaults/table";
+export { processLink, isDangerousUrl, isExternalUrl, } from "./lib/defaults/link";
+export { processImage, type ImageOptions } from "./lib/defaults/image";
+export { preloadKaTeX } from "./lib/parser";
+export { escapeHtml } from "./lib/hook-utils";
+export { loadLanguage, loadLanguages, registerLanguage, isLanguageReady, isLanguageSupported, getRegisteredLanguages, getSupportedLanguages, } from "./lib/highlighter";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtE,YAAY,EACX,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,GACvB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAGpE,OAAO,EACN,kBAAkB,EAClB,sBAAsB,EACtB,WAAW,GACX,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACX,WAAW,EACX,UAAU,EACV,aAAa,EACb,cAAc,EACd,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,SAAS,EACT,WAAW,EACX,cAAc,EACd,SAAS,EACT,SAAS,EACT,QAAQ,EACR,kBAAkB,EAClB,eAAe,EACf,eAAe,GACf,MAAM,eAAe,CAAC;AAGvB,OAAO,EACN,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACtB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EACN,WAAW,EACX,cAAc,EACd,aAAa,GACb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGvE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EACN,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,GACrB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+// Main component
+export { MarkdownViewer, MarkdownViewerSafe } from "./MarkdownViewer";
+// Error boundary (for custom error handling)
+export { ErrorBoundary } from "./ErrorBoundary";
+// Hook for custom implementations
+export { useMarkdownViewer } from "./useMarkdownViewer";
+// WASM initialization
+export { initMarkdownViewer, initMarkdownViewerSync, isWasmReady, } from "./lib/wasm-init";
+// Default processors (for extending/wrapping)
+export { processCodeBlock, processInlineCode, injectColorPreviews, } from "./lib/defaults/code-block";
+export { processMathBlock } from "./lib/defaults/math";
+export { processTable } from "./lib/defaults/table";
+export { processLink, isDangerousUrl, isExternalUrl, } from "./lib/defaults/link";
+export { processImage } from "./lib/defaults/image";
+// Preload utilities for performance optimization
+export { preloadKaTeX } from "./lib/parser";
+// Hook utilities
+export { escapeHtml } from "./lib/hook-utils";
+// Syntax highlighting utilities
+export { loadLanguage, loadLanguages, registerLanguage, isLanguageReady, isLanguageSupported, getRegisteredLanguages, getSupportedLanguages, } from "./lib/highlighter";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAOtE,6CAA6C;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,kCAAkC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,sBAAsB;AACtB,OAAO,EACN,kBAAkB,EAClB,sBAAsB,EACtB,WAAW,GACX,MAAM,iBAAiB,CAAC;AAsBzB,8CAA8C;AAC9C,OAAO,EACN,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,GAGnB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EACN,WAAW,EACX,cAAc,EACd,aAAa,GACb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAqB,MAAM,sBAAsB,CAAC;AAEvE,iDAAiD;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,iBAAiB;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,gCAAgC;AAChC,OAAO,EACN,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,GACrB,MAAM,mBAAmB,CAAC"}

package/dist/lib/cache-manager.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Unified LRU Cache Manager
+ * Coordinates memory usage across all caches in the markdown-viewer
+ */
+export interface CacheStats {
+    entries: number;
+    estimatedBytes: number;
+}
+declare class LRUCache<V> {
+    private cache;
+    private sizeEstimates;
+    private totalBytes;
+    private maxEntries;
+    private maxBytes;
+    constructor(maxEntries: number, maxBytes?: number);
+    get(key: string): V | undefined;
+    set(key: string, value: V, sizeBytes?: number): void;
+    has(key: string): boolean;
+    clear(): void;
+    evictOldest(count: number): void;
+    get stats(): CacheStats;
+    private estimateSize;
+}
+/**
+ * Global cache manager instance
+ * Coordinates memory across render cache, katex cache, and morph cache
+ */
+declare class CacheManager {
+    private memoryBudget;
+    readonly renderCacheSync: LRUCache<string>;
+    readonly renderCacheAsync: LRUCache<string>;
+    readonly katexCacheDisplay: LRUCache<string>;
+    readonly katexCacheInline: LRUCache<string>;
+    readonly highlightCache: LRUCache<string>;
+    constructor(memoryBudget?: number);
+    /**
+     * Get combined stats for all caches
+     */
+    get stats(): {
+        renderSync: CacheStats;
+        renderAsync: CacheStats;
+        katexDisplay: CacheStats;
+        katexInline: CacheStats;
+        highlight: CacheStats;
+        total: CacheStats;
+    };
+    /**
+     * Clear all caches
+     */
+    clearAll(): void;
+    /**
+     * Trim caches if under memory pressure
+     * Evicts ~25% of entries from each cache when budget exceeded
+     */
+    trimIfNeeded(): void;
+}
+export declare const cacheManager: CacheManager;
+export type { LRUCache };
+//# sourceMappingURL=cache-manager.d.ts.map

package/dist/lib/cache-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../src/lib/cache-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,cAAM,QAAQ,CAAC,CAAC;IACd,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAS;gBAEb,UAAU,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAiB;IAK3D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAU/B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IA6BpD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,KAAK,IAAI,IAAI;IAMb,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAWhC,IAAI,KAAK,IAAI,UAAU,CAKtB;IAED,OAAO,CAAC,YAAY;CAMrB;AAKD;;;GAGG;AACH,cAAM,YAAY;IAChB,OAAO,CAAC,YAAY,CAAS;IAI7B,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE5C,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE5C,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAE9B,YAAY,SAAwB;IAYhD;;OAEG;IACH,IAAI,KAAK,IAAI;QAAE,UAAU,EAAE,UAAU,CAAC;QAAC,WAAW,EAAE,UAAU,CAAC;QAAC,YAAY,EAAE,UAAU,CAAC;QAAC,WAAW,EAAE,UAAU,CAAC;QAAC,SAAS,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,CAkB5J;IAED;;OAEG;IACH,QAAQ,IAAI,IAAI;IAQhB;;;OAGG;IACH,YAAY,IAAI,IAAI;CAiBrB;AAGD,eAAO,MAAM,YAAY,cAAqB,CAAC;AAG/C,YAAY,EAAE,QAAQ,EAAE,CAAC"}