@lowdep/codestat 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rushabh Shah
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,131 @@
+# codestat
+
+![Zero dependencies](https://img.shields.io/badge/dependencies-0-brightgreen) ![Node](https://img.shields.io/badge/node-%3E%3D14-blue) ![License: MIT](https://img.shields.io/badge/license-MIT-green) ![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey)
+
+
+Lines of code by language — zero-dependency Node.js alternative to `cloc`, `tokei`, and `scc`.
+
+Counts code lines, comment lines, and blank lines per language. Works on Windows, Mac, and Linux with a single `npx codestat`.
+
+---
+
+## Why?
+
+- `cloc` requires Perl
+- `tokei` requires Rust/cargo
+- `scc` requires Go
+
+`codestat` is a single Node.js file. If you have Node.js, you have `codestat`.
+
+---
+
+## Install
+
+```bash
+npm install -g codestat
+```
+
+Or without installing:
+
+```bash
+npx codestat
+```
+
+---
+
+## Usage
+
+```bash
+codestat                   # Current directory
+codestat ./src             # Specific directory
+codestat --json            # JSON output
+codestat --sort files      # Sort by file count instead of code lines
+codestat --sort name       # Sort alphabetically
+```
+
+---
+
+## Example Output
+
+```
+codestat  my-app
+
+  Language          Files      Code    Comment    Blank      Total
+  ──────────────────────────────────────────────────────────────────────────
+  TypeScript           84     8,234        412      892      9,538  ████████████████
+  CSS                  12     2,105         67      341      2,513  █████░░░░░░░░░░░
+  JavaScript            8     1,204        189      223      1,616  ███░░░░░░░░░░░░░
+  HTML                  6       456          0       89        545  █░░░░░░░░░░░░░░░
+  YAML                  4       112         34       28        174  ░░░░░░░░░░░░░░░░
+  Markdown              3         0          0      210        210  ░░░░░░░░░░░░░░░░
+  JSON                  2       198          0        0        198  ░░░░░░░░░░░░░░░░
+  ──────────────────────────────────────────────────────────────────────────
+  TOTAL               119    12,309        702    1,783     14,794
+
+  7 language(s) · skipped: node_modules, dist, build, .git
+```
+
+---
+
+## Supported Languages (36+)
+
+TypeScript, JavaScript, Python, Rust, Go, Java, C/C++, C#, PHP, Ruby, Swift, Kotlin, Shell, CSS, SCSS/Sass, Less, HTML, Vue, Svelte, JSON, YAML, TOML, Markdown, SQL, GraphQL, Dockerfile, Makefile, Terraform, Lua, Dart, R, Elixir, Erlang, Haskell, Scala, Text
+
+---
+
+## Skipped Automatically
+
+`node_modules`, `.git`, `dist`, `build`, `out`, `.next`, `coverage`, `__pycache__`, `vendor`, `venv`, `target`
+
+---
+
+## JSON Output
+
+```bash
+codestat --json
+```
+
+```json
+{
+  "directory": "/path/to/project",
+  "summary": {
+    "files": 119,
+    "code": 12309,
+    "comments": 702,
+    "blank": 1783,
+    "total": 14794
+  },
+  "languages": [
+    {
+      "name": "TypeScript",
+      "files": 84,
+      "code": 8234,
+      "comments": 412,
+      "blank": 892,
+      "total": 9538
+    }
+  ]
+}
+```
+
+---
+
+## License
+
+MIT
+
+---
+
+## Keywords
+
+`lines of code` · `loc counter` · `cloc alternative` · `tokei alternative` · `scc alternative` · `code statistics` · `count lines` · `sloc` · `zero dependencies` · `cross-platform`
+
+---
+
+<div align="center">
+
+**Built to solve, shared to help — Rushabh Shah 🛠️✨**
+
+<sub>One of 40+ zero-dependency developer CLI tools — no <code>node_modules</code>, ever.</sub>
+
+</div>

package/bin/codestat.js

@@ -0,0 +1,256 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs   = require('fs');
+const path = require('path');
+
+const VERSION = '1.0.0';
+
+// ─── Language definitions ─────────────────────────────────────────────────────
+// Each entry: extensions[], name, lineComment, blockCommentStart, blockCommentEnd
+const LANGUAGES = [
+  { name: 'TypeScript',   exts: ['.ts', '.tsx'],                     lc: '//',  bs: '/*',  be: '*/' },
+  { name: 'JavaScript',   exts: ['.js', '.jsx', '.mjs', '.cjs'],     lc: '//',  bs: '/*',  be: '*/' },
+  { name: 'Python',       exts: ['.py', '.pyw'],                     lc: '#',   bs: '"""', be: '"""' },
+  { name: 'Rust',         exts: ['.rs'],                             lc: '//',  bs: '/*',  be: '*/' },
+  { name: 'Go',           exts: ['.go'],                             lc: '//',  bs: '/*',  be: '*/' },
+  { name: 'Java',         exts: ['.java'],                           lc: '//',  bs: '/*',  be: '*/' },
+  { name: 'C/C++',        exts: ['.c', '.cpp', '.cc', '.cxx', '.h', '.hpp'], lc: '//', bs: '/*', be: '*/' },
+  { name: 'C#',           exts: ['.cs'],                             lc: '//',  bs: '/*',  be: '*/' },
+  { name: 'PHP',          exts: ['.php'],                            lc: '//',  bs: '/*',  be: '*/' },
+  { name: 'Ruby',         exts: ['.rb'],                             lc: '#',   bs: '=begin', be: '=end' },
+  { name: 'Swift',        exts: ['.swift'],                          lc: '//',  bs: '/*',  be: '*/' },
+  { name: 'Kotlin',       exts: ['.kt', '.kts'],                     lc: '//',  bs: '/*',  be: '*/' },
+  { name: 'Shell',        exts: ['.sh', '.bash', '.zsh', '.fish'],   lc: '#',   bs: null,  be: null },
+  { name: 'CSS',          exts: ['.css'],                            lc: null,  bs: '/*',  be: '*/' },
+  { name: 'SCSS/Sass',    exts: ['.scss', '.sass'],                  lc: '//',  bs: '/*',  be: '*/' },
+  { name: 'Less',         exts: ['.less'],                           lc: '//',  bs: '/*',  be: '*/' },
+  { name: 'HTML',         exts: ['.html', '.htm'],                   lc: null,  bs: '<!--', be: '-->' },
+  { name: 'Vue',          exts: ['.vue'],                            lc: '//',  bs: '<!--', be: '-->' },
+  { name: 'Svelte',       exts: ['.svelte'],                         lc: '//',  bs: '<!--', be: '-->' },
+  { name: 'JSON',         exts: ['.json'],                           lc: null,  bs: null,  be: null },
+  { name: 'YAML',         exts: ['.yml', '.yaml'],                   lc: '#',   bs: null,  be: null },
+  { name: 'TOML',         exts: ['.toml'],                           lc: '#',   bs: null,  be: null },
+  { name: 'Markdown',     exts: ['.md', '.mdx'],                     lc: null,  bs: null,  be: null },
+  { name: 'SQL',          exts: ['.sql'],                            lc: '--',  bs: '/*',  be: '*/' },
+  { name: 'GraphQL',      exts: ['.graphql', '.gql'],                lc: '#',   bs: null,  be: null },
+  { name: 'Dockerfile',   exts: [],  names: ['dockerfile'],          lc: '#',   bs: null,  be: null },
+  { name: 'Makefile',     exts: [],  names: ['makefile', 'gnumakefile'], lc: '#', bs: null, be: null },
+  { name: 'Terraform',    exts: ['.tf', '.tfvars'],                  lc: '#',   bs: '/*',  be: '*/' },
+  { name: 'Lua',          exts: ['.lua'],                            lc: '--',  bs: '--[[', be: ']]' },
+  { name: 'Dart',         exts: ['.dart'],                           lc: '//',  bs: '/*',  be: '*/' },
+  { name: 'R',            exts: ['.r', '.R'],                        lc: '#',   bs: null,  be: null },
+  { name: 'Elixir',       exts: ['.ex', '.exs'],                     lc: '#',   bs: null,  be: null },
+  { name: 'Erlang',       exts: ['.erl', '.hrl'],                    lc: '%',   bs: null,  be: null },
+  { name: 'Haskell',      exts: ['.hs', '.lhs'],                     lc: '--',  bs: '{-',  be: '-}' },
+  { name: 'Scala',        exts: ['.scala'],                          lc: '//',  bs: '/*',  be: '*/' },
+  { name: 'Text',         exts: ['.txt'],                            lc: null,  bs: null,  be: null },
+];
+
+const EXT_MAP  = new Map();
+const NAME_MAP = new Map();
+for (const lang of LANGUAGES) {
+  for (const e of (lang.exts || []))   EXT_MAP.set(e, lang);
+  for (const n of (lang.names || []))  NAME_MAP.set(n, lang);
+}
+
+function detectLang(filePath) {
+  const ext  = path.extname(filePath).toLowerCase();
+  if (ext && EXT_MAP.has(ext)) return EXT_MAP.get(ext);
+  const base = path.basename(filePath).toLowerCase();
+  if (NAME_MAP.has(base)) return NAME_MAP.get(base);
+  return null;
+}
+
+// ─── Line counter ─────────────────────────────────────────────────────────────
+function countLines(filePath, lang) {
+  let content;
+  try { content = fs.readFileSync(filePath, 'utf8'); } catch { return null; }
+
+  const lines = content.split('\n');
+  let code = 0, comments = 0, blank = 0;
+  let inBlock = false;
+
+  for (const rawLine of lines) {
+    const line = rawLine.trim();
+
+    if (!line) { blank++; continue; }
+
+    // Block comment tracking
+    if (!inBlock && lang.bs && line.includes(lang.bs)) {
+      inBlock = true;
+    }
+    if (inBlock) {
+      comments++;
+      if (lang.be && line.includes(lang.be)) inBlock = false;
+      continue;
+    }
+
+    // Line comment
+    if (lang.lc && line.startsWith(lang.lc)) {
+      comments++;
+      continue;
+    }
+
+    code++;
+  }
+
+  return { code, comments, blank, total: lines.length };
+}
+
+// ─── Directory walker ─────────────────────────────────────────────────────────
+const SKIP_DIRS = new Set([
+  'node_modules', '.git', 'dist', 'build', 'out', '.next', '.nuxt',
+  '__pycache__', 'vendor', 'venv', '.venv', 'env', 'target',
+  '.turbo', 'coverage', '.cache', '.svelte-kit', 'public',
+]);
+
+function walk(dir, results = new Map()) {
+  let entries;
+  try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch { return results; }
+
+  for (const e of entries) {
+    if (SKIP_DIRS.has(e.name)) continue;
+    if (e.name.startsWith('.')) continue;
+
+    const full = path.join(dir, e.name);
+    if (e.isDirectory()) {
+      walk(full, results);
+    } else if (e.isFile()) {
+      const lang = detectLang(full);
+      if (!lang) continue;
+      const counts = countLines(full, lang);
+      if (!counts) continue;
+
+      const key = lang.name;
+      if (!results.has(key)) {
+        results.set(key, { name: key, files: 0, code: 0, comments: 0, blank: 0, total: 0 });
+      }
+      const r = results.get(key);
+      r.files++;
+      r.code     += counts.code;
+      r.comments += counts.comments;
+      r.blank    += counts.blank;
+      r.total    += counts.total;
+    }
+  }
+  return results;
+}
+
+// ─── ANSI ─────────────────────────────────────────────────────────────────────
+const isTTY  = process.stdout.isTTY;
+const c      = (code, t) => isTTY ? `\x1b[${code}m${t}\x1b[0m` : t;
+const bold   = t => c('1',  t);
+const dim    = t => c('2',  t);
+const cyan   = t => c('36', t);
+const green  = t => c('32', t);
+const yellow = t => c('33', t);
+
+function bar(pct, width = 16) {
+  const filled = Math.round(pct * width);
+  const b = '█'.repeat(filled) + '░'.repeat(width - filled);
+  if (pct > 0.3) return green(b);
+  if (pct > 0.1) return yellow(b);
+  return dim(b);
+}
+
+// ─── CLI ──────────────────────────────────────────────────────────────────────
+const args       = process.argv.slice(2);
+const flags      = new Set(args.filter(a => a.startsWith('-')));
+const positional = args.filter(a => !a.startsWith('-'));
+
+if (flags.has('--version') || flags.has('-v')) {
+  console.log(`codestat v${VERSION}`); process.exit(0);
+}
+if (flags.has('--help') || flags.has('-h')) {
+  console.log(`
+${bold('codestat')} — Lines of code by language
+
+${bold('USAGE')}
+  codestat [directory]
+
+${bold('OPTIONS')}
+  --json        Output as JSON
+  --sort code   Sort by code lines (default)
+  --sort files  Sort by file count
+  --sort name   Sort alphabetically
+  --version     Show version
+  --help        Show this help
+
+${bold('EXAMPLES')}
+  codestat                  Current directory
+  codestat ./src            Specific directory
+  codestat --json           JSON output
+  codestat --sort files     Sort by file count
+
+${bold('NOTE')}
+  Skips: node_modules, .git, dist, build, coverage, venv, target
+`);
+  process.exit(0);
+}
+
+const targetDir = path.resolve(positional[0] || '.');
+const asJson    = flags.has('--json');
+const sortKey   = (() => {
+  const i = args.indexOf('--sort');
+  return i !== -1 ? (args[i + 1] || 'code') : 'code';
+})();
+
+if (!fs.existsSync(targetDir)) {
+  console.error(`codestat: directory not found: ${targetDir}`);
+  process.exit(1);
+}
+
+if (!asJson) process.stderr.write(dim('Counting lines…\r'));
+
+const results = walk(targetDir);
+const rows    = [...results.values()];
+
+// Sort
+rows.sort((a, b) => {
+  if (sortKey === 'files') return b.files - a.files;
+  if (sortKey === 'name')  return a.name.localeCompare(b.name);
+  return b.code - a.code;
+});
+
+const totCode     = rows.reduce((s, r) => s + r.code, 0);
+const totComments = rows.reduce((s, r) => s + r.comments, 0);
+const totBlank    = rows.reduce((s, r) => s + r.blank, 0);
+const totTotal    = rows.reduce((s, r) => s + r.total, 0);
+const totFiles    = rows.reduce((s, r) => s + r.files, 0);
+
+if (asJson) {
+  console.log(JSON.stringify({
+    directory: targetDir,
+    summary: { files: totFiles, code: totCode, comments: totComments, blank: totBlank, total: totTotal },
+    languages: rows,
+  }, null, 2));
+  process.exit(0);
+}
+
+process.stderr.write('                 \r');
+
+const projectName = path.basename(targetDir);
+console.log(`\n${bold('codestat')}  ${cyan(projectName)}  ${dim(targetDir)}\n`);
+
+// Dynamic column widths
+const nameW = Math.max(...rows.map(r => r.name.length), 12);
+
+const hdr = (s, w) => bold(s.padStart(w));
+console.log(
+  `  ${'Language'.padEnd(nameW)}  ${hdr('Files', 6)}  ${hdr('Code', 9)}  ${hdr('Comment', 9)}  ${hdr('Blank', 7)}  ${hdr('Total', 9)}  ${''}`,
+);
+console.log(dim('  ' + '─'.repeat(nameW + 60)));
+
+for (const r of rows) {
+  const pct = totCode > 0 ? r.code / totCode : 0;
+  console.log(
+    `  ${r.name.padEnd(nameW)}  ${dim(String(r.files).padStart(6))}  ${String(r.code).padStart(9)}  ${dim(String(r.comments).padStart(9))}  ${dim(String(r.blank).padStart(7))}  ${dim(String(r.total).padStart(9))}  ${bar(pct)}`,
+  );
+}
+
+console.log(dim('  ' + '─'.repeat(nameW + 60)));
+console.log(
+  `  ${bold('TOTAL'.padEnd(nameW))}  ${dim(String(totFiles).padStart(6))}  ${bold(String(totCode).padStart(9))}  ${dim(String(totComments).padStart(9))}  ${dim(String(totBlank).padStart(7))}  ${dim(String(totTotal).padStart(9))}`,
+);
+console.log(dim(`\n  ${rows.length} language(s) · skipped: node_modules, dist, build, .git\n`));

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@lowdep/codestat",
+  "version": "1.0.0",
+  "description": "Lines of code by language — zero-dep Node.js alternative to cloc/tokei, works on Windows",
+  "bin": {
+    "codestat": "bin/codestat.js"
+  },
+  "keywords": [
+    "lines-of-code",
+    "loc",
+    "cloc",
+    "statistics",
+    "cli",
+    "developer-tools",
+    "code-analysis",
+    "lines of code",
+    "loc counter",
+    "cloc alternative",
+    "tokei alternative",
+    "scc alternative",
+    "code statistics",
+    "count lines",
+    "sloc",
+    "zero dependencies",
+    "cross-platform"
+  ],
+  "author": "Rushabh Shah",
+  "license": "MIT",
+  "engines": {
+    "node": ">=14"
+  },
+  "files": [
+    "bin/"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Rushabh5000/codestat.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Rushabh5000/codestat/issues"
+  },
+  "homepage": "https://github.com/Rushabh5000/codestat#readme",
+  "publishConfig": {
+    "access": "public"
+  }
+}