mrmd-js 2.0.1 → 2.2.0

package/dist/index.js

@@ -6385,6 +6385,143 @@ function createCssExecutor() {
   return new CssExecutor();
 }
 
+/**
+ * Mermaid Executor
+ *
+ * Executes Mermaid diagram cells by rendering them to SVG.
+ * Loads mermaid from CDN on first use and returns HTML displayData.
+ *
+ * @module execute/mermaid
+ */
+
+
+/**
+ * @typedef {import('../session/context/interface.js').ExecutionContext} ExecutionContext
+ * @typedef {import('../types/execution.js').ExecuteOptions} ExecuteOptions
+ * @typedef {import('../types/execution.js').ExecutionResult} ExecutionResult
+ * @typedef {import('../types/execution.js').DisplayData} DisplayData
+ */
+
+/** CDN URL for mermaid */
+const MERMAID_CDN = 'https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.min.js';
+
+/** Counter for unique diagram IDs */
+let diagramCounter = 0;
+
+/**
+ * Load mermaid from CDN if not already loaded
+ * @returns {Promise<void>}
+ */
+async function ensureMermaidLoaded() {
+  // Check if already loaded
+  if (typeof window !== 'undefined' && window.mermaid) {
+    return;
+  }
+
+  // Load from CDN
+  return new Promise((resolve, reject) => {
+    const script = document.createElement('script');
+    script.src = MERMAID_CDN;
+    script.onload = () => {
+      // Initialize mermaid with safe defaults
+      window.mermaid.initialize({
+        startOnLoad: false,
+        theme: 'default',
+        securityLevel: 'loose', // Allow clicks/links in diagrams
+        fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif',
+      });
+      resolve();
+    };
+    script.onerror = () => reject(new Error('Failed to load mermaid from CDN'));
+    document.head.appendChild(script);
+  });
+}
+
+/**
+ * Mermaid executor - renders Mermaid diagrams to SVG
+ */
+class MermaidExecutor extends BaseExecutor {
+  /** @type {readonly string[]} */
+  languages = ['mermaid'];
+
+  /**
+   * Execute Mermaid diagram cell
+   * @param {string} code - Mermaid diagram definition
+   * @param {ExecutionContext} context - Execution context
+   * @param {ExecuteOptions} [options] - Execution options
+   * @returns {Promise<ExecutionResult>}
+   */
+  async execute(code, context, options = {}) {
+    const startTime = performance.now();
+
+    try {
+      // Ensure mermaid is loaded
+      await ensureMermaidLoaded();
+
+      // Generate unique ID for this diagram
+      const diagramId = `mermaid-diagram-${++diagramCounter}`;
+
+      // Render the diagram
+      const { svg } = await window.mermaid.render(diagramId, code.trim());
+
+      const duration = performance.now() - startTime;
+
+      // Build display data with the rendered SVG
+      /** @type {DisplayData[]} */
+      const displayData = [
+        {
+          data: {
+            'text/html': svg,
+            'text/plain': `[Mermaid diagram rendered]`,
+          },
+          metadata: {
+            mermaid: true,
+            diagramId,
+          },
+        },
+      ];
+
+      return {
+        success: true,
+        stdout: '',
+        stderr: '',
+        result: undefined,
+        displayData,
+        assets: [],
+        executionCount: 0,
+        duration,
+      };
+    } catch (error) {
+      const duration = performance.now() - startTime;
+      const errorMessage = error instanceof Error ? error.message : String(error);
+
+      // Return error as stderr with helpful message
+      return {
+        success: false,
+        stdout: '',
+        stderr: `Mermaid rendering error: ${errorMessage}`,
+        result: undefined,
+        error: {
+          type: 'MermaidError',
+          message: errorMessage,
+        },
+        displayData: [],
+        assets: [],
+        executionCount: 0,
+        duration,
+      };
+    }
+  }
+}
+
+/**
+ * Create a Mermaid executor
+ * @returns {MermaidExecutor}
+ */
+function createMermaidExecutor() {
+  return new MermaidExecutor();
+}
+
 /**
  * Execute Module
  *
@@ -6403,6 +6540,7 @@ function createDefaultExecutorRegistry() {
   registry.register(new JavaScriptExecutor());
   registry.register(new HtmlExecutor());
   registry.register(new CssExecutor());
+  registry.register(new MermaidExecutor());
   return registry;
 }
 
@@ -7715,5 +7853,5 @@ function createAnsiRenderer(options) {
   return new AnsiRenderer(options);
 }
 
-export { AnsiRenderer, BaseExecutor, ConsoleCapture, CssApplicator, CssExecutor, DEFAULT_FEATURES, DEFAULT_MAX_SESSIONS, DEFAULT_SESSION, ExecutorRegistry, HtmlExecutor, HtmlRenderer, IframeContext, JavaScriptExecutor, MainContext, MrpRuntime, RUNTIME_NAME, RUNTIME_VERSION, SUPPORTED_LANGUAGES, Session, SessionManager, ansiToHtml, basicFormat, createAnsiRenderer, createConsoleCapture, createCssApplicator, createCssExecutor, createDefaultExecutorRegistry, createExecutorRegistry, createHtmlExecutor, createHtmlRenderer, createIframeContext, createJavaScriptExecutor, createMainContext, createRuntime, createSession, createSessionManager, expandVariable, extractDeclaredVariables, extractScripts, extractStyles, formatCode, formatCss, formatHtml, formatValue, formatValueShort, formatVariableInfo, generateScopeClass, getAttributes, getChildren, getCommonGlobals, getCompletionKind, getCompletions, getFunctionSignature, getFunctionSource, getHoverInfo, getInspectInfo, getKeywords, getMethods, getSizeDescription, getStringOrCommentContext, getSuggestedIndent, getTypeName, getVariableDetail, getWordAtCursor, hasPrettier, inspectPath, isComplete, isExpandable, isIdentifierPart, isIdentifierStart, isKeyword, listVariables, parseCompletionContext, parseIdentifierAtPosition, scopeStyles$1 as scopeStyles, scopeStyles as scopeStylesUtil, setPrettier, splitObjectPath, stripAnsi, transformForPersistence, wrapForAsync, wrapWithLastExpression };
+export { AnsiRenderer, BaseExecutor, ConsoleCapture, CssApplicator, CssExecutor, DEFAULT_FEATURES, DEFAULT_MAX_SESSIONS, DEFAULT_SESSION, ExecutorRegistry, HtmlExecutor, HtmlRenderer, IframeContext, JavaScriptExecutor, MainContext, MermaidExecutor, MrpRuntime, RUNTIME_NAME, RUNTIME_VERSION, SUPPORTED_LANGUAGES, Session, SessionManager, ansiToHtml, basicFormat, createAnsiRenderer, createConsoleCapture, createCssApplicator, createCssExecutor, createDefaultExecutorRegistry, createExecutorRegistry, createHtmlExecutor, createHtmlRenderer, createIframeContext, createJavaScriptExecutor, createMainContext, createMermaidExecutor, createRuntime, createSession, createSessionManager, expandVariable, extractDeclaredVariables, extractScripts, extractStyles, formatCode, formatCss, formatHtml, formatValue, formatValueShort, formatVariableInfo, generateScopeClass, getAttributes, getChildren, getCommonGlobals, getCompletionKind, getCompletions, getFunctionSignature, getFunctionSource, getHoverInfo, getInspectInfo, getKeywords, getMethods, getSizeDescription, getStringOrCommentContext, getSuggestedIndent, getTypeName, getVariableDetail, getWordAtCursor, hasPrettier, inspectPath, isComplete, isExpandable, isIdentifierPart, isIdentifierStart, isKeyword, listVariables, parseCompletionContext, parseIdentifierAtPosition, scopeStyles$1 as scopeStyles, scopeStyles as scopeStylesUtil, setPrettier, splitObjectPath, stripAnsi, transformForPersistence, wrapForAsync, wrapWithLastExpression };
 //# sourceMappingURL=index.js.map