mdv-live 0.3.0

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "mdv-live",
+  "version": "0.3.0",
+  "description": "Markdown Viewer - File tree + Live preview + Marp support + Hot reload",
+  "main": "src/server.js",
+  "bin": {
+    "mdv": "./bin/mdv.js"
+  },
+  "scripts": {
+    "start": "node bin/mdv.js",
+    "dev": "node bin/mdv.js --dev",
+    "test": "node --test tests/*.js",
+    "setup-macos": "bash scripts/setup-macos-app.sh"
+  },
+  "keywords": [
+    "markdown",
+    "viewer",
+    "marp",
+    "slides",
+    "preview",
+    "live-reload",
+    "hot-reload",
+    "file-tree"
+  ],
+  "author": "PanHouse <hirono.okamoto@panhouse.jp>",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/panhouse/mdv.git"
+  },
+  "homepage": "https://github.com/panhouse/mdv#readme",
+  "bugs": {
+    "url": "https://github.com/panhouse/mdv/issues"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "scripts/",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "express": "^4.21.2",
+    "ws": "^8.18.0",
+    "chokidar": "^4.0.3",
+    "markdown-it": "^14.1.0",
+    "markdown-it-task-lists": "^2.1.1",
+    "@marp-team/marp-core": "^4.0.0",
+    "highlight.js": "^11.10.0",
+    "open": "^10.1.0",
+    "mime-types": "^2.1.35",
+    "multer": "^1.4.5-lts.1"
+  },
+  "optionalDependencies": {
+    "@marp-team/marp-cli": "^4.0.3"
+  }
+}

package/scripts/setup-macos-app.sh

