@mgks/docmd 0.3.3 → 0.3.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mgks/docmd",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Generate beautiful, lightweight static documentation sites directly from your Markdown files. Zero clutter, just content.",
   "main": "src/index.js",
   "exports": {
@@ -15,6 +15,7 @@
   "scripts": {
     "start": "node ./bin/docmd.js dev",
     "build": "node ./bin/docmd.js build",
+    "live": "node scripts/build-live.js && npx serve dist",
     "postinstall": "node ./bin/postinstall.js",
     "lint": "eslint .",
     "format": "prettier --write .",
@@ -22,32 +23,32 @@
   },
   "dependencies": {
     "chalk": "^4.1.2",
-    "chokidar": "^4.0.3",
+    "chokidar": "^5.0.0",
     "clean-css": "^5.3.3",
-    "commander": "^14.0.0",
-    "ejs": "^3.1.9",
-    "esbuild": "^0.27.0",
-    "express": "^5.1.0",
-    "fs-extra": "^11.2.0",
+    "commander": "^14.0.2",
+    "ejs": "^3.1.10",
+    "express": "^5.2.1",
+    "fs-extra": "^11.3.3",
     "gray-matter": "^4.0.3",
     "highlight.js": "^11.11.1",
-    "lucide-static": "^0.535.0",
+    "lucide-static": "^0.562.0",
+    "markdown-it": "^14.1.0",
     "markdown-it-abbr": "^2.0.0",
     "markdown-it-attrs": "^4.3.1",
     "markdown-it-container": "^4.0.0",
     "markdown-it-deflist": "^3.0.0",
     "markdown-it-footnote": "^4.0.0",
     "markdown-it-task-lists": "^2.1.1",
-    "mermaid": "^11.12.1",
+    "mermaid": "^11.12.2",
     "minisearch": "^7.2.0",
     "striptags": "^3.2.0",
-    "ws": "^8.17.0"
+    "ws": "^8.18.3"
   },
   "devDependencies": {
-    "eslint": "^9.32.0",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-node": "^11.1.0",
-    "prettier": "^3.2.5"
+    "buffer": "^6.0.3",
+    "esbuild": "^0.27.2",
+    "eslint": "^9.39.2",
+    "prettier": "^3.7.4"
   },
   "directories": {
     "doc": "docs"
@@ -77,4 +78,4 @@
   "homepage": "https://github.com/mgks/docmd#readme",
   "funding": "https://github.com/sponsors/mgks",
   "license": "MIT"
-}
+}

package/scripts/build-live.js

