Official Manual

JSM3TS Documentation & Full CLI Reference

Complete guide to installation, transpilation modes, batch runner queues, and system diagnostics.

Node.js Projects: If you compile backend files using native Node.js modules (fs, http, path, Buffer), run npm i -D @types/node in your project directory so tsc can verify Node types.

1. Cross-Platform Installation

JSM3TS includes a built-in installer that configures directories, system PATH, and Desktop shortcuts automatically.

Windows (PowerShell)

.\jts.exe install
jts doctor

Linux & macOS (Terminal)

chmod +x jts && ./jts install
jts doctor

2. The 4 Transpilation Modes

Mode Commands

jts app.js              # Transpile using active persistent mode
jts mode                # Display current active mode
jts mode w              # Full Rebuild (default): clean .ts generation in generated/
jts mode a              # Fast Incremental: append only new signatures to existing .ts
jts mode g              # Safe JS Compile: TSX harden + tsc compile to dist/
jts mode auto           # Full 3-Stage Pipeline: JS -> TS -> TSX -> tsc -> dist/

# Single-run overrides:
jts w app.js            # Force Mode W
jts a app.js            # Force Mode A
jts g app.js            # Force Mode G (requires generated/app.ts)
jts auto app.js         # Force Mode AUTO

3. Code Runner Queue & Recursive Folders

Batch Management

jts add app.js          # Add a single JS file to the queue
jts add src             # Add an entire directory (displayed as /src in jts ls)
jts rm app.js           # Remove a file or directory from the queue
jts ls                  # List all registered items and active mode (alias: jts dir)
jts clear               # Clear the entire runner queue
jts run                 # Transpile all queued items using active mode (alias: jts go)
jts run liste           # Build hardened dist/*.js for all queued items (alias: jts run list)
jts run src             # Directly scan and transpile all .js files in 'src/'

4. Diagnostics, History & Maintenance

System Commands

jts doctor              # Check Node.js, npm, npx, TypeScript, PATH & permissions
jts info                # Show JSM3TS Core, TSX Engine, CLI, Node & TS versions
jts stats               # Show transpilation usage statistics by mode
jts clean               # Remove generated/ and dist/ folders
jts hist                # Show timestamped command history
jts hist-clear          # Clear command history
jts errors              # Show logged error history
jts cfg                 # Show active configuration
jts cfg-reset           # Reset configuration to defaults
jts check-update        # Check if a newer release is available
jts update              # Download and install the latest version
jts h                   # Show full CLI help manual
jts v                   # Show current version
jts run -V              # Enable verbose logs from all 10 analyzer passes