@@ -0,0 +1,172 @@
+#!/bin/bash
+# MDV macOS App Setup Script
+# Finderから.mdファイルをダブルクリックでMDVを開けるようにする
+
+set -e
+
+echo "=== MDV macOS App Setup ==="
+echo ""
+
+# mdvコマンドの場所を確認
+MDV_PATH=$(which mdv 2>/dev/null || true)
+
+if [ -z "$MDV_PATH" ]; then
+    echo "Error: mdv command not found."
+    echo "Please install mdv first: npm install -g mdv-live"
+    exit 1
+fi
+
+echo "Found mdv at: $MDV_PATH"
+echo ""
+
+# 一時ディレクトリ
+TEMP_DIR=$(mktemp -d)
+APP_NAME="MDV.app"
+APP_PATH="/Applications/$APP_NAME"
+
+# AppleScript作成
+cat << EOF > "$TEMP_DIR/MDV.applescript"
+-- MDV Markdown Viewer Launcher
+
+on open theFiles
+    repeat with theFile in theFiles
+        set filePath to POSIX path of theFile
+        -- Run launcher (will return after opening browser)
+        do shell script "/Applications/MDV.app/Contents/Resources/launch.sh " & quoted form of filePath
+    end repeat
+end open
+
+on run
+    display dialog "MDV Markdown Viewer
+
+Usage:
+- Double-click any .md file
+- Drag & drop .md files onto this app
+
+Version: 0.3.0 (Node.js)" buttons {"OK"} default button "OK" with title "MDV"
+end run
+EOF
+
+echo "Compiling AppleScript..."
+osacompile -o "$TEMP_DIR/$APP_NAME" "$TEMP_DIR/MDV.applescript"
+
+# Create launcher script
+echo "Creating launcher script..."
+cat > "$TEMP_DIR/$APP_NAME/Contents/Resources/launch.sh" << 'LAUNCHSCRIPT'
+#!/bin/bash
+# Set PATH for node (AppleScript environment doesn't have user's PATH)
+export PATH="/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:$PATH"
+
+exec >> /tmp/mdv-debug.log 2>&1
+echo "=== $(date) ==="
+echo "FILE_PATH: $1"
+
+FILE_PATH="$1"
+FILE_NAME=$(basename "$FILE_PATH")
+LOG="/tmp/mdv-$$.log"
+
+echo "Starting MDV..."
+# Start MDV
+MDV_PATH_HERE --no-browser "$FILE_PATH" > "$LOG" 2>&1 &
+
+# Wait for server (max 5 sec)
+for i in {1..25}; do
+    sleep 0.2
+    PORT=$(grep -o 'localhost:[0-9]*' "$LOG" 2>/dev/null | head -1 | cut -d: -f2)
+    if [ -n "$PORT" ]; then
+        echo "Found port: $PORT"
+        echo "Opening browser..."
+        # Use osascript to open URL (works better from AppleScript context)
+        osascript -e "open location \"http://localhost:$PORT?file=$FILE_NAME\""
+        echo "Done"
+        exit 0
+    fi
+done
+
+echo "Timeout - using fallback"
+# Fallback
+osascript -e "open location \"http://localhost:8642?file=$FILE_NAME\""
+LAUNCHSCRIPT
+
+# Replace placeholder with actual path
+sed -i '' "s|MDV_PATH_HERE|$MDV_PATH|g" "$TEMP_DIR/$APP_NAME/Contents/Resources/launch.sh"
+chmod +x "$TEMP_DIR/$APP_NAME/Contents/Resources/launch.sh"
+
+# Info.plist設定
+cat << 'EOF' > "$TEMP_DIR/$APP_NAME/Contents/Info.plist"
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleIdentifier</key>
+	<string>com.panhouse.mdv</string>
+	<key>CFBundleDocumentTypes</key>
+	<array>
+		<dict>
+			<key>CFBundleTypeName</key>
+			<string>Markdown Document</string>
+			<key>CFBundleTypeRole</key>
+			<string>Viewer</string>
+			<key>LSItemContentTypes</key>
+			<array>
+				<string>net.daringfireball.markdown</string>
+				<string>public.plain-text</string>
+			</array>
+			<key>CFBundleTypeExtensions</key>
+			<array>
+				<string>md</string>
+				<string>markdown</string>
+				<string>mdown</string>
+			</array>
+		</dict>
+	</array>
+	<key>CFBundleExecutable</key>
+	<string>droplet</string>
+	<key>CFBundleName</key>
+	<string>MDV</string>
+	<key>CFBundlePackageType</key>
+	<string>APPL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>0.3.0</string>
+	<key>CFBundleVersion</key>
+	<string>0.3.0</string>
+	<key>LSMinimumSystemVersion</key>
+	<string>10.13</string>
+</dict>
+</plist>
+EOF
+
+echo "Signing app..."
+codesign --force --deep --sign - "$TEMP_DIR/$APP_NAME"
+
+# 既存のアプリを削除してインストール
+if [ -d "$APP_PATH" ]; then
+    echo "Removing existing $APP_PATH..."
+    rm -rf "$APP_PATH"
+fi
+
+echo "Installing to $APP_PATH..."
+cp -R "$TEMP_DIR/$APP_NAME" "$APP_PATH"
+
+# Remove quarantine attribute to prevent Gatekeeper warning
+echo "Removing quarantine attribute..."
+xattr -cr "$APP_PATH"
+
+# LaunchServices登録
+echo "Registering with LaunchServices..."
+/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -f "$APP_PATH"
+
+# クリーンアップ
+rm -rf "$TEMP_DIR"
+
+echo ""
+echo "=== Setup Complete ==="
+echo ""
+echo "MDV.app has been installed to /Applications"
+echo ""
+echo "To set MDV as the default app for .md files:"
+echo "1. Right-click any .md file in Finder"
+echo "2. Select 'Get Info'"
+echo "3. Under 'Open with', select 'MDV'"
+echo "4. Click 'Change All...'"
+echo ""

package/src/api/file.js