@@ -0,0 +1,157 @@
+const fs = require('fs-extra');
+const path = require('path');
+const esbuild = require('esbuild');
+
+async function build() {
+    console.log('📦 Building @docmd/live core...');
+
+    const SRC_DIR = path.join(__dirname, '../src');
+    const LIVE_SRC_DIR = path.join(SRC_DIR, 'live');
+    const DIST_DIR = path.join(__dirname, '../dist');
+
+    // Ensure dist exists and is empty
+    fs.emptyDirSync(DIST_DIR);
+
+    // 1. Read Templates
+    const templatesDir = path.join(SRC_DIR, 'templates');
+    const files = fs.readdirSync(templatesDir);
+    const templates = {};
+
+    for (const file of files) {
+        if (file.endsWith('.ejs')) {
+            templates[file] = fs.readFileSync(path.join(templatesDir, file), 'utf8');
+        }
+    }
+
+    // 2. Generate templates.js
+    const templatesJsPath = path.join(LIVE_SRC_DIR, 'templates.js');
+    const templatesContent = `
+const templates = ${JSON.stringify(templates, null, 2)};
+if (typeof globalThis !== 'undefined') globalThis.__DOCMD_TEMPLATES__ = templates;
+module.exports = templates;
+`;
+    fs.writeFileSync(templatesJsPath, templatesContent);
+
+    // 3. Generate Shim for Buffer
+    const shimPath = path.join(LIVE_SRC_DIR, 'shims.js');
+    fs.writeFileSync(shimPath, `import { Buffer } from 'buffer'; globalThis.Buffer = Buffer;`);
+
+    // 4. Bundle JS
+    try {
+        await esbuild.build({
+            entryPoints: [path.join(LIVE_SRC_DIR, 'core.js')],
+            bundle: true,
+            outfile: path.join(DIST_DIR, 'docmd-live.js'),
+            platform: 'browser',
+            format: 'iife',
+            globalName: 'docmd',
+            minify: true,
+            define: { 'process.env.NODE_ENV': '"production"' },
+            inject: [shimPath],
+            plugins: [
+                {
+                    name: 'node-deps-shim',
+                    setup(build) {
+                        build.onResolve({ filter: /^path$/ }, args => ({ path: args.path, namespace: 'path-shim' }));
+                        build.onLoad({ filter: /.*/, namespace: 'path-shim' }, () => ({
+                            contents: `
+                                module.exports = {
+                                    join: (...args) => args.filter(Boolean).join('/'),
+                                    resolve: (...args) => '/' + args.filter(Boolean).join('/'),
+                                    basename: (p) => p ? p.split(/[\\\\/]/).pop() : '',
+                                    dirname: (p) => p ? p.split(/[\\\\/]/).slice(0, -1).join('/') || '.' : '.',
+                                    extname: (p) => {
+                                        if (!p) return '';
+                                        const parts = p.split('.');
+                                        return parts.length > 1 ? '.' + parts.pop() : '';
+                                    },
+                                    isAbsolute: (p) => p.startsWith('/'),
+                                    normalize: (p) => p,
+                                    sep: '/'
+                                };
+                            `,
+                            loader: 'js'
+                        }));
+
+                        build.onResolve({ filter: /^(fs|fs-extra)$/ }, args => ({ path: args.path, namespace: 'fs-shim' }));
+                        build.onLoad({ filter: /.*/, namespace: 'fs-shim' }, () => ({
+                            contents: `
+                                module.exports = {
+                                    existsSync: (p) => {
+                                        if (!globalThis.__DOCMD_TEMPLATES__) return false;
+                                        let name = p.split(/[\\\\/]/).pop(); 
+                                        if (globalThis.__DOCMD_TEMPLATES__[name]) return true;
+                                        if (!name.endsWith('.ejs') && globalThis.__DOCMD_TEMPLATES__[name + '.ejs']) return true;
+                                        return false;
+                                    },
+                                    readFileSync: (p) => {
+                                        if (!globalThis.__DOCMD_TEMPLATES__) return '';
+                                        let name = p.split(/[\\\\/]/).pop();
+                                        if (globalThis.__DOCMD_TEMPLATES__[name]) return globalThis.__DOCMD_TEMPLATES__[name];
+                                        if (!name.endsWith('.ejs')) name += '.ejs';
+                                        return globalThis.__DOCMD_TEMPLATES__[name] || '';
+                                    },
+                                    statSync: () => ({ isFile: () => true, isDirectory: () => false }),
+                                    constants: { F_OK: 0, R_OK: 4 }
+                                };
+                            `, 
+                            loader: 'js'
+                        }));
+                    }
+                }
+            ]
+        });
+        console.log('✅ Bundled JS to dist/docmd-live.js');
+
+        // 5. Copy Assets
+        console.log('📂 Copying assets...');
+        await fs.copy(path.join(SRC_DIR, 'assets'), path.join(DIST_DIR, 'assets'));
+        
+        // 5.5 Bundle Third-Party Libraries (The FIX)
+        // We need to manually copy these from node_modules because they aren't in src/assets
+        const copyLibrary = async (packageName, fileToBundle, destFileName) => {
+            try {
+                // Try to resolve the package path
+                let srcPath;
+                try {
+                    srcPath = require.resolve(`${packageName}/${fileToBundle}`);
+                } catch (e) {
+                    // Fallback search if require.resolve fails
+                    const mainPath = require.resolve(packageName);
+                    let currentDir = path.dirname(mainPath);
+                    for (let i = 0; i < 5; i++) {
+                        if (fs.existsSync(path.join(currentDir, 'package.json'))) break;
+                        currentDir = path.dirname(currentDir);
+                    }
+                    srcPath = path.join(currentDir, fileToBundle);
+                }
+
+                if (srcPath && fs.existsSync(srcPath)) {
+                    const destPath = path.join(DIST_DIR, 'assets/js', destFileName);
+                    await fs.ensureDir(path.dirname(destPath));
+                    await fs.copy(srcPath, destPath);
+                    console.log(`   └─ Copied ${packageName} -> assets/js/${destFileName}`);
+                } else {
+                    console.warn(`⚠️ Could not locate ${fileToBundle} in ${packageName}`);
+                }
+            } catch (e) {
+                console.warn(`⚠️ Failed to bundle ${packageName}: ${e.message}`);
+            }
+        };
+
+        await copyLibrary('minisearch', 'dist/umd/index.js', 'minisearch.js');
+        await copyLibrary('mermaid', 'dist/mermaid.min.js', 'mermaid.min.js');
+        console.log('✅ Assets & Libraries copied.');
+
+        // 6. Copy Demo HTML
+        await fs.copy(path.join(LIVE_SRC_DIR, 'index.html'), path.join(DIST_DIR, 'index.html'));
+        await fs.copy(path.join(LIVE_SRC_DIR, 'live.css'), path.join(DIST_DIR, 'live.css'));
+        console.log('✅ Demo HTML copied.');
+
+    } catch (e) {
+        console.error('❌ Build failed:', e);
+        process.exit(1);
+    }
+}
+
+build();

