mrmd-editor 0.7.1 → 0.8.0

package/src/runtime-codelens/detector.js

@@ -1,279 +0,0 @@
-/**
- * Runtime CodeLens Block Detection
- *
- * Detects blocks that should have runtime CodeLens:
- * 1. `yaml config` blocks in mrmd.md containing session config
- * 2. Frontmatter in documents containing session overrides
- */
-
-import yaml from 'yaml';
-
-/** Supported runtime languages */
-const RUNTIME_LANGUAGES = ['python', 'bash', 'node', 'julia', 'r', 'shell'];
-
-/**
- * @typedef {Object} RuntimeConfig
- * @property {string} language - Runtime language (python, node, etc.)
- * @property {string} [name] - Session name
- * @property {string} [venv] - Virtual environment path (Python)
- * @property {string} [cwd] - Working directory
- * @property {boolean} [autoStart] - Auto-start on project open
- */
-
-/**
- * @typedef {Object} DetectedBlock
- * @property {'config' | 'frontmatter'} type - Block type
- * @property {number} start - Start character offset
- * @property {number} end - End character offset
- * @property {number} fenceLineEnd - End of opening fence/delimiter line (where to place widget)
- * @property {string} content - Raw YAML content
- * @property {RuntimeConfig[]} runtimes - Parsed runtime configurations
- */
-
-/**
- * Find all yaml config blocks containing session configuration
- * @param {string} content - Document content
- * @returns {DetectedBlock[]}
- */
-export function findYamlConfigBlocks(content) {
-  const blocks = [];
-  const lines = content.split('\n');
-
-  let inBlock = false;
-  let blockStart = 0;
-  let fenceLineEnd = 0;
-  let blockContent = [];
-  let fenceChar = '';
-  let fenceLength = 0;
-  let charOffset = 0;
-
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    const lineStart = charOffset;
-    const lineEnd = charOffset + line.length;
-
-    if (!inBlock) {
-      // Look for opening fence: ```yaml config or ~~~yaml config
-      const match = line.match(/^(`{3,}|~{3,})yaml\s+config\s*$/);
-      if (match) {
-        inBlock = true;
-        blockStart = lineStart;
-        fenceLineEnd = lineEnd;
-        fenceChar = match[1][0];
-        fenceLength = match[1].length;
-        blockContent = [];
-      }
-    } else {
-      // Look for closing fence (same char, at least same length)
-      const closingPattern = new RegExp(`^${fenceChar}{${fenceLength},}\\s*$`);
-      if (closingPattern.test(line)) {
-        // Parse the YAML content
-        const yamlContent = blockContent.join('\n');
-        // Content starts after the opening fence line + newline
-        const contentStartOffset = fenceLineEnd + 1;
-        const runtimes = extractRuntimes(yamlContent, contentStartOffset);
-
-        // Only include if it has runtime config
-        if (runtimes.length > 0) {
-          blocks.push({
-            type: 'config',
-            start: blockStart,
-            end: lineEnd,
-            fenceLineEnd,
-            content: yamlContent,
-            runtimes,
-          });
-        }
-
-        inBlock = false;
-        blockContent = [];
-      } else {
-        blockContent.push(line);
-      }
-    }
-
-    charOffset += line.length + 1; // +1 for newline
-  }
-
-  return blocks;
-}
-
-/**
- * Find frontmatter block if it contains session configuration
- * @param {string} content - Document content
- * @returns {DetectedBlock | null}
- */
-export function findSessionFrontmatter(content) {
-  // Frontmatter must start at the beginning with ---
-  if (!content.startsWith('---')) {
-    return null;
-  }
-
-  // Find the closing ---
-  const endMatch = content.indexOf('\n---', 3);
-  if (endMatch === -1) {
-    return null;
-  }
-
-  const yamlContent = content.slice(4, endMatch); // Skip opening ---\n
-  const runtimes = extractRuntimes(yamlContent);
-
-  // Only return if it has runtime config
-  if (runtimes.length === 0) {
-    return null;
-  }
-
-  return {
-    type: 'frontmatter',
-    start: 0,
-    end: endMatch + 4, // Include closing ---
-    fenceLineEnd: 3, // End of opening ---
-    content: yamlContent,
-    runtimes,
-  };
-}
-
-/**
- * Extract runtime configurations from YAML content
- *
- * Supports both verbose and minimal syntax:
- * - Verbose: session: { python: { venv: .venv } }
- * - Minimal: python: .venv
- * - Minimal object: python: { venv: .venv }
- *
- * @param {string} yamlContent - Raw YAML string
- * @param {number} [contentStartOffset=0] - Character offset where YAML content starts in document
- * @returns {RuntimeConfig[]}
- */
-export function extractRuntimes(yamlContent, contentStartOffset = 0) {
-  const runtimes = [];
-
-  try {
-    const parsed = yaml.parse(yamlContent);
-    if (!parsed) return runtimes;
-
-    // Normalize: check for minimal syntax first, then verbose
-    // This matches the normalization in mrmd-project
-    const sessionConfig = normalizeToSessionConfig(parsed);
-
-    if (!sessionConfig) {
-      return runtimes;
-    }
-
-    // Check for each supported runtime language
-    for (const language of RUNTIME_LANGUAGES) {
-      const config = sessionConfig[language];
-      if (config) {
-        // Find the line where this runtime is declared
-        // Try both minimal (python:) and verbose (  python: under session:)
-        let lineOffset = null;
-
-        // Try minimal syntax first (top-level python:)
-        const minimalPattern = new RegExp(`^(${language}:)`, 'm');
-        const minimalMatch = yamlContent.match(minimalPattern);
-
-        if (minimalMatch) {
-          const keyStart = minimalMatch.index;
-          const lineEnd = yamlContent.indexOf('\n', keyStart);
-          lineOffset = contentStartOffset + (lineEnd !== -1 ? lineEnd : keyStart + minimalMatch[1].length);
-        } else {
-          // Try verbose syntax (indented under session:)
-          const verbosePattern = new RegExp(`^(  ${language}:)`, 'm');
-          const verboseMatch = yamlContent.match(verbosePattern);
-
-          if (verboseMatch) {
-            const keyStart = verboseMatch.index;
-            const lineEnd = yamlContent.indexOf('\n', keyStart);
-            lineOffset = contentStartOffset + (lineEnd !== -1 ? lineEnd : keyStart + verboseMatch[1].length);
-          }
-        }
-
-        runtimes.push({
-          language,
-          name: config.name || 'default',
-          venv: config.venv,
-          cwd: config.cwd,
-          autoStart: config.auto_start ?? config.autoStart ?? true,
-          lineOffset, // Position to place widget for this runtime
-        });
-      }
-    }
-  } catch (e) {
-    // Invalid YAML - return empty
-    console.warn('[RuntimeCodeLens] Failed to parse YAML:', e.message);
-  }
-
-  return runtimes;
-}
-
-/**
- * Normalize parsed YAML to session config format.
- * Handles both minimal syntax (python: .venv) and verbose (session: { python: { venv: .venv } })
- *
- * @param {object} parsed - Parsed YAML object
- * @returns {object | null} Session config object or null if no runtime config found
- */
-function normalizeToSessionConfig(parsed) {
-  if (!parsed || typeof parsed !== 'object') {
-    return null;
-  }
-
-  // If already has session key, use it directly
-  if (parsed.session && typeof parsed.session === 'object') {
-    return parsed.session;
-  }
-
-  // Check for minimal syntax (python:, bash:, etc. at top level)
-  const sessionConfig = {};
-  let hasRuntime = false;
-
-  for (const language of RUNTIME_LANGUAGES) {
-    if (language in parsed) {
-      const value = parsed[language];
-      hasRuntime = true;
-
-      if (typeof value === 'string') {
-        // Minimal string form: python: .venv -> { venv: '.venv' }
-        if (language === 'python') {
-          sessionConfig[language] = { venv: value };
-        } else {
-          sessionConfig[language] = { cwd: value };
-        }
-      } else if (typeof value === 'object' && value !== null) {
-        // Minimal object form: python: { venv: .venv }
-        sessionConfig[language] = value;
-      }
-    }
-  }
-
-  return hasRuntime ? sessionConfig : null;
-}
-
-/**
- * Find all blocks (config blocks + frontmatter) that need CodeLens
- * @param {string} content - Document content
- * @param {Object} options
- * @param {boolean} [options.includeConfigBlocks=true] - Include yaml config blocks
- * @param {boolean} [options.includeFrontmatter=true] - Include frontmatter
- * @returns {DetectedBlock[]}
- */
-export function findRuntimeBlocks(content, options = {}) {
-  const { includeConfigBlocks = true, includeFrontmatter = true } = options;
-  const blocks = [];
-
-  if (includeConfigBlocks) {
-    blocks.push(...findYamlConfigBlocks(content));
-  }
-
-  if (includeFrontmatter) {
-    const frontmatter = findSessionFrontmatter(content);
-    if (frontmatter) {
-      blocks.push(frontmatter);
-    }
-  }
-
-  // Sort by position (frontmatter first if present)
-  blocks.sort((a, b) => a.start - b.start);
-
-  return blocks;
-}

package/src/runtime-codelens/index.js

@@ -1,76 +0,0 @@
-/**
- * Runtime CodeLens Extension
- *
- * Provides inline controls for starting/stopping/restarting runtimes
- * directly above yaml config blocks and frontmatter.
- *
- * @example
- * ```javascript
- * import { createRuntimeCodeLensExtensions } from './runtime-codelens';
- *
- * const extensions = createRuntimeCodeLensExtensions({
- *   projectName: 'my-project',
- *   getSessionStatus: (name) => shellState.get(`runtimes.sessions.${name}`),
- *   onStart: async (runtime) => { await electronAPI.runtime.start(runtime); },
- *   onStop: async (name) => { await electronAPI.runtime.stop(name); },
- *   onRestart: async (name) => { await electronAPI.runtime.restart(name); },
- *   onRestartAll: async () => { ... },
- * });
- * ```
- */
-
-import { runtimeCodeLensFacet, runtimeCodeLensPlugin, rebuildRuntimeCodeLensEffect } from './plugin.js';
-import { injectRuntimeCodeLensStyles } from './styles.js';
-
-// Re-export for external use
-export { runtimeCodeLensFacet, runtimeCodeLensPlugin, rebuildRuntimeCodeLensEffect };
-export { injectRuntimeCodeLensStyles, removeRuntimeCodeLensStyles } from './styles.js';
-export { findRuntimeBlocks, findYamlConfigBlocks, findSessionFrontmatter } from './detector.js';
-export { RuntimeCodeLensWidget } from './widgets.js';
-
-/**
- * @typedef {Object} RuntimeCodeLensOptions
- * @property {string} [projectName='default'] - Project name for session naming
- * @property {(name: string) => Object|null} getSessionStatus - Get session status by name
- * @property {(runtime: Object) => void|Promise<void>} onStart - Start a runtime
- * @property {(name: string) => void|Promise<void>} onStop - Stop a runtime
- * @property {(name: string) => void|Promise<void>} onRestart - Restart a runtime
- * @property {() => void|Promise<void>} [onRestartAll] - Restart all runtimes
- */
-
-/**
- * Create CodeMirror extensions for runtime CodeLens
- *
- * @param {RuntimeCodeLensOptions} options - Configuration options
- * @returns {import('@codemirror/state').Extension[]} Array of CodeMirror extensions
- */
-export function createRuntimeCodeLensExtensions(options) {
-  // Inject styles on first use
-  injectRuntimeCodeLensStyles();
-
-  const context = {
-    projectName: options.projectName || 'default',
-    getSessionStatus: options.getSessionStatus || (() => null),
-    onStart: options.onStart || (() => {}),
-    onStop: options.onStop || (() => {}),
-    onRestart: options.onRestart || (() => {}),
-    onRestartAll: options.onRestartAll || (() => {}),
-  };
-
-  return [
-    runtimeCodeLensFacet.of(context),
-    runtimeCodeLensPlugin,
-  ];
-}
-
-/**
- * Dispatch effect to rebuild runtime CodeLens decorations
- * Call this when session status changes to update the UI
- *
- * @param {import('@codemirror/view').EditorView} view - Editor view
- */
-export function rebuildRuntimeCodeLens(view) {
-  view.dispatch({
-    effects: rebuildRuntimeCodeLensEffect.of(null),
-  });
-}

package/src/runtime-codelens/plugin.js

@@ -1,142 +0,0 @@
-/**
- * Runtime CodeLens Plugin
- *
- * CodeMirror StateField that renders runtime control widgets
- * above yaml config blocks and frontmatter with session config.
- *
- * Note: Block decorations MUST come from StateField, not ViewPlugin.
- */
-
-import { EditorView, Decoration } from '@codemirror/view';
-import { Facet, StateEffect, StateField } from '@codemirror/state';
-import { findRuntimeBlocks } from './detector.js';
-import { RuntimeCodeLensWidget } from './widgets.js';
-
-/**
- * @typedef {Object} RuntimeCodeLensContext
- * @property {(name: string) => Object|null} getSessionStatus - Get status for session name
- * @property {(runtime: Object) => void} onStart - Start a runtime
- * @property {(name: string) => void} onStop - Stop a runtime
- * @property {(name: string) => void} onRestart - Restart a runtime
- * @property {() => void} onRestartAll - Restart all runtimes
- * @property {string} [projectName] - Project name for session naming
- */
-
-/**
- * Facet for passing context (callbacks, state) to the plugin
- */
-export const runtimeCodeLensFacet = Facet.define({
-  combine: (values) => values[0] || null,
-});
-
-/**
- * Effect to trigger decoration rebuild (e.g., when session status changes)
- */
-export const rebuildRuntimeCodeLensEffect = StateEffect.define();
-
-/**
- * Get full session name (project:name format)
- * @param {string} name - Runtime name from config
- * @param {string} projectName - Project name
- * @returns {string}
- */
-function getSessionName(name, projectName) {
-  return `${projectName || 'default'}:${name || 'default'}`;
-}
-
-/**
- * Build decorations for all detected runtime blocks
- * @param {import('@codemirror/state').EditorState} state
- * @returns {import('@codemirror/view').DecorationSet}
- */
-function buildDecorations(state) {
-  const context = state.facet(runtimeCodeLensFacet);
-
-  if (!context) {
-    return Decoration.none;
-  }
-
-  const content = state.doc.toString();
-  const blocks = findRuntimeBlocks(content);
-
-  if (blocks.length === 0) {
-    return Decoration.none;
-  }
-
-  const decorations = [];
-
-  for (const block of blocks) {
-    // Create a separate widget for each runtime at its line position
-    for (const runtime of block.runtimes) {
-      const sessionName = getSessionName(runtime.name, context.projectName);
-      const status = context.getSessionStatus?.(sessionName) || null;
-
-      const runtimeWithStatus = {
-        ...runtime,
-        name: sessionName,
-        status,
-      };
-
-      // Create widget for this single runtime
-      const widget = new RuntimeCodeLensWidget({
-        runtimes: [runtimeWithStatus],
-        callbacks: {
-          onStart: (rt) => context.onStart?.(rt),
-          onStop: (name) => context.onStop?.(name),
-          onRestart: (name) => context.onRestart?.(name),
-          onRestartAll: () => context.onRestartAll?.(),
-        },
-        blockType: block.type,
-      });
-
-      // Place widget at the runtime's line position, or fallback to block start
-      const position = runtime.lineOffset ?? block.fenceLineEnd;
-
-      decorations.push(
-        Decoration.widget({
-          widget,
-          side: 1, // After the position
-          block: true, // Render as block element (requires StateField)
-        }).range(position)
-      );
-    }
-  }
-
-  return Decoration.set(decorations, true);
-}
-
-/**
- * StateField for runtime CodeLens decorations
- * Block decorations must come from StateField, not ViewPlugin
- */
-export const runtimeCodeLensField = StateField.define({
-  create(state) {
-    return buildDecorations(state);
-  },
-
-  update(decorations, tr) {
-    // Check if we need to rebuild
-    const hasRebuildEffect = tr.effects.some((e) => e.is(rebuildRuntimeCodeLensEffect));
-
-    if (tr.docChanged || hasRebuildEffect) {
-      return buildDecorations(tr.state);
-    }
-
-    // Check if context changed
-    const oldContext = tr.startState.facet(runtimeCodeLensFacet);
-    const newContext = tr.state.facet(runtimeCodeLensFacet);
-    if (oldContext !== newContext) {
-      return buildDecorations(tr.state);
-    }
-
-    return decorations;
-  },
-
-  provide: (field) => EditorView.decorations.from(field),
-});
-
-/**
- * Extension array that includes the StateField
- * Use this as the plugin export for backwards compatibility
- */
-export const runtimeCodeLensPlugin = runtimeCodeLensField;

package/src/runtime-codelens/styles.js

@@ -1,184 +0,0 @@
-/**
- * Runtime CodeLens Styles
- *
- * Injects CSS for the runtime CodeLens widget.
- * Uses CSS variables for theming compatibility.
- */
-
-let stylesInjected = false;
-
-const STYLES = `
-/* Runtime CodeLens Container */
-.cm-runtime-codelens {
-  display: flex;
-  flex-direction: column;
-  gap: 4px;
-  padding: 6px 10px;
-  margin: 2px 0 4px 0;
-  background: var(--runtime-codelens-bg, rgba(128, 128, 128, 0.08));
-  border-radius: 4px;
-  font-size: 12px;
-  font-family: var(--font-ui, system-ui, -apple-system, sans-serif);
-  line-height: 1.4;
-  border-left: 3px solid var(--runtime-codelens-border, rgba(128, 128, 128, 0.2));
-}
-
-/* Individual runtime row */
-.cm-runtime-codelens-row {
-  display: flex;
-  align-items: center;
-  gap: 8px;
-  min-height: 24px;
-}
-
-.cm-runtime-codelens-row--all {
-  margin-top: 4px;
-  padding-top: 4px;
-  border-top: 1px solid var(--runtime-codelens-divider, rgba(128, 128, 128, 0.15));
-}
-
-/* Language label */
-.cm-runtime-codelens-label {
-  font-weight: 500;
-  color: var(--runtime-codelens-label, inherit);
-  min-width: 80px;
-}
-
-/* Session name badge */
-.cm-runtime-codelens-name {
-  padding: 1px 6px;
-  background: var(--runtime-codelens-badge-bg, rgba(128, 128, 128, 0.15));
-  border-radius: 3px;
-  font-size: 11px;
-  color: var(--runtime-codelens-badge-text, inherit);
-  opacity: 0.8;
-}
-
-/* Actions container */
-.cm-runtime-codelens-actions {
-  display: flex;
-  gap: 4px;
-  margin-left: auto;
-}
-
-/* Action buttons */
-.cm-runtime-codelens-btn {
-  padding: 2px 8px;
-  border: none;
-  border-radius: 3px;
-  cursor: pointer;
-  background: var(--runtime-codelens-btn-bg, rgba(128, 128, 128, 0.12));
-  color: var(--runtime-codelens-btn-text, inherit);
-  font-size: 12px;
-  font-family: inherit;
-  transition: background 0.15s ease, transform 0.1s ease;
-}
-
-.cm-runtime-codelens-btn:hover {
-  background: var(--runtime-codelens-btn-bg-hover, rgba(128, 128, 128, 0.2));
-}
-
-.cm-runtime-codelens-btn:active {
-  transform: scale(0.95);
-}
-
-/* Start button - slightly emphasized */
-.cm-runtime-codelens-btn:first-child:not(.cm-runtime-codelens-btn--restart-all) {
-  background: var(--runtime-codelens-btn-start-bg, rgba(34, 197, 94, 0.15));
-  color: var(--runtime-codelens-btn-start-text, #22c55e);
-}
-
-.cm-runtime-codelens-btn:first-child:not(.cm-runtime-codelens-btn--restart-all):hover {
-  background: var(--runtime-codelens-btn-start-bg-hover, rgba(34, 197, 94, 0.25));
-}
-
-/* Restart All button */
-.cm-runtime-codelens-btn--restart-all {
-  width: 100%;
-  padding: 4px 8px;
-  background: var(--runtime-codelens-btn-restart-all-bg, rgba(128, 128, 128, 0.1));
-}
-
-/* Status indicator */
-.cm-runtime-codelens-status {
-  display: flex;
-  align-items: center;
-  gap: 4px;
-  margin-left: 8px;
-  min-width: 100px;
-}
-
-.cm-runtime-codelens-status-text {
-  opacity: 0.7;
-  font-size: 11px;
-}
-
-/* Status dot */
-.cm-runtime-codelens-dot {
-  display: inline-block;
-  width: 8px;
-  height: 8px;
-  border-radius: 50%;
-  flex-shrink: 0;
-}
-
-.cm-runtime-codelens-dot--green {
-  background: var(--runtime-codelens-dot-green, #22c55e);
-  box-shadow: 0 0 4px var(--runtime-codelens-dot-green, #22c55e);
-}
-
-.cm-runtime-codelens-dot--yellow {
-  background: var(--runtime-codelens-dot-yellow, #eab308);
-  animation: pulse 1.5s ease-in-out infinite;
-}
-
-.cm-runtime-codelens-dot--gray {
-  background: var(--runtime-codelens-dot-gray, #9ca3af);
-}
-
-.cm-runtime-codelens-dot--red {
-  background: var(--runtime-codelens-dot-red, #ef4444);
-}
-
-@keyframes pulse {
-  0%, 100% { opacity: 1; }
-  50% { opacity: 0.5; }
-}
-
-/* Dark theme adjustments */
-.cm-editor.cm-dark .cm-runtime-codelens,
-.dark .cm-runtime-codelens {
-  --runtime-codelens-bg: rgba(255, 255, 255, 0.05);
-  --runtime-codelens-border: rgba(255, 255, 255, 0.1);
-  --runtime-codelens-divider: rgba(255, 255, 255, 0.1);
-  --runtime-codelens-btn-bg: rgba(255, 255, 255, 0.08);
-  --runtime-codelens-btn-bg-hover: rgba(255, 255, 255, 0.15);
-  --runtime-codelens-badge-bg: rgba(255, 255, 255, 0.1);
-}
-`;
-
-/**
- * Inject runtime CodeLens styles into the document
- * Safe to call multiple times - will only inject once
- */
-export function injectRuntimeCodeLensStyles() {
-  if (stylesInjected) return;
-
-  const style = document.createElement('style');
-  style.id = 'cm-runtime-codelens-styles';
-  style.textContent = STYLES;
-  document.head.appendChild(style);
-
-  stylesInjected = true;
-}
-
-/**
- * Remove injected styles (for cleanup/testing)
- */
-export function removeRuntimeCodeLensStyles() {
-  const existing = document.getElementById('cm-runtime-codelens-styles');
-  if (existing) {
-    existing.remove();
-    stylesInjected = false;
-  }
-}