@@ -0,0 +1,243 @@
+/**
+ * File operations API routes
+ */
+
+import fs from 'fs/promises';
+import { createReadStream } from 'fs';
+import path from 'path';
+import mime from 'mime-types';
+import { getFileType } from '../utils/fileTypes.js';
+import { renderFile } from '../rendering/index.js';
+import { validatePath } from '../utils/path.js';
+
+/**
+ * Broadcast tree_update to all WebSocket clients
+ * @param {Express} app - Express app instance
+ */
+function broadcastTreeUpdate(app) {
+  const wss = app.locals.wss;
+  if (wss) {
+    const message = JSON.stringify({ type: 'tree_update' });
+    wss.clients.forEach(client => {
+      if (client.readyState === 1) { // WebSocket.OPEN
+        client.send(message);
+      }
+    });
+  }
+}
+
+/**
+ * Setup file routes
+ * @param {Express} app - Express app instance
+ */
+export function setupFileRoutes(app) {
+  // Get file content
+  app.get('/api/file', async (req, res) => {
+    try {
+      const { path: relativePath } = req.query;
+      if (!relativePath) {
+        return res.status(400).json({ error: 'Path is required' });
+      }
+
+      // Security check (must use relativePath, not fullPath)
+      if (!validatePath(relativePath, app.locals.rootDir)) {
+        return res.status(403).json({ error: 'Access denied' });
+      }
+
+      const fullPath = path.join(app.locals.rootDir, relativePath);
+      const stats = await fs.stat(fullPath);
+      if (stats.isDirectory()) {
+        return res.status(400).json({ error: 'Cannot read directory' });
+      }
+
+      const fileType = getFileType(relativePath);
+      const name = path.basename(relativePath);
+
+      // Handle binary files
+      if (fileType.binary) {
+        return res.json({
+          name,
+          fileType: fileType.type,
+          icon: fileType.icon,
+          downloadUrl: `/api/download?path=${encodeURIComponent(relativePath)}`,
+          // Special URLs for media types
+          ...(fileType.type === 'image' && {
+            imageUrl: `/api/download?path=${encodeURIComponent(relativePath)}`
+          }),
+          ...(fileType.type === 'pdf' && {
+            pdfUrl: `/api/download?path=${encodeURIComponent(relativePath)}`
+          }),
+          ...(['video', 'audio'].includes(fileType.type) && {
+            mediaUrl: `/api/download?path=${encodeURIComponent(relativePath)}`
+          })
+        });
+      }
+
+      // Read and render text files
+      const rendered = await renderFile(fullPath);
+
+      res.json({
+        name,
+        ...rendered
+      });
+    } catch (err) {
+      if (err.code === 'ENOENT') {
+        return res.status(404).json({ error: 'File not found' });
+      }
+      res.status(500).json({ error: err.message });
+    }
+  });
+
+  // Save file content
+  app.post('/api/file', async (req, res) => {
+    try {
+      const { path: relativePath, content } = req.body;
+      if (!relativePath) {
+        return res.status(400).json({ error: 'Path is required' });
+      }
+
+      // Security check (must use relativePath, not fullPath)
+      if (!validatePath(relativePath, app.locals.rootDir)) {
+        return res.status(403).json({ error: 'Access denied' });
+      }
+
+      const fullPath = path.join(app.locals.rootDir, relativePath);
+      await fs.writeFile(fullPath, content, 'utf-8');
+      broadcastTreeUpdate(app);
+      res.json({ success: true });
+    } catch (err) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+
+  // Delete file or directory
+  app.delete('/api/file', async (req, res) => {
+    try {
+      const { path: relativePath } = req.query;
+      if (!relativePath) {
+        return res.status(400).json({ error: 'Path is required' });
+      }
+
+      // Security check (must use relativePath, not fullPath)
+      if (!validatePath(relativePath, app.locals.rootDir)) {
+        return res.status(403).json({ error: 'Access denied' });
+      }
+
+      const fullPath = path.join(app.locals.rootDir, relativePath);
+      const stats = await fs.stat(fullPath);
+      if (stats.isDirectory()) {
+        await fs.rm(fullPath, { recursive: true });
+      } else {
+        await fs.unlink(fullPath);
+      }
+
+      broadcastTreeUpdate(app);
+      res.json({ success: true });
+    } catch (err) {
+      if (err.code === 'ENOENT') {
+        return res.status(404).json({ error: 'File not found' });
+      }
+      res.status(500).json({ error: err.message });
+    }
+  });
+
+  // Create directory
+  app.post('/api/mkdir', async (req, res) => {
+    try {
+      const { path: relativePath } = req.body;
+      if (!relativePath) {
+        return res.status(400).json({ error: 'Path is required' });
+      }
+
+      // Security check (must use relativePath, not fullPath)
+      if (!validatePath(relativePath, app.locals.rootDir)) {
+        return res.status(403).json({ error: 'Access denied' });
+      }
+
+      const fullPath = path.join(app.locals.rootDir, relativePath);
+      await fs.mkdir(fullPath, { recursive: true });
+      broadcastTreeUpdate(app);
+      res.json({ success: true });
+    } catch (err) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+
+  // Move/rename file or directory
+  app.post('/api/move', async (req, res) => {
+    try {
+      const { source, destination } = req.body;
+      if (!source || !destination) {
+        return res.status(400).json({ error: 'Source and destination are required' });
+      }
+
+      // Security check (must use relative paths, not full paths)
+      if (!validatePath(source, app.locals.rootDir) ||
+          !validatePath(destination, app.locals.rootDir)) {
+        return res.status(403).json({ error: 'Access denied' });
+      }
+
+      const sourcePath = path.join(app.locals.rootDir, source);
+      const destPath = path.join(app.locals.rootDir, destination);
+      await fs.rename(sourcePath, destPath);
+      broadcastTreeUpdate(app);
+      res.json({ success: true });
+    } catch (err) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+
+  // Download file (with Range Request support for video/audio streaming)
+  app.get('/api/download', async (req, res) => {
+    const { path: relativePath } = req.query;
+    if (!relativePath) {
+      return res.status(400).json({ error: 'Path is required' });
+    }
+
+    // Security check (must use relativePath, not fullPath)
+    if (!validatePath(relativePath, app.locals.rootDir)) {
+      return res.status(403).json({ error: 'Access denied' });
+    }
+
+    const fullPath = path.join(app.locals.rootDir, relativePath);
+
+    try {
+      const stat = await fs.stat(fullPath);
+      if (!stat.isFile()) {
+        return res.status(400).json({ error: 'Not a file' });
+      }
+
+      const fileSize = stat.size;
+      const range = req.headers.range;
+
+      if (range) {
+        // Range Request対応（動画/音声ストリーミング用）
+        const parts = range.replace(/bytes=/, '').split('-');
+        const start = parseInt(parts[0], 10);
+        const end = parts[1] ? parseInt(parts[1], 10) : fileSize - 1;
+        const chunkSize = end - start + 1;
+
+        const mimeType = mime.lookup(fullPath) || 'application/octet-stream';
+        res.writeHead(206, {
+          'Content-Range': `bytes ${start}-${end}/${fileSize}`,
+          'Accept-Ranges': 'bytes',
+          'Content-Length': chunkSize,
+          'Content-Type': mimeType,
+        });
+
+        const stream = createReadStream(fullPath, { start, end });
+        stream.pipe(res);
+      } else {
+        // 通常のファイル送信
+        res.sendFile(fullPath);
+      }
+    } catch (err) {
+      if (err.code === 'ENOENT') {
+        return res.status(404).json({ error: 'File not found' });
+      }
+      return res.status(500).json({ error: err.message });
+    }
+  });
+}
+
+export default setupFileRoutes;

package/src/api/pdf.js

@@ -0,0 +1,74 @@
+/**
+ * PDF Export API
+ * Uses marp-cli for Marp presentations
+ */
+
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import path from 'path';
+import fs from 'fs';
+import { fileURLToPath } from 'url';
+
+const execAsync = promisify(exec);
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Get path to local marp-cli binary
+const marpBin = path.join(__dirname, '..', '..', 'node_modules', '.bin', 'marp');
+
+/**
+ * Setup PDF export routes
+ * @param {Express} app - Express application
+ */
+export function setupPdfRoutes(app) {
+  // Export Marp presentation to PDF
+  app.post('/api/pdf/export', async (req, res) => {
+    const { filePath } = req.body;
+
+    if (!filePath) {
+      return res.status(400).json({ error: 'filePath is required' });
+    }
+
+    const rootDir = app.locals.rootDir;
+    const fullPath = path.join(rootDir, filePath);
+
+    // Security check: ensure path is within rootDir
+    const resolvedPath = path.resolve(fullPath);
+    if (!resolvedPath.startsWith(rootDir)) {
+      return res.status(403).json({ error: 'Access denied' });
+    }
+
+    // Check if file exists
+    if (!fs.existsSync(resolvedPath)) {
+      return res.status(404).json({ error: 'File not found' });
+    }
+
+    // Generate output path (same directory, .pdf extension)
+    const outputPath = resolvedPath.replace(/\.md$/, '.pdf');
+    const outputFileName = path.basename(outputPath);
+
+    try {
+      // Run marp-cli using local binary (faster than npx)
+      // --no-stdin prevents waiting for stdin input
+      const command = `"${marpBin}" "${resolvedPath}" -o "${outputPath}" --allow-local-files --no-stdin`;
+      await execAsync(command, { timeout: 60000 });
+
+      // Send PDF as download
+      res.download(outputPath, outputFileName, (err) => {
+        if (err) {
+          console.error('Download error:', err);
+        }
+        // Optionally delete the PDF after download
+        // fs.unlinkSync(outputPath);
+      });
+    } catch (error) {
+      console.error('PDF export error:', error);
+      res.status(500).json({
+        error: 'PDF export failed',
+        details: error.message
+      });
+    }
+  });
+}
+
+export default setupPdfRoutes;

package/src/api/tree.js

@@ -0,0 +1,111 @@
+/**
+ * File tree API routes
+ */
+
+import fs from 'fs/promises';
+import path from 'path';
+import { getFileType } from '../utils/fileTypes.js';
+import { validatePath } from '../utils/path.js';
+
+/**
+ * Build file tree for a directory
+ * @param {string} dirPath - Directory path
+ * @param {string} rootDir - Root directory for relative paths
+ * @param {number} depth - Current depth (for limiting recursion)
+ * @returns {Promise<Array>} Array of file/directory objects
+ */
+export async function buildFileTree(dirPath, rootDir, depth = 0) {
+  const items = [];
+  const maxInitialDepth = 1; // Only expand first level initially
+
+  try {
+    const entries = await fs.readdir(dirPath, { withFileTypes: true });
+
+    // Sort: directories first, then files, alphabetically
+    entries.sort((a, b) => {
+      if (a.isDirectory() && !b.isDirectory()) return -1;
+      if (!a.isDirectory() && b.isDirectory()) return 1;
+      return a.name.localeCompare(b.name);
+    });
+
+    for (const entry of entries) {
+      // Skip hidden files and common ignore patterns
+      if (entry.name.startsWith('.')) continue;
+      if (entry.name === 'node_modules') continue;
+      if (entry.name === '__pycache__') continue;
+
+      const fullPath = path.join(dirPath, entry.name);
+      const relativePath = path.relative(rootDir, fullPath).split(path.sep).join('/');
+
+      if (entry.isDirectory()) {
+        const item = {
+          type: 'directory',
+          name: entry.name,
+          path: relativePath,
+          children: [],
+          loaded: false
+        };
+
+        // Load children for first level
+        if (depth < maxInitialDepth) {
+          item.children = await buildFileTree(fullPath, rootDir, depth + 1);
+          item.loaded = true;
+        }
+
+        items.push(item);
+      } else {
+        const fileType = getFileType(entry.name);
+        items.push({
+          type: 'file',
+          name: entry.name,
+          path: relativePath,
+          icon: fileType.icon
+        });
+      }
+    }
+  } catch (err) {
+    console.error(`Error reading directory ${dirPath}:`, err);
+  }
+
+  return items;
+}
+
+/**
+ * Setup file tree routes
+ * @param {Express} app - Express app instance
+ */
+export function setupTreeRoutes(app) {
+  // Get full tree
+  app.get('/api/tree', async (req, res) => {
+    try {
+      const tree = await buildFileTree(app.locals.rootDir, app.locals.rootDir);
+      res.json(tree);
+    } catch (err) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+
+  // Expand a directory (lazy loading)
+  app.get('/api/tree/expand', async (req, res) => {
+    try {
+      const { path: relativePath } = req.query;
+      if (!relativePath) {
+        return res.status(400).json({ error: 'Path is required' });
+      }
+
+      const fullPath = path.join(app.locals.rootDir, relativePath);
+
+      // Security: ensure path is within root
+      if (!validatePath(relativePath, app.locals.rootDir)) {
+        return res.status(403).json({ error: 'Access denied' });
+      }
+
+      const children = await buildFileTree(fullPath, app.locals.rootDir, 0);
+      res.json(children);
+    } catch (err) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+}
+
+export default setupTreeRoutes;