package/scripts/test-live.js

@@ -0,0 +1,54 @@
+const fs = require('fs');
+const path = require('path');
+const vm = require('vm');
+
+const bundlePath = path.join(__dirname, '../dist/docmd-live.js');
+
+if (!fs.existsSync(bundlePath)) {
+    console.error('❌ Bundle not found. Run "npm run live" or "node scripts/build-live.js" first.');
+    process.exit(1);
+}
+
+const bundleCode = fs.readFileSync(bundlePath, 'utf8');
+
+const sandbox = { 
+    console: console,
+    setTimeout: setTimeout,
+    clearTimeout: clearTimeout,
+    window: {},
+    self: {},
+    globalThis: {}
+};
+sandbox.window = sandbox;
+sandbox.self = sandbox;
+sandbox.globalThis = sandbox;
+
+vm.createContext(sandbox);
+
+console.log('🧪 Testing Live Bundle...');
+
+try {
+    vm.runInContext(bundleCode, sandbox);
+    
+    if (!sandbox.docmd) {
+        throw new Error('docmd global not found in bundle');
+    }
+
+    const markdown = '# Hello Live\nThis is a test.';
+    const config = { siteTitle: 'Live Test' };
+    
+    console.log('Compiling markdown...');
+    const result = sandbox.docmd.compile(markdown, config);
+    
+    if (result.includes('<h1>Hello Live</h1>') && result.includes('Live Test')) {
+        console.log('✅ Bundle works! Output contains expected HTML.');
+    } else {
+        console.error('❌ Bundle produced unexpected output.');
+        console.log('Output snippet:', result.substring(0, 200));
+        process.exit(1);
+    }
+
+} catch (e) {
+    console.error('❌ Test failed:', e);
+    process.exit(1);
+}

package/src/assets/css/docmd-highlight-dark.css

@@ -0,0 +1 @@
+pre code.hljs{display:block;overflow-x:auto;padding:1em}code.hljs{padding:3px 5px}.hljs{color:#abb2bf;background:#282c34}.hljs-comment,.hljs-quote{color:#5c6370;font-style:italic}.hljs-doctag,.hljs-formula,.hljs-keyword{color:#c678dd}.hljs-deletion,.hljs-name,.hljs-section,.hljs-selector-tag,.hljs-subst{color:#e06c75}.hljs-literal{color:#56b6c2}.hljs-addition,.hljs-attribute,.hljs-meta .hljs-string,.hljs-regexp,.hljs-string{color:#98c379}.hljs-attr,.hljs-number,.hljs-selector-attr,.hljs-selector-class,.hljs-selector-pseudo,.hljs-template-variable,.hljs-type,.hljs-variable{color:#d19a66}.hljs-bullet,.hljs-link,.hljs-meta,.hljs-selector-id,.hljs-symbol,.hljs-title{color:#61aeee}.hljs-built_in,.hljs-class .hljs-title,.hljs-title.class_{color:#e6c07b}.hljs-emphasis{font-style:italic}.hljs-strong{font-weight:700}.hljs-link{text-decoration:underline}

package/src/assets/css/docmd-highlight-light.css

@@ -0,0 +1 @@
+pre code.hljs{display:block;overflow-x:auto;padding:1em}code.hljs{padding:3px 5px}.hljs{color:#383a42;background:#fafafa}.hljs-comment,.hljs-quote{color:#a0a1a7;font-style:italic}.hljs-doctag,.hljs-formula,.hljs-keyword{color:#a626a4}.hljs-deletion,.hljs-name,.hljs-section,.hljs-selector-tag,.hljs-subst{color:#e45649}.hljs-literal{color:#0184bb}.hljs-addition,.hljs-attribute,.hljs-meta .hljs-string,.hljs-regexp,.hljs-string{color:#50a14f}.hljs-attr,.hljs-number,.hljs-selector-attr,.hljs-selector-class,.hljs-selector-pseudo,.hljs-template-variable,.hljs-type,.hljs-variable{color:#986801}.hljs-bullet,.hljs-link,.hljs-meta,.hljs-selector-id,.hljs-symbol,.hljs-title{color:#4078f2}.hljs-built_in,.hljs-class .hljs-title,.hljs-title.class_{color:#c18401}.hljs-emphasis{font-style:italic}.hljs-strong{font-weight:700}.hljs-link{text-decoration:underline}