@jotx-labs/cli 2.2.1

package/README.md

@@ -0,0 +1,155 @@
+# @jotx/cli
+
+Command-line interface for jotx - demonstrates platform independence.
+
+## Installation
+
+```bash
+npm install -g @jotx/cli
+```
+
+## Usage
+
+### Parse a file
+
+```bash
+jotx parse notes.jot
+```
+
+Shows the AST (Abstract Syntax Tree) of the document.
+
+### Validate a file
+
+```bash
+jotx validate notes.jot
+```
+
+Checks if the file is valid jotx syntax.
+
+### Convert to HTML
+
+```bash
+# Output to stdout
+jotx convert notes.jot
+
+# Output to file
+jotx convert notes.jot -o notes.html
+```
+
+Converts a `.jot` file to HTML.
+
+### Show info
+
+```bash
+jotx info notes.jot
+```
+
+Shows document metadata and statistics.
+
+## Examples
+
+```bash
+# Validate all .jot files in current directory
+for file in *.jot; do jotx validate "$file"; done
+
+# Convert all .jot files to HTML
+for file in *.jot; do jotx convert "$file" -o "${file%.jot}.html"; done
+
+# Parse and pretty-print
+jotx parse notes.jot | jq .
+```
+
+## Architecture
+
+The CLI demonstrates jotx's platform independence:
+
+- Uses `@jotx/core` for parsing/validation
+- Uses `NodePlatform` from `@jotx/adapters` for file I/O
+- Uses `HTMLRenderer` from `@jotx/adapters` for output
+- **Zero** VS Code dependencies
+- **Zero** browser dependencies
+
+Same core logic, different platform!
+
+## Development
+
+```bash
+# Build
+npm run build
+
+# Test locally
+node dist/cli.js parse test.jot
+```
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * jotx CLI - Demonstrates platform independence
+ * Uses @jotx/core + NodePlatform
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/cli.js

