devkits-lorem 1.0.0

package/README.md

@@ -0,0 +1,116 @@
+# devkits-lorem
+
+> Generate Lorem Ipsum placeholder text
+
+## Installation
+
+```bash
+npm install -g devkits-lorem
+```
+
+Or use without installation:
+
+```bash
+npx devkits-lorem [args]
+```
+
+## Usage
+
+```bash
+# Generate 1 paragraph (default)
+dk-lorem
+
+# Generate multiple paragraphs
+dk-lorem -p 3
+dk-lorem --paragraphs 5
+
+# Generate sentences
+dk-lorem -s 5
+dk-lorem --sentences 10
+
+# Generate specific word count
+dk-lorem -w 100
+dk-lorem --words 50
+```
+
+## Why @devkits/lorem?
+
+- ✅ Fast - Instant generation
+- ✅ Zero dependencies - Pure Node.js
+- ✅ Offline - Works without internet
+- ✅ Free - Open source (MIT)
+- ✅ CLI - Use in your terminal
+- ✅ Multiple modes - paragraphs, sentences, or words
+
+## Web Version
+
+Prefer a GUI? Check out the web version: **https://devkits-tools.surge.sh/tools/lorem-ipsum**
+
+- 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
+- **[Password Generator](https://devkits-tools.surge.sh/tools/password-generator)** — Secure passwords
+- **[Text Counter](https://devkits-tools.surge.sh/tools/text-counter)** — Word/char counter
+- **[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,156 @@
+#!/usr/bin/env node
+
+/**
+ * @devkits/lorem - Generate Lorem Ipsum placeholder text
+ *
+ * Usage:
+ *   dk-lorem                      # Generate 1 paragraph
+ *   dk-lorem -p 3                 # Generate 3 paragraphs
+ *   dk-lorem -s 5                 # Generate 5 sentences
+ *   dk-lorem -w 100               # Generate 100 words
+ *
+ * Web version: https://devkits-tools.surge.sh/tools/lorem-ipsum
+ * Pro features: https://devkits-tools.surge.sh/pro
+ */
+
+const WORDS = [
+  'lorem', 'ipsum', 'dolor', 'sit', 'amet', 'consectetur', 'adipiscing', 'elit',
+  'sed', 'do', 'eiusmod', 'tempor', 'incididunt', 'ut', 'labore', 'et', 'dolore',
+  'magna', 'aliqua', 'ut', 'enim', 'ad', 'minim', 'veniam', 'quis', 'nostrud',
+  'exercitation', 'ullamco', 'laboris', 'nisi', 'ut', 'aliquip', 'ex', 'ea',
+  'commodo', 'consequat', 'duis', 'aute', 'irure', 'dolor', 'in', 'reprehenderit',
+  'voluptate', 'velit', 'esse', 'cillum', 'dolore', 'eu', 'fugiat', 'nulla',
+  'pariatur', 'excepteur', 'sint', 'occaecat', 'cupidatat', 'non', 'proident',
+  'sunt', 'in', 'culpa', 'qui', 'officia', 'deserunt', 'mollit', 'anim', 'id',
+  'est', 'laborum', 'at', 'vero', 'eos', 'accusamus', 'iusto', 'odio', 'dignissimos',
+  'ducimus', 'blanditiis', 'praesentium', 'voluptatum', 'deleniti', 'atque',
+  'corrupti', 'quos', 'dolores', 'quas', 'molestias', 'excepturi', 'sint',
+  'obcaecati', 'cupiditate', 'provident', 'similique', 'neque', 'porro',
+  'quisquam', 'nihil', 'impedit', 'quo', 'minus', 'quod', 'maxime', 'placeat',
+  'facere', 'possimus', 'omnis', 'voluptas', 'assumenda', 'repellendus',
+];
+
+function randomWord() {
+  return WORDS[Math.floor(Math.random() * WORDS.length)];
+}
+
+function capitalize(str) {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+
+function generateSentence() {
+  const len = Math.floor(Math.random() * 8) + 5; // 5-12 words
+  const words = [];
+  for (let i = 0; i < len; i++) {
+    words.push(randomWord());
+  }
+  return capitalize(words.join(' ')) + '.';
+}
+
+function generateParagraph(numSentences = 5) {
+  const sentences = [];
+  for (let i = 0; i < numSentences; i++) {
+    sentences.push(generateSentence());
+  }
+  return sentences.join(' ');
+}
+
+function generateLorem(options = {}) {
+  const { type = 'paragraphs', count = 1 } = options;
+
+  switch (type) {
+    case 'sentences':
+      const sentences = [];
+      for (let i = 0; i < count; i++) {
+        sentences.push(generateSentence());
+      }
+      return sentences.join(' ');
+
+    case 'words':
+      const words = [];
+      for (let i = 0; i < count; i++) {
+        words.push(randomWord());
+      }
+      return words.join(' ');
+
+    case 'paragraphs':
+    default:
+      const paragraphs = [];
+      for (let i = 0; i < count; i++) {
+        paragraphs.push(generateParagraph());
+      }
+      return paragraphs.join('\n\n');
+  }
+}
+
+function showHelp() {
+  console.log(`
+@devkits/lorem - Generate Lorem Ipsum placeholder text
+
+Usage:
+  dk-lorem                          # 1 paragraph
+  dk-lorem -p 3                     # 3 paragraphs
+  dk-lorem -s 5                     # 5 sentences
+  dk-lorem -w 100                   # 100 words
+  dk-lorem -t sentences -c 5        # 5 sentences (alternative)
+
+Options:
+  -p, --paragraphs <n>  Generate N paragraphs (default: 1)
+  -s, --sentences <n>   Generate N sentences
+  -w, --words <n>       Generate N words
+  -t, --type <type>     Type: paragraphs, sentences, words
+  -c, --count <n>       Count for type (default: 1)
+  -h, --help            Show this help message
+
+Examples:
+  dk-lorem                          # 1 paragraph
+  dk-lorem -p 5                     # 5 paragraphs
+  dk-lorem -s 10                    # 10 sentences
+  dk-lorem -w 50                    # 50 words
+
+Web version: https://devkits-tools.surge.sh/tools/lorem-ipsum
+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 type = 'paragraphs';
+let count = 1;
+
+for (let i = 0; i < args.length; i++) {
+  switch (args[i]) {
+    case '-p':
+    case '--paragraphs':
+      type = 'paragraphs';
+      count = parseInt(args[++i], 10) || 1;
+      break;
+    case '-s':
+    case '--sentences':
+      type = 'sentences';
+      count = parseInt(args[++i], 10) || 1;
+      break;
+    case '-w':
+    case '--words':
+      type = 'words';
+      count = parseInt(args[++i], 10) || 1;
+      break;
+    case '-t':
+    case '--type':
+      type = args[++i] || 'paragraphs';
+      break;
+    case '-c':
+    case '--count':
+      count = parseInt(args[++i], 10) || 1;
+      break;
+  }
+}
+
+console.log(generateLorem({ type, count }));

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "devkits-lorem",
+  "version": "1.0.0",
+  "description": "Generate Lorem Ipsum placeholder text",
+  "main": "index.js",
+  "bin": {
+    "dk-lorem": "./index.js",
+    "lorem": "./index.js"
+  },
+  "scripts": {
+    "test": "node test.js"
+  },
+  "keywords": [
+    "lorem",
+    "ipsum",
+    "placeholder",
+    "text",
+    "generator",
+    "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/lorem-ipsum",
+  "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,79 @@
+#!/usr/bin/env node
+
+/**
+ * Tests for @devkits/lorem
+ */
+
+const { execSync } = require('child_process');
+
+const tests = [
+  {
+    name: 'Default generates 1 paragraph',
+    cmd: 'node index.js',
+    check: (result) => result.split('\n\n').length === 1
+  },
+  {
+    name: 'Generate 3 paragraphs',
+    cmd: 'node index.js -p 3',
+    check: (result) => result.split('\n\n').length === 3
+  },
+  {
+    name: 'Generate 5 sentences',
+    cmd: 'node index.js -s 5',
+    check: (result) => result.split('.').filter(s => s.trim()).length === 5
+  },
+  {
+    name: 'Generate 50 words',
+    cmd: 'node index.js -w 50',
+    check: (result) => result.split(/\s+/).length === 50
+  },
+  {
+    name: 'All words are valid lorem ipsum words',
+    cmd: 'node index.js -w 100',
+    check: (result) => {
+      const validWords = ['lorem', 'ipsum', 'dolor', 'sit', 'amet', 'consectetur', 'adipiscing', 'elit',
+        'sed', 'do', 'eiusmod', 'tempor', 'incididunt', 'ut', 'labore', 'et', 'dolore',
+        'magna', 'aliqua', 'enim', 'ad', 'minim', 'veniam', 'quis', 'nostrud',
+        'exercitation', 'ullamco', 'laboris', 'nisi', 'aliquip', 'ex', 'ea',
+        'commodo', 'consequat', 'duis', 'aute', 'irure', 'in', 'reprehenderit',
+        'voluptate', 'velit', 'esse', 'cillum', 'eu', 'fugiat', 'nulla',
+        'pariatur', 'excepteur', 'sint', 'occaecat', 'cupidatat', 'non', 'proident',
+        'sunt', 'culpa', 'qui', 'officia', 'deserunt', 'mollit', 'anim', 'id',
+        'est', 'laborum', 'at', 'vero', 'eos', 'accusamus', 'iusto', 'odio', 'dignissimos',
+        'ducimus', 'blanditiis', 'praesentium', 'voluptatum', 'deleniti', 'atque',
+        'corrupti', 'quos', 'dolores', 'quas', 'molestias', 'excepturi',
+        'obcaecati', 'cupiditate', 'provident', 'similique', 'neque', 'porro',
+        'quisquam', 'nihil', 'impedit', 'quo', 'minus', 'quod', 'maxime', 'placeat',
+        'facere', 'possimus', 'omnis', 'voluptas', 'assumenda', 'repellendus'];
+      return result.toLowerCase().split(/\s+/).every(word => {
+        const clean = word.replace(/[^a-z]/g, '');
+        return validWords.includes(clean);
+      });
+    }
+  },
+];
+
+let passed = 0;
+let failed = 0;
+
+console.log('Running @devkits/lorem 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.substring(0, 100)}...`);
+      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);