devkits-text-counter 1.0.0

package/README.md

@@ -0,0 +1,138 @@
+# devkits-text-counter
+
+> Count words, characters, lines, paragraphs, and reading time
+
+## Installation
+
+```bash
+npm install -g devkits-text-counter
+```
+
+Or use without installation:
+
+```bash
+npx devkits-text-counter [args]
+```
+
+## Usage
+
+```bash
+# Count text argument
+dk-count "Hello World"
+
+# Count file content
+dk-count < file.txt
+dk-count < README.md
+
+# Count from stdin
+echo "Hello World" | dk-count
+cat article.md | dk-count
+
+# Specific counts
+dk-count -w < file.txt      # Words only
+dk-count -c < file.txt      # Characters only
+dk-count -l < file.txt      # Lines only
+dk-count --json < file.txt  # JSON output
+```
+
+## Output
+
+```
+Characters: 1234 (1100 without spaces)
+Words: 200
+Lines: 15
+Paragraphs: 5
+Reading time: 1 min
+Speaking time: 1 min 32 sec
+```
+
+## Why @devkits/text-counter?
+
+- ✅ Fast - Instant counting
+- ✅ Zero dependencies - Pure Node.js
+- ✅ Offline - Works without internet
+- ✅ Free - Open source (MIT)
+- ✅ CLI - Use in your terminal
+- ✅ Multiple metrics - words, chars, lines, paragraphs, reading time
+
+## Metrics
+
+- **Characters** - Total characters (with and without spaces)
+- **Words** - Word count
+- **Lines** - Line count
+- **Paragraphs** - Paragraph count
+- **Reading time** - Estimated at 200 words per minute
+- **Speaking time** - Estimated at 130 words per minute
+
+## Web Version
+
+Prefer a GUI? Check out the web version: **https://devkits-tools.surge.sh/tools/text-counter**
+
+- 84 developer tools in one PWA
+- Works offline
+- No signup required
+
+## Pro Features
+
+Upgrade to Pro for advanced features:
+
+- 📦 Batch Processing
+- 🔗 API Access (1000 req/day free)
+- ☁️ Cloud Sync
+- 🎨 Custom Themes
+- 📊 Advanced Analytics
+- 💬 Priority Support
+
+**Price:** $9 one-time payment
+**Upgrade:** https://devkits-tools.surge.sh/pro
+**Discount:** Use code `EARLYBIRD-2026` for 20% off
+
+## See Also
+
+Part of the **[DevKits Tools](https://devkits-tools.surge.sh)** collection — 80+ free developer tools:
+
+### Popular Tools
+
+| Tool | npm Package | Description |
+|------|-------------|-------------|
+| **[Base64](https://devkits-tools.surge.sh/tools/base64)** | `@devkits/base64` | Encode/decode Base64 |
+| **[JSON Formatter](https://devkits-tools.surge.sh/tools/json-formatter)** | `@devkits/json-formatter` | Format and validate JSON |
+| **[Color Converter](https://devkits-tools.surge.sh/tools/color-converter)** | `@devkits/color-converter` | HEX/RGB/HSL conversion |
+| **[UUID Generator](https://devkits-tools.surge.sh/tools/uuid-generator)** | `@devkits/uuid-generator` | Generate unique UUIDs |
+| **[Hash Generator](https://devkits-tools.surge.sh/tools/hash-generator)** | `@devkits/hash-generator` | MD5, SHA1, SHA256, SHA512 |
+| **[Regex Tester](https://devkits-tools.surge.sh/tools/regex-tester)** | `@devkits/regex-tester` | Test regex patterns |
+
+### Other DevKits Tools
+
+- **[HTML Tools](https://devkits-tools.surge.sh/tools/html-entities)** — HTML entity encode/decode
+- **[CSS Tools](https://devkits-tools.surge.sh/tools/css-minifier)** — CSS minify/format
+- **[Cron Parser](https://devkits-tools.surge.sh/tools/cron-parser)** — Parse cron expressions
+- **[Case Convert](https://devkits-tools.surge.sh/tools/text-case)** — camelCase, snake_case, etc.
+- **[Slugify](https://devkits-tools.surge.sh/tools/slug-generator)** — Create URL-friendly slugs
+- **[Lorem Ipsum](https://devkits-tools.surge.sh/tools/lorem-ipsum)** — Generate placeholder text
+- **[Password Generator](https://devkits-tools.surge.sh/tools/password-generator)** — Secure passwords
+- **[Timestamp](https://devkits-tools.surge.sh/tools/timestamp)** — Unix timestamp converter
+
+---
+
+### More from DevKits
+
+- **[Invoicely](https://invoicely-app.surge.sh)** — Free invoice generator for freelancers
+- **[SnapOG](https://snapog.surge.sh)** — Free OG image generator with 20+ templates
+- **[API Monitor](https://api-monitor-saas.surge.sh)** — Real-time API monitoring
+
+---
+
+👉 **Explore all 80+ developer tools at [DevKits Tools](https://devkits-tools.surge.sh)**
+
+## License
+
+MIT © [DevKits Team](https://devkits-tools.surge.sh)
+
+---
+
+## 🚀 API Monitoring for Developers
+
+Build better APIs with **API Monitor SaaS** — real-time monitoring, alerting, and analytics.
+
+👉 **Early Access: $1 pre-order (50% off for life)** → https://api-monitor-saas.surge.sh?utm_source=npm&utm_medium=readme&utm_campaign=phase0

package/index.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+
+/**
+ * @devkits/text-counter - Count words, characters, lines, and reading time
+ *
+ * Usage:
+ *   dk-count "Hello World"           # Count text
+ *   dk-count < file.txt              # Count file
+ *   echo "text" | dk-count           # Count from stdin
+ *
+ * Web version: https://devkits-tools.surge.sh/tools/text-counter
+ * Pro features: https://devkits-tools.surge.sh/pro
+ */
+
+function countText(text) {
+  const chars = text.length;
+  const charsNoSpaces = text.replace(/\s/g, '').length;
+  const words = text.trim() ? text.trim().split(/\s+/).length : 0;
+  const lines = text.split('\n').length;
+  const paragraphs = text.split(/\n\s*\n/).filter(p => p.trim()).length;
+
+  // Reading time: average 200 words per minute
+  const readingTimeMinutes = words / 200;
+  const readingTimeSeconds = Math.round(readingTimeMinutes * 60);
+
+  // Speaking time: average 130 words per minute
+  const speakingTimeMinutes = words / 130;
+  const speakingTimeSeconds = Math.round(speakingTimeMinutes * 60);
+
+  return {
+    characters: chars,
+    charactersNoSpaces: charsNoSpaces,
+    words: words,
+    lines: lines,
+    paragraphs: paragraphs || (words > 0 ? 1 : 0),
+    readingTime: formatTime(readingTimeSeconds),
+    speakingTime: formatTime(speakingTimeSeconds),
+  };
+}
+
+function formatTime(seconds) {
+  if (seconds < 60) {
+    return `${seconds} sec`;
+  }
+  const mins = Math.floor(seconds / 60);
+  const secs = seconds % 60;
+  return secs > 0 ? `${mins} min ${secs} sec` : `${mins} min`;
+}
+
+function showHelp() {
+  console.log(`
+@devkits/text-counter - Count words, characters, lines, and reading time
+
+Usage:
+  dk-count "Hello World"              # Count text argument
+  dk-count < file.txt                 # Count file
+  echo "text" | dk-count              # Count from stdin
+
+Options:
+  -w, --words           Show only word count
+  -c, --chars           Show only character count
+  -l, --lines           Show only line count
+  -j, --json            Output as JSON
+  -h, --help            Show this help message
+
+Output includes:
+  - Characters (with and without spaces)
+  - Words
+  - Lines
+  - Paragraphs
+  - Reading time (at 200 wpm)
+  - Speaking time (at 130 wpm)
+
+Examples:
+  dk-count "Hello World"
+  dk-count < README.md
+  dk-count -w < file.txt
+  dk-count --json < article.md
+
+Web version: https://devkits-tools.surge.sh/tools/text-counter
+Pro features: https://devkits-tools.surge.sh/pro
+`);
+}
+
+// Main entry point
+const args = process.argv.slice(2);
+
+if (!args.length || args.includes('-h') || args.includes('--help')) {
+  showHelp();
+  process.exit(0);
+}
+
+// Parse options
+let wordsOnly = false;
+let charsOnly = false;
+let linesOnly = false;
+let jsonOutput = false;
+let text = '';
+const remainingArgs = [];
+
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === '-w' || args[i] === '--words') {
+    wordsOnly = true;
+  } else if (args[i] === '-c' || args[i] === '--chars') {
+    charsOnly = true;
+  } else if (args[i] === '-l' || args[i] === '--lines') {
+    linesOnly = true;
+  } else if (args[i] === '-j' || args[i] === '--json') {
+    jsonOutput = true;
+  } else {
+    remainingArgs.push(args[i]);
+  }
+}
+
+// Read from stdin if no text provided
+const processText = (text) => {
+  const result = countText(text);
+
+  if (wordsOnly) {
+    console.log(result.words);
+  } else if (charsOnly) {
+    console.log(result.characters);
+  } else if (linesOnly) {
+    console.log(result.lines);
+  } else if (jsonOutput) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.log(`Characters: ${result.characters} (${result.charactersNoSpaces} without spaces)`);
+    console.log(`Words: ${result.words}`);
+    console.log(`Lines: ${result.lines}`);
+    console.log(`Paragraphs: ${result.paragraphs}`);
+    console.log(`Reading time: ${result.readingTime}`);
+    console.log(`Speaking time: ${result.speakingTime}`);
+  }
+};
+
+if (remainingArgs.length === 0 && !process.stdin.isTTY) {
+  let stdin = '';
+  process.stdin.setEncoding('utf8');
+  process.stdin.on('readable', () => {
+    let chunk;
+    while ((chunk = process.stdin.read()) !== null) {
+      stdin += chunk;
+    }
+  });
+  process.stdin.on('end', () => {
+    if (stdin) {
+      processText(stdin);
+    } else {
+      showHelp();
+    }
+  });
+} else if (remainingArgs.length > 0) {
+  text = remainingArgs.join(' ');
+  processText(text);
+} else {
+  showHelp();
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "devkits-text-counter",
+  "version": "1.0.0",
+  "description": "Count words, characters, lines, and reading time in text",
+  "main": "index.js",
+  "bin": {
+    "dk-count": "./index.js",
+    "text-count": "./index.js"
+  },
+  "scripts": {
+    "test": "node test.js"
+  },
+  "keywords": [
+    "text",
+    "count",
+    "words",
+    "characters",
+    "lines",
+    "devkits",
+    "developer-tools",
+    "cli",
+    "command-line",
+    "nodejs",
+    "utility",
+    "productivity",
+    "dev-tools",
+    "free-tools"
+  ],
+  "author": "DevKits Team <devkits-auto@protonmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/devkits/tools"
+  },
+  "homepage": "https://devkits-tools.surge.sh/tools/text-counter",
+  "bugs": {
+    "url": "https://github.com/devkits/tools/issues"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "files": [
+    "index.js",
+    "README.md",
+    "test.js"
+  ],
+  "dependencies": {}
+}

package/test.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+
+/**
+ * Tests for @devkits/text-counter
+ */
+
+const { execSync } = require('child_process');
+
+const tests = [
+  {
+    name: 'Count words in text',
+    cmd: 'echo "Hello World Test" | node index.js -w',
+    check: (result) => parseInt(result.trim()) === 3
+  },
+  {
+    name: 'Count characters in text',
+    cmd: 'echo "Hello" | node index.js -c',
+    check: (result) => parseInt(result.trim()) === 6  // includes newline from echo
+  },
+  {
+    name: 'Count lines in text',
+    cmd: 'echo -e "line1\\nline2\\nline3" | node index.js -l',
+    check: (result) => parseInt(result.trim()) === 3
+  },
+  {
+    name: 'JSON output has all fields',
+    cmd: 'echo "Hello World" | node index.js --json',
+    check: (result) => {
+      const data = JSON.parse(result);
+      return data.words !== undefined &&
+             data.characters !== undefined &&
+             data.lines !== undefined;
+    }
+  },
+  {
+    name: 'Reading time calculated',
+    cmd: 'node index.js "word ".repeat(200)',
+    check: (result) => result.includes('Reading time:')
+  },
+];
+
+let passed = 0;
+let failed = 0;
+
+console.log('Running @devkits/text-counter tests...\n');
+
+for (const test of tests) {
+  try {
+    const result = execSync(test.cmd, { encoding: 'utf8' }).trim();
+    if (test.check(result)) {
+      console.log(`✅ ${test.name}`);
+      passed++;
+    } else {
+      console.log(`❌ ${test.name}`);
+      console.log(`   Got: ${result}`);
+      failed++;
+    }
+  } catch (err) {
+    console.log(`❌ ${test.name} - Error: ${err.message}`);
+    failed++;
+  }
+}
+
+console.log(`\n${passed}/${tests.length} tests passed`);
+process.exit(failed > 0 ? 1 : 0);