@@ -0,0 +1,192 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * jotx CLI - Demonstrates platform independence
+ * Uses @jotx/core + NodePlatform
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const fs = __importStar(require("fs/promises"));
+const program = new commander_1.Command();
+program
+    .name('jotx')
+    .description('jotx CLI - Parse, validate, and convert jotx files')
+    .version('1.0.22');
+// Parse command
+program
+    .command('parse <file>')
+    .description('Parse a .jot file and show AST')
+    .action(async (file) => {
+    try {
+        const text = await fs.readFile(file, 'utf-8');
+        const result = core.parseAndValidate(text);
+        if (result.isValid) {
+            console.log('✅ Parse successful!');
+            console.log(JSON.stringify(result.ast, null, 2));
+        }
+        else {
+            console.error('❌ Parse failed:');
+            result.validation.errors.forEach(err => {
+                console.error(`  - ${err.message}`);
+            });
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error('❌ Error:', error);
+        process.exit(1);
+    }
+});
+// Validate command
+program
+    .command('validate <file>')
+    .description('Validate a .jot file')
+    .action(async (file) => {
+    try {
+        const text = await fs.readFile(file, 'utf-8');
+        const result = core.parseAndValidate(text);
+        if (result.isValid) {
+            console.log(`✅ ${file} is valid!`);
+            console.log(`   Document: ${result.ast.document.id}`);
+            console.log(`   Type: ${result.ast.document.documentType}`);
+            console.log(`   Blocks: ${result.ast.document.blocks.length}`);
+        }
+        else {
+            console.error(`❌ ${file} has errors:`);
+            result.validation.errors.forEach(err => {
+                console.error(`  - ${err.message}`);
+            });
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error('❌ Error:', error);
+        process.exit(1);
+    }
+});
+// Convert command
+program
+    .command('convert <file>')
+    .description('Convert .jot file to HTML')
+    .option('-o, --output <file>', 'Output file (default: stdout)')
+    .action(async (file, options) => {
+    try {
+        const text = await fs.readFile(file, 'utf-8');
+        const result = core.parseAndValidate(text);
+        if (!result.isValid) {
+            console.error('❌ File has errors:');
+            result.validation.errors.forEach(err => {
+                console.error(`  - ${err.message}`);
+            });
+            process.exit(1);
+        }
+        // Render to HTML
+        const html = renderer.render({
+            id: result.ast.document.id,
+            type: result.ast.document.documentType,
+            metadata: result.ast.document.metadata,
+            blocks: result.ast.document.blocks
+        });
+        // Wrap in full HTML document
+        const fullHtml = `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${result.ast.document.metadata.title || 'jotx Document'}</title>
+  <style>
+    body { font-family: system-ui, -apple-system, sans-serif; max-width: 800px; margin: 40px auto; padding: 0 20px; }
+    h1 { font-size: 2em; margin-bottom: 0.5em; }
+    h2 { font-size: 1.5em; margin-top: 1.5em; }
+    h3 { font-size: 1.2em; margin-top: 1.2em; }
+    code { background: #f5f5f5; padding: 2px 6px; border-radius: 3px; }
+    pre { background: #f5f5f5; padding: 16px; border-radius: 6px; overflow-x: auto; }
+    blockquote { border-left: 4px solid #ddd; padding-left: 16px; margin-left: 0; color: #666; }
+  </style>
+</head>
+<body>
+${html}
+</body>
+</html>`;
+        if (options.output) {
+            await fs.writeFile(options.output, fullHtml, 'utf-8');
+            console.log(`✅ Converted to ${options.output}`);
+        }
+        else {
+            console.log(fullHtml);
+        }
+    }
+    catch (error) {
+        console.error('❌ Error:', error);
+        process.exit(1);
+    }
+});
+// Info command
+program
+    .command('info <file>')
+    .description('Show document information')
+    .action(async (file) => {
+    try {
+        const text = await fs.readFile(file, 'utf-8');
+        const result = core.parseAndValidate(text);
+        if (!result.isValid) {
+            console.error('❌ File has errors');
+            process.exit(1);
+        }
+        const doc = result.ast.document;
+        console.log('📄 Document Information');
+        console.log('─'.repeat(50));
+        console.log(`ID:       ${doc.id}`);
+        console.log(`Type:     ${doc.documentType}`);
+        console.log(`Title:    ${doc.metadata.title || '(none)'}`);
+        console.log(`Blocks:   ${doc.blocks.length}`);
+        console.log();
+        console.log('Block Types:');
+        const blockCounts = {};
+        doc.blocks.forEach(block => {
+            blockCounts[block.type] = (blockCounts[block.type] || 0) + 1;
+        });
+        Object.entries(blockCounts).forEach(([type, count]) => {
+            console.log(`  - ${type}: ${count}`);
+        });
+    }
+    catch (error) {
+        console.error('❌ Error:', error);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@jotx-labs/cli",
+  "version": "2.2.1",
+  "description": "jotx command-line interface",
+  "main": "dist/index.js",
+  "bin": {
+    "jotx": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "jotx",
+    "cli",
+    "notes",
+    "parser"
+  ],
+  "author": "jotx",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@jotx/core": "file:../core",
+    "@jotx/adapters": "file:../adapters",
+    "commander": "^11.0.0",
+    "chalk": "^4.1.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+/**
+ * jotx CLI - Demonstrates platform independence
+ * Uses @jotx/core + NodePlatform
+ */
+
+import { Command } from 'commander'
+import * as fs from 'fs/promises'
+import * as path from 'path'
+import { jotToMarkdown, markdownToJot } from '@jotx-labs/core'
+
+const program = new Command()
+
+program
+  .name('jotx')
+  .description('jotx CLI - Parse, validate, and convert jotx files')
+  .version('1.0.22')
+
+// Parse command
+program
+  .command('parse <file>')
+  .description('Parse a .jot file and show AST')
+  .action(async (file: string) => {
+    try {
+      const text = await fs.readFile(file, 'utf-8')
+      const result = core.parseAndValidate(text)
+
+      if (result.isValid) {
+        console.log('✅ Parse successful!')
+        console.log(JSON.stringify(result.ast, null, 2))
+      } else {
+        console.error('❌ Parse failed:')
+        result.validation.errors.forEach(err => {
+          console.error(`  - ${err.message}`)
+        })
+        process.exit(1)
+      }
+    } catch (error) {
+      console.error('❌ Error:', error)
+      process.exit(1)
+    }
+  })
+
+// Validate command
+program
+  .command('validate <file>')
+  .description('Validate a .jot file')
+  .action(async (file: string) => {
+    try {
+      const text = await fs.readFile(file, 'utf-8')
+      const result = core.parseAndValidate(text)
+
+      if (result.isValid) {
+        console.log(`✅ ${file} is valid!`)
+        console.log(`   Document: ${result.ast.document.id}`)
+        console.log(`   Type: ${result.ast.document.documentType}`)
+        console.log(`   Blocks: ${result.ast.document.blocks.length}`)
+      } else {
+        console.error(`❌ ${file} has errors:`)
+        result.validation.errors.forEach(err => {
+          console.error(`  - ${err.message}`)
+        })
+        process.exit(1)
+      }
+    } catch (error) {
+      console.error('❌ Error:', error)
+      process.exit(1)
+    }
+  })
+
+// Convert command
+program
+  .command('convert <file>')
+  .description('Convert .jot file to HTML')
+  .option('-o, --output <file>', 'Output file (default: stdout)')
+  .action(async (file: string, options: { output?: string }) => {
+    try {
+      const text = await fs.readFile(file, 'utf-8')
+      const result = core.parseAndValidate(text)
+
+      if (!result.isValid) {
+        console.error('❌ File has errors:')
+        result.validation.errors.forEach(err => {
+          console.error(`  - ${err.message}`)
+        })
+        process.exit(1)
+      }
+
+      // Render to HTML
+      const html = renderer.render({
+        id: result.ast.document.id,
+        type: result.ast.document.documentType,
+        metadata: result.ast.document.metadata,
+        blocks: result.ast.document.blocks as any
+      } as any)
+
+      // Wrap in full HTML document
+      const fullHtml = `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${result.ast.document.metadata.title || 'jotx Document'}</title>
+  <style>
+    body { font-family: system-ui, -apple-system, sans-serif; max-width: 800px; margin: 40px auto; padding: 0 20px; }
+    h1 { font-size: 2em; margin-bottom: 0.5em; }
+    h2 { font-size: 1.5em; margin-top: 1.5em; }
+    h3 { font-size: 1.2em; margin-top: 1.2em; }
+    code { background: #f5f5f5; padding: 2px 6px; border-radius: 3px; }
+    pre { background: #f5f5f5; padding: 16px; border-radius: 6px; overflow-x: auto; }
+    blockquote { border-left: 4px solid #ddd; padding-left: 16px; margin-left: 0; color: #666; }
+  </style>
+</head>
+<body>
+${html}
+</body>
+</html>`
+
+      if (options.output) {
+        await fs.writeFile(options.output, fullHtml, 'utf-8')
+        console.log(`✅ Converted to ${options.output}`)
+      } else {
+        console.log(fullHtml)
+      }
+    } catch (error) {
+      console.error('❌ Error:', error)
+      process.exit(1)
+    }
+  })
+
+// Info command
+program
+  .command('info <file>')
+  .description('Show document information')
+  .action(async (file: string) => {
+    try {
+      const text = await fs.readFile(file, 'utf-8')
+      const result = core.parseAndValidate(text)
+
+      if (!result.isValid) {
+        console.error('❌ File has errors')
+        process.exit(1)
+      }
+
+      const doc = result.ast.document
+
+      console.log('📄 Document Information')
+      console.log('─'.repeat(50))
+      console.log(`ID:       ${doc.id}`)
+      console.log(`Type:     ${doc.documentType}`)
+      console.log(`Title:    ${doc.metadata.title || '(none)'}`)
+      console.log(`Blocks:   ${doc.blocks.length}`)
+      console.log()
+      console.log('Block Types:')
+
+      const blockCounts: Record<string, number> = {}
+      doc.blocks.forEach(block => {
+        blockCounts[block.type] = (blockCounts[block.type] || 0) + 1
+      })
+
+      Object.entries(blockCounts).forEach(([type, count]) => {
+        console.log(`  - ${type}: ${count}`)
+      })
+    } catch (error) {
+      console.error('❌ Error:', error)
+      process.exit(1)
+    }
+  })
+
+program.parse()
+

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}
+