locio 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Toufiq Hasan Kiron
+
+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,90 @@
+# Locio 📊
+
+**A powerful CLI tool to count lines and files in directories with extensive filtering options.**
+
+## ✨ Features
+
+- 📁 **Count files and lines** recursively in directories
+- 🔍 **Extensive filtering** - patterns, extensions, directories, file names
+- 📏 **Size filtering** - exclude files by minimum/maximum size
+- 🎯 **Binary detection** - automatically exclude binary files
+- 📊 **Multiple formats** - human-readable, JSON, CSV, TSV
+- ⚡ **Fast and efficient** - built with Rust
+- 🛠️ **Rich statistics** - detailed breakdown by file extension
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+npm install -g locio
+```
+
+### Your First Count
+
+```bash
+# Count files and lines in current directory
+locio
+
+# Count in specific directory
+locio /path/to/directory
+
+# Count only Rust files
+locio --include-ext .rs --stats
+```
+
+## 📚 Documentation
+
+**📖 [Full Documentation Available Here](https://github.com/kiron0/locio#readme)**
+
+The documentation includes:
+
+- Complete CLI reference
+- All filtering options and patterns
+- Advanced examples and use cases
+- Output format specifications
+- Best practices and tips
+
+## 🛠️ Basic CLI Usage
+
+```bash
+# Count files and lines
+locio
+
+# Count only files
+locio --files-only
+
+# Count only lines
+locio --lines-only
+
+# Exclude patterns
+locio --exclude ".*\.log$" --exclude-dir node_modules
+
+# Include only specific extensions
+locio --include-ext .rs,.ts,.js --stats
+
+# Output in JSON format
+locio --output json
+```
+
+## 💻 Quick Example
+
+```bash
+# Count Rust source files with statistics
+locio --include-ext .rs --stats
+
+# Count TypeScript files excluding node_modules
+locio --include-ext .ts,.tsx --exclude-dir node_modules
+
+# Count with size limits and binary exclusion
+locio --max-size 5MB --no-binary --stats
+
+# Count with JSON output
+locio --stats --output json > stats.json
+```
+
+---
+
+**📖 [Visit the full documentation](https://github.com/kiron0/locio#readme) for complete CLI reference, examples, and tutorials.**
+
+_"Locio: Count your code, not your worries."_ 📊

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "locio",
+  "version": "0.1.0",
+  "description": "A powerful CLI tool to count lines and files in directories with extensive filtering options",
+  "bin": {
+    "locio": "target/release/locio"
+  },
+  "scripts": {
+    "start": "./target/release/locio",
+    "build": "source $HOME/.cargo/env && cargo build --release",
+    "prepublishOnly": "npm run build",
+    "version:check": "./scripts/version.sh",
+    "version:update": "./scripts/npm-version.sh",
+    "format": "npx prettier --write \"**/*.{js,json,ts,md}\""
+  },
+  "keywords": [
+    "cli",
+    "locio",
+    "file-counter",
+    "statistics",
+    "code-analysis",
+    "lines-of-code",
+    "code-stats"
+  ],
+  "author": "Toufiq Hasan Kiron <hello@kiron.dev>",
+  "license": "MIT",
+  "files": [
+    "target/release/locio"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kiron0/locio.git"
+  },
+  "homepage": "https://github.com/kiron0/locio#readme"
+}