mind-hiro 0.2.0

package/README.md

@@ -0,0 +1,102 @@
+# Mind Hiro
+
+Generate a **self-contained, interactive mind-map website** from a folder of Markdown files — one HTML file, works offline, no server needed.
+
+Powered by [markmap](https://markmap.js.org/) + [Vite](https://vitejs.dev/).
+
+---
+
+## Features
+
+- **Three-panel UI** — sidebar file list, Markdown editor, live mind-map renderer
+- **Live editing** — edit Markdown in the browser; mind map updates in real time
+- **Search** — filter files by filename or content
+- **Share links** — compress current Markdown into a URL hash and copy to clipboard
+- **Dark / light mode** — persisted to `localStorage`
+- **Local edits saved** — browser remembers your edits per file across sessions
+- **Fully self-contained** — all JS/CSS inlined; no CDN, works offline
+
+---
+
+## CLI
+
+```bash
+npx mind-hiro generate <dir> [options]
+```
+
+```
+Options:
+  -o, --output <file>   Output HTML file (default: mind-hiro.html)
+  -r, --recursive       Scan subdirectories recursively
+  -h, --help            Show help
+```
+
+### Examples
+
+```bash
+# Generate from a docs folder
+npx mind-hiro generate ./docs -o site.html
+
+# Include subdirectories
+npx mind-hiro generate ./notes -r -o notes.html
+```
+
+Then open `site.html` in any browser — no server needed.
+
+---
+
+## Install globally
+
+```bash
+npm install -g mind-hiro
+mind-hiro generate ./docs -o site.html
+```
+
+---
+
+## Programmatic API
+
+```ts
+import { generate } from 'mind-hiro'
+
+const html = generate([
+  { name: 'Architecture', content: '# Architecture\n## Frontend\n## Backend' },
+  { name: 'Roadmap',      content: '# Roadmap\n## Q1\n## Q2' },
+])
+
+import { writeFileSync } from 'fs'
+writeFileSync('output.html', html)
+```
+
+### `generate(files): string`
+
+| Parameter | Type | Description |
+|---|---|---|
+| `files` | `MindMapFile[]` | Array of `{ name: string, content: string }` objects |
+| returns | `string` | Self-contained HTML string |
+
+```ts
+interface MindMapFile {
+  name: string     // Shown in the sidebar (filename without extension)
+  content: string  // Raw Markdown content
+}
+```
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/your-username/mind-hiro
+cd mind-hiro
+npm install
+
+npm run dev        # Start Vite dev server
+npm run build      # Build app + CLI
+```
+
+---
+
+## License
+
+MIT

package/dist-lib/shared/types.d.ts

@@ -0,0 +1,4 @@
+export interface MindMapFile {
+    name: string;
+    content: string;
+}

package/dist-lib/shared/types.js

@@ -0,0 +1 @@
+export {};

package/dist-lib/src/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist-lib/src/cli.js

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+import { readdirSync, readFileSync, writeFileSync, statSync } from 'fs';
+import { join, extname, basename, resolve } from 'path';
+import { generate } from './generator.js';
+function printHelp() {
+    console.log(`
+  mind-hiro — Generate an interactive mind map HTML site from Markdown files
+
+  Usage:
+    mind-hiro generate <dir> [options]
+
+  Options:
+    -o, --output <file>   Output HTML file path (default: mind-hiro.html)
+    -r, --recursive       Scan subdirectories recursively
+    -h, --help            Show this help message
+
+  Examples:
+    mind-hiro generate ./docs -o site.html
+    mind-hiro generate ./notes -r -o notes.html
+`);
+}
+function collectFiles(dir, recursive) {
+    const files = [];
+    function scan(currentDir) {
+        let entries;
+        try {
+            entries = readdirSync(currentDir);
+        }
+        catch {
+            console.error(`Error reading directory: ${currentDir}`);
+            process.exit(1);
+        }
+        // Sort entries for consistent ordering
+        entries.sort();
+        for (const entry of entries) {
+            const fullPath = join(currentDir, entry);
+            const stat = statSync(fullPath);
+            if (stat.isDirectory()) {
+                if (recursive)
+                    scan(fullPath);
+            }
+            else if (extname(entry).toLowerCase() === '.md') {
+                const content = readFileSync(fullPath, 'utf-8');
+                const name = basename(entry, '.md');
+                files.push({ name, content });
+            }
+        }
+    }
+    scan(resolve(dir));
+    return files;
+}
+function run() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+        printHelp();
+        process.exit(0);
+    }
+    const subcommand = args[0];
+    if (subcommand !== 'generate') {
+        console.error(`Unknown subcommand: ${subcommand}`);
+        printHelp();
+        process.exit(1);
+    }
+    const rest = args.slice(1);
+    if (rest.length === 0 || rest[0].startsWith('-')) {
+        console.error('Error: <dir> argument is required');
+        printHelp();
+        process.exit(1);
+    }
+    const dir = rest[0];
+    let output = 'mind-hiro.html';
+    let recursive = false;
+    for (let i = 1; i < rest.length; i++) {
+        const flag = rest[i];
+        if (flag === '-o' || flag === '--output') {
+            const next = rest[++i];
+            if (!next) {
+                console.error('Error: --output requires a file path argument');
+                process.exit(1);
+            }
+            output = next;
+        }
+        else if (flag === '-r' || flag === '--recursive') {
+            recursive = true;
+        }
+        else if (flag === '-h' || flag === '--help') {
+            printHelp();
+            process.exit(0);
+        }
+        else {
+            console.error(`Unknown option: ${flag}`);
+            printHelp();
+            process.exit(1);
+        }
+    }
+    console.log(`Scanning ${dir}${recursive ? ' (recursive)' : ''}...`);
+    const files = collectFiles(dir, recursive);
+    if (files.length === 0) {
+        console.warn('Warning: No .md files found in the specified directory');
+        process.exit(0);
+    }
+    console.log(`Found ${files.length} file(s): ${files.map((f) => f.name).join(', ')}`);
+    const html = generate(files);
+    writeFileSync(output, html, 'utf-8');
+    console.log(`Generated ${output} (${Math.round(html.length / 1024)} KB)`);
+}
+run();

package/dist-lib/src/generator.d.ts

@@ -0,0 +1,2 @@
+import type { MindMapFile } from '../shared/types.js';
+export declare function generate(files: MindMapFile[]): string;

package/dist-lib/src/generator.js

@@ -0,0 +1,17 @@
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { join, dirname } from 'path';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TEMPLATE_PATH = join(__dirname, '../../template/index.html');
+let _template = null;
+function getTemplate() {
+    if (_template === null) {
+        _template = readFileSync(TEMPLATE_PATH, 'utf-8');
+    }
+    return _template;
+}
+export function generate(files) {
+    const template = getTemplate();
+    const json = JSON.stringify(files);
+    return template.replace('>[]</script>', `>${json}</script>`);
+}

package/dist-lib/src/index.d.ts

@@ -0,0 +1,2 @@
+export type { MindMapFile } from '../shared/types.js';
+export { generate } from './generator.js';

package/dist-lib/src/index.js

@@ -0,0 +1 @@
+export { generate } from './generator.js';

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "mind-hiro",
+  "version": "0.2.0",
+  "description": "Generate a self-contained interactive mind-map website from Markdown files",
+  "type": "module",
+  "main": "./dist-lib/src/index.js",
+  "bin": {
+    "mind-hiro": "./dist-lib/src/cli.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist-lib/src/index.js"
+    }
+  },
+  "files": [
+    "dist-lib",
+    "template"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build:app": "vite build",
+    "build:lib": "tsc -p tsconfig.node.json",
+    "build": "npm run build:app && npm run build:lib",
+    "prepublishOnly": "npm run build",
+    "preview": "vite preview",
+    "type-check": "tsc --noEmit && tsc -p tsconfig.node.json --noEmit"
+  },
+  "keywords": [
+    "mindmap",
+    "markdown",
+    "markmap",
+    "visualization",
+    "cli",
+    "static-site"
+  ],
+  "license": "MIT",
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^20.12.0",
+    "autoprefixer": "^10.4.19",
+    "lz-string": "^1.5.0",
+    "markmap-lib": "^0.18.12",
+    "markmap-view": "^0.18.12",
+    "postcss": "^8.4.38",
+    "tailwindcss": "^3.4.3",
+    "typescript": "^5.4.0",
+    "vite": "^5.2.0",
+    "vite-plugin-singlefile": "^2.0.0"
+  }
+}