@chamuka-labs/drawit-cli 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,150 @@
+# @chamuka-labs/drawit-cli
+
+[![npm version](https://img.shields.io/npm/v/@chamuka-labs/drawit-cli)](https://www.npmjs.com/package/@chamuka-labs/drawit-cli)
+[![npm downloads](https://img.shields.io/npm/dm/@chamuka-labs/drawit-cli)](https://www.npmjs.com/package/@chamuka-labs/drawit-cli)
+[![Node.js 18+](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
+[![License](https://img.shields.io/badge/license-Proprietary-red)](https://drawit.chamuka.ai)
+
+A command-line tool for validating, inspecting, and exporting `.drawit` diagram files. Part of the [Chamuka DrawIt](https://drawit.chamuka.ai) ecosystem.
+
+## Installation
+
+```bash
+npm install -g @chamuka-labs/drawit-cli
+```
+
+Once installed, both `drawit` and `chamuka-drawit` are available as CLI commands.
+
+## Commands
+
+### `drawit validate <file>`
+
+Parse and validate a `.drawit` file.
+
+```bash
+drawit validate my-diagram.drawit
+drawit validate --strict my-diagram.drawit   # Full Zod schema validation
+drawit validate --format json my-diagram.drawit
+```
+
+### `drawit inspect <file>`
+
+Show a structured summary of a `.drawit` file.
+
+```bash
+drawit inspect my-diagram.drawit
+drawit inspect --elements my-diagram.drawit  # Include element ID listing
+drawit inspect --format json my-diagram.drawit
+```
+
+### `drawit export <file>`
+
+Export to a different format.
+
+```bash
+drawit export my-diagram.drawit --format svg --output my-diagram.svg
+drawit export my-diagram.drawit --format json --output my-diagram.json
+drawit export my-diagram.drawit --format ndjson --output clean.drawit
+```
+
+### `drawit create <file>`
+
+Scaffold a new `.drawit` file.
+
+```bash
+drawit create new-diagram.drawit
+drawit create new-diagram.drawit --template flowchart --name "My Flow" --width 1200 --height 800
+```
+
+### `drawit merge <file1> <file2> [...]`
+
+Combine multiple `.drawit` files into one.
+
+```bash
+drawit merge part1.drawit part2.drawit --output combined.drawit
+drawit merge *.drawit --layout vertical --gap 80 --output combined.drawit
+```
+
+### `drawit map`
+
+Generate a dependency map diagram from a codebase.
+
+```bash
+drawit map --output dependencies.drawit
+drawit map --root ./src --output map.drawit
+```
+
+### `drawit schema`
+
+Show or validate against the DrawIt JSON schema.
+
+```bash
+drawit schema
+drawit schema --validate my-diagram.drawit
+```
+
+### `drawit deps`
+
+Analyze and visualize package dependencies.
+
+```bash
+drawit deps --output deps.drawit
+```
+
+### `drawit flow`
+
+Generate a control-flow diagram from source code.
+
+```bash
+drawit flow src/index.ts --output flow.drawit
+```
+
+### `drawit routes`
+
+Generate a routes diagram from a Next.js or Express app.
+
+```bash
+drawit routes --output routes.drawit
+```
+
+## Global Options
+
+- `--format text|json` — Output format for text commands (default: `text`)
+- `--stdin` — Read diagram from stdin instead of a file
+- `--output <path>` / `-o <path>` — Write output to a file
+
+## Pipe-Friendly
+
+```bash
+cat diagram.drawit | drawit validate --stdin
+cat diagram.drawit | drawit export --stdin --format svg > output.svg
+drawit validate diagram.drawit && drawit export diagram.drawit --format svg -o out.svg
+```
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| `0`  | Success / valid |
+| `1`  | Errors found / invalid file |
+
+## Supported File Formats
+
+The CLI handles both `.drawit` file formats:
+
+- **NDJSON** — one JSON object per line (generated by the CLI and Claude Code skill)
+- **JSON** — pretty-printed multi-line JSON with `elements` array (generated by the web app)
+
+## Requirements
+
+Node.js 18 or later.
+
+## Related
+
+- **Web App** — [drawit.chamuka.ai](https://drawit.chamuka.ai) — full AI-powered diagram editor
+- **VS Code Extension** — [ChamukaLabs.vscode-drawit-viewer](https://marketplace.visualstudio.com/items?itemName=ChamukaLabs.vscode-drawit-viewer) — view `.drawit` files in VS Code
+- **npm package** — [@chamuka-labs/drawit-cli](https://www.npmjs.com/package/@chamuka-labs/drawit-cli)
+
+## License
+
+Proprietary — © 2026 Chamuka Inc. All rights reserved. Unauthorized copying, distribution, or modification is strictly prohibited. For licensing inquiries contact [hello@chamuka.ai](mailto:hello@chamuka.ai).

package/dist/index.js

@@ -1130,6 +1130,15 @@ var import_node_path = require("path");
 var IMPORT_REGEX = /^\s*import\s+(?:(?:[\w*{][^'"]*)\s+from\s+)?['"]([^'"]+)['"]/gm;
 var EXPORT_FROM_REGEX = /^\s*export\s+(?:\{[^}]*\}|\*(?:\s+as\s+\w+)?)\s+from\s+['"]([^'"]+)['"]/gm;
 var REQUIRE_REGEX = /(?:^|[^.])\brequire\s*\(\s*['"]([^'"]+)['"]\s*\)/gm;
+var PY_RELATIVE_IMPORT = /^\s*from\s+(\.+[\w.]*)\s+import/gm;
+var RB_REQUIRE_RELATIVE = /require_relative\s+['"]([^'"]+)['"]/gm;
+var TF_MODULE_SOURCE = /source\s*=\s*["'](\.{1,2}[^"'\s]+)["']/gm;
+function pythonRelativeToPath(importStr) {
+  const dots = importStr.match(/^\.+/)?.[0].length ?? 1;
+  const rest = importStr.slice(dots).replace(/\./g, "/");
+  const prefix = dots === 1 ? "./" : "../".repeat(dots - 1);
+  return rest ? prefix + rest : prefix;
+}
 function sanitizeId(relativePath) {
   return "f_" + relativePath.replace(/[^a-zA-Z0-9]/g, "_");
 }
@@ -1163,20 +1172,36 @@ function isExcluded(name, relPath, patterns) {
   }
   return false;
 }
-function extractImportPaths(content) {
+var JS_TS_EXTS = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".mts", ".cts"]);
+function extractImportPaths(content, ext) {
   const paths = [];
   let match;
-  IMPORT_REGEX.lastIndex = 0;
-  while ((match = IMPORT_REGEX.exec(content)) !== null) {
-    paths.push(match[1]);
+  if (JS_TS_EXTS.has(ext)) {
+    IMPORT_REGEX.lastIndex = 0;
+    while ((match = IMPORT_REGEX.exec(content)) !== null) paths.push(match[1]);
+    EXPORT_FROM_REGEX.lastIndex = 0;
+    while ((match = EXPORT_FROM_REGEX.exec(content)) !== null) paths.push(match[1]);
+    REQUIRE_REGEX.lastIndex = 0;
+    while ((match = REQUIRE_REGEX.exec(content)) !== null) paths.push(match[1]);
+  }
+  if (ext === ".py") {
+    PY_RELATIVE_IMPORT.lastIndex = 0;
+    while ((match = PY_RELATIVE_IMPORT.exec(content)) !== null) {
+      paths.push(pythonRelativeToPath(match[1]));
+    }
   }
-  EXPORT_FROM_REGEX.lastIndex = 0;
-  while ((match = EXPORT_FROM_REGEX.exec(content)) !== null) {
-    paths.push(match[1]);
+  if (ext === ".rb") {
+    RB_REQUIRE_RELATIVE.lastIndex = 0;
+    while ((match = RB_REQUIRE_RELATIVE.exec(content)) !== null) {
+      const p = match[1];
+      paths.push(p.startsWith(".") ? p : `./${p}`);
+    }
   }
-  REQUIRE_REGEX.lastIndex = 0;
-  while ((match = REQUIRE_REGEX.exec(content)) !== null) {
-    paths.push(match[1]);
+  if (ext === ".tf") {
+    TF_MODULE_SOURCE.lastIndex = 0;
+    while ((match = TF_MODULE_SOURCE.exec(content)) !== null) {
+      paths.push(match[1]);
+    }
   }
   return [...new Set(paths)];
 }
@@ -1185,7 +1210,11 @@ function resolveLocalImport(fromFile, importPath, pathToId, extensions) {
   const candidates = [
     base,
     ...extensions.map((ext) => base + ext),
-    ...extensions.map((ext) => (0, import_node_path.join)(base, "index" + ext))
+    ...extensions.map((ext) => (0, import_node_path.join)(base, "index" + ext)),
+    // Python: package directory with __init__.py
+    (0, import_node_path.join)(base, "__init__.py"),
+    // Terraform: module directory conventionally has main.tf
+    (0, import_node_path.join)(base, "main.tf")
   ];
   for (const candidate of candidates) {
     const id = pathToId.get(candidate);
@@ -1220,7 +1249,7 @@ function analyzeCodebase(rootDir, options) {
   for (const entry of entries) {
     try {
       const content = (0, import_node_fs2.readFileSync)(entry.absolutePath, "utf-8");
-      const rawImports = extractImportPaths(content);
+      const rawImports = extractImportPaths(content, entry.ext);
       for (const importPath of rawImports) {
         if (!importPath.startsWith("./") && !importPath.startsWith("../")) continue;
         const resolvedId = resolveLocalImport(
@@ -1494,7 +1523,51 @@ function layoutTree(root) {
 }
 
 // src/commands/map.ts
-var DEFAULT_EXCLUDE = "node_modules,dist,build,.next,.git,out,coverage,.turbo";
+var DEFAULT_EXCLUDE = [
+  // JS/TS
+  "node_modules",
+  "dist",
+  "build",
+  ".next",
+  "out",
+  "coverage",
+  ".turbo",
+  // Python
+  "__pycache__",
+  ".venv",
+  "venv",
+  "env",
+  ".pytest_cache",
+  "htmlcov",
+  ".mypy_cache",
+  // Go
+  "vendor",
+  // Rust / Java / Maven / Gradle
+  "target",
+  ".gradle",
+  ".m2",
+  // .NET
+  "bin",
+  "obj",
+  // iOS / Swift
+  "Pods",
+  "DerivedData",
+  // Elixir / Phoenix
+  "_build",
+  "deps",
+  // Ruby
+  ".bundle",
+  // Terraform
+  ".terraform",
+  // Elm
+  "elm-stuff",
+  // Generic
+  "tmp",
+  "log",
+  "logs",
+  "temp",
+  ".git"
+].join(",");
 var AUTO_THRESHOLD = 80;
 function makeAnalyzeOptions(opts) {
   return {
@@ -1515,20 +1588,135 @@ function tryOpenInVSCode(path) {
   }
 }
 function getFileNodeStyle(ext, fileName) {
-  if (fileName.includes(".test.") || fileName.includes(".spec.")) {
+  if (fileName.includes(".test.") || fileName.includes(".spec.") || fileName.endsWith("_test.go") || fileName.endsWith("_test.py") || fileName.startsWith("test_") && ext === ".py") {
     return { fillStyle: "#78350f", strokeStyle: "#d97706" };
   }
-  if ([".json", ".yaml", ".yml", ".toml", ".env"].includes(ext)) {
-    return { fillStyle: "#1e1b4b", strokeStyle: "#7c3aed" };
-  }
   switch (ext) {
+    // ── TypeScript / JavaScript ──────────────────────────────────────────
     case ".tsx":
     case ".jsx":
       return { fillStyle: "#0c4a6e", strokeStyle: "#0ea5e9" };
+    // sky
     case ".ts":
+    case ".mts":
+    case ".cts":
       return { fillStyle: "#1e3a5f", strokeStyle: "#3b82f6" };
+    // blue
     case ".js":
+    case ".mjs":
+    case ".cjs":
       return { fillStyle: "#422006", strokeStyle: "#f59e0b" };
+    // amber
+    // ── Frontend frameworks ──────────────────────────────────────────────
+    case ".vue":
+      return { fillStyle: "#052e16", strokeStyle: "#22c55e" };
+    // green
+    case ".svelte":
+      return { fillStyle: "#431407", strokeStyle: "#f97316" };
+    // orange
+    case ".html":
+    case ".htm":
+      return { fillStyle: "#422006", strokeStyle: "#fb923c" };
+    // orange-light
+    case ".css":
+    case ".scss":
+    case ".sass":
+    case ".less":
+      return { fillStyle: "#500724", strokeStyle: "#ec4899" };
+    // pink
+    // ── Python ───────────────────────────────────────────────────────────
+    case ".py":
+    case ".pyw":
+      return { fillStyle: "#064e3b", strokeStyle: "#10b981" };
+    // emerald
+    // ── Go ───────────────────────────────────────────────────────────────
+    case ".go":
+      return { fillStyle: "#0d3d47", strokeStyle: "#06b6d4" };
+    // cyan
+    // ── Rust ─────────────────────────────────────────────────────────────
+    case ".rs":
+      return { fillStyle: "#431407", strokeStyle: "#ea580c" };
+    // rust-orange
+    // ── Ruby ─────────────────────────────────────────────────────────────
+    case ".rb":
+    case ".rake":
+    case ".gemspec":
+      return { fillStyle: "#450a0a", strokeStyle: "#dc2626" };
+    // red
+    // ── Java / JVM ───────────────────────────────────────────────────────
+    case ".java":
+      return { fillStyle: "#431407", strokeStyle: "#f97316" };
+    // java-orange
+    case ".kt":
+    case ".kts":
+      return { fillStyle: "#2d1b69", strokeStyle: "#8b5cf6" };
+    // kotlin-purple
+    case ".scala":
+      return { fillStyle: "#450a0a", strokeStyle: "#ef4444" };
+    // scala-red
+    case ".groovy":
+      return { fillStyle: "#052e16", strokeStyle: "#4ade80" };
+    // groovy-green
+    // ── .NET ─────────────────────────────────────────────────────────────
+    case ".cs":
+      return { fillStyle: "#312e81", strokeStyle: "#818cf8" };
+    // indigo
+    case ".fs":
+    case ".fsx":
+      return { fillStyle: "#1e3a5f", strokeStyle: "#60a5fa" };
+    // fsharp-blue
+    // ── Swift / Dart ─────────────────────────────────────────────────────
+    case ".swift":
+      return { fillStyle: "#431407", strokeStyle: "#fb923c" };
+    // swift-orange
+    case ".dart":
+      return { fillStyle: "#0c4a6e", strokeStyle: "#38bdf8" };
+    // dart-sky
+    // ── PHP ──────────────────────────────────────────────────────────────
+    case ".php":
+      return { fillStyle: "#2e1065", strokeStyle: "#7c3aed" };
+    // php-violet
+    // ── Infrastructure / IaC ─────────────────────────────────────────────
+    case ".tf":
+    case ".tfvars":
+    case ".hcl":
+      return { fillStyle: "#1e1035", strokeStyle: "#9333ea" };
+    // terraform-purple
+    // ── Shell scripts ────────────────────────────────────────────────────
+    case ".sh":
+    case ".bash":
+    case ".zsh":
+    case ".fish":
+    case ".ps1":
+    case ".psm1":
+      return { fillStyle: "#1a2e05", strokeStyle: "#84cc16" };
+    // lime
+    // ── Data / API ───────────────────────────────────────────────────────
+    case ".sql":
+      return { fillStyle: "#042f2e", strokeStyle: "#0d9488" };
+    // teal
+    case ".graphql":
+    case ".gql":
+      return { fillStyle: "#500724", strokeStyle: "#e879f9" };
+    // fuchsia
+    case ".proto":
+      return { fillStyle: "#0f2744", strokeStyle: "#60a5fa" };
+    // proto-blue
+    // ── Config / data (keep existing purple group) ───────────────────────
+    case ".json":
+    case ".yaml":
+    case ".yml":
+    case ".toml":
+    case ".env":
+    case ".ini":
+    case ".conf":
+      return { fillStyle: "#1e1b4b", strokeStyle: "#7c3aed" };
+    // violet
+    // ── Markup / docs ────────────────────────────────────────────────────
+    case ".md":
+    case ".mdx":
+      return { fillStyle: "#1e293b", strokeStyle: "#94a3b8" };
+    // slate
     default:
       return { fillStyle: "#1e293b", strokeStyle: "#64748b" };
   }
@@ -1640,9 +1828,47 @@ function getDirNodeStyle(dominantExt) {
     case ".jsx":
       return { fillStyle: "#0c3d5e", strokeStyle: "#0ea5e9" };
     case ".ts":
+    case ".mts":
       return { fillStyle: "#1a2f52", strokeStyle: "#3b82f6" };
     case ".js":
+    case ".mjs":
       return { fillStyle: "#3d1f00", strokeStyle: "#f59e0b" };
+    case ".vue":
+      return { fillStyle: "#052e16", strokeStyle: "#22c55e" };
+    case ".svelte":
+      return { fillStyle: "#3d1f00", strokeStyle: "#f97316" };
+    case ".py":
+      return { fillStyle: "#052e1e", strokeStyle: "#10b981" };
+    case ".go":
+      return { fillStyle: "#0d3340", strokeStyle: "#06b6d4" };
+    case ".rs":
+      return { fillStyle: "#3d1f00", strokeStyle: "#ea580c" };
+    case ".rb":
+      return { fillStyle: "#3d0000", strokeStyle: "#dc2626" };
+    case ".java":
+      return { fillStyle: "#3d1f00", strokeStyle: "#f97316" };
+    case ".kt":
+    case ".kts":
+      return { fillStyle: "#1e0d4a", strokeStyle: "#8b5cf6" };
+    case ".cs":
+      return { fillStyle: "#1e1b4b", strokeStyle: "#818cf8" };
+    case ".swift":
+      return { fillStyle: "#3d1f00", strokeStyle: "#fb923c" };
+    case ".php":
+      return { fillStyle: "#1e0063", strokeStyle: "#7c3aed" };
+    case ".tf":
+    case ".tfvars":
+    case ".hcl":
+      return { fillStyle: "#1e1035", strokeStyle: "#9333ea" };
+    case ".sh":
+    case ".bash":
+    case ".zsh":
+      return { fillStyle: "#1a2e05", strokeStyle: "#84cc16" };
+    case ".sql":
+      return { fillStyle: "#042f2e", strokeStyle: "#0d9488" };
+    case ".graphql":
+    case ".gql":
+      return { fillStyle: "#3d0024", strokeStyle: "#e879f9" };
     default:
       return { fillStyle: "#1a2040", strokeStyle: "#6366f1" };
   }
@@ -1786,7 +2012,11 @@ function runSplitMode(targetDir, analyzeOptions, outputDir, drawEdges) {
 function registerMapCommand(program2) {
   program2.command("map [path]").description(
     "Analyze a codebase and generate a .drawit map (auto-scales: dirs mode for large repos)"
-  ).option("--output <file>", "Output file path (default: <dirname>-map.drawit)").option("--depth <n>", "Max directory depth to scan", "4").option("--include <pattern>", "File extensions to include", "**/*.{ts,tsx,js,jsx}").option("--exclude <patterns>", "Comma-separated names to exclude", DEFAULT_EXCLUDE).option("--no-edges", "Skip import dependency edges (files mode only)").option("--open", "Open generated file(s) in VS Code").option(
+  ).option("--output <file>", "Output file path (default: <dirname>-map.drawit)").option("--depth <n>", "Max directory depth to scan", "4").option(
+    "--include <pattern>",
+    "File extensions to include",
+    "**/*.{ts,tsx,js,jsx,mjs,cjs,vue,svelte,py,go,rb,rs,java,kt,kts,cs,swift,dart,php,tf,tfvars,hcl,sh,bash,zsh,sql,graphql,gql,proto,html,css,scss,sass,less,md,mdx}"
+  ).option("--exclude <patterns>", "Comma-separated names to exclude", DEFAULT_EXCLUDE).option("--no-edges", "Skip import dependency edges (files mode only)").option("--open", "Open generated file(s) in VS Code").option(
     "--mode <auto|files|dirs>",
     "Map mode: auto detects by file count, files=import graph, dirs=directory tree",
     "auto"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chamuka-labs/drawit-cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "CLI tool for validating, inspecting, and exporting DrawIt diagram files",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -26,7 +26,7 @@
     "export"
   ],
   "author": "Chamuka",
-  "license": "Commercial",
+  "license": "Proprietary",
   "publishConfig": {
     "access": "public"
   },