word-def 1.0.0

package/README.md

@@ -0,0 +1,39 @@
+# word-def
+
+CLI tool to find definitions of any English word using the Free Dictionary API.
+
+## Install
+
+```bash
+npm install -g word-def
+```
+
+## Usage
+
+```bash
+word-def <word>
+```
+
+Example:
+```bash
+$ word-def hello
+
+📖 hello
+
+[noun]
+  1. a greeting used when meeting someone
+     → "hello, how are you?"
+  2. an expression of surprise
+
+[verb]
+  1. to say "hello" to someone
+     → "he helloed the crowd"
+```
+
+## Features
+
+- Fetches definitions from Free Dictionary API
+- Shows part of speech
+- Displays up to 3 definitions per part of speech
+- Shows example sentences when available
+- Works offline? No, requires internet

package/index.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+
+const https = require('https');
+
+const word = process.argv[2];
+
+if (!word) {
+  console.error('Usage: word-def <word>');
+  console.error('Example: word-def hello');
+  process.exit(1);
+}
+
+const url = `https://api.dictionaryapi.dev/api/v2/entries/en/${encodeURIComponent(word)}`;
+
+https.get(url, (res) => {
+  let data = '';
+
+  res.on('data', chunk => data += chunk);
+  res.on('end', () => {
+    try {
+      const parsed = JSON.parse(data);
+      
+      if (res.statusCode === 404) {
+        console.log(`❌ No definition found for "${word}"`);
+        process.exit(1);
+      }
+
+      const entry = parsed[0];
+      console.log(`\n📖 ${entry.word}\n`);
+
+      entry.meanings.forEach((meaning, i) => {
+        console.log(`[${meaning.partOfSpeech}]`);
+        meaning.definitions.slice(0, 3).forEach((def, j) => {
+          console.log(`  ${j + 1}. ${def.definition}`);
+          if (def.example) {
+            console.log(`     → "${def.example}"`);
+          }
+        });
+        console.log('');
+      });
+
+    } catch (e) {
+      console.log(`❌ Error parsing response for "${word}"`);
+      process.exit(1);
+    }
+  });
+}).on('error', () => {
+  console.log('❌ Network error - check your connection');
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "word-def",
+  "version": "1.0.0",
+  "description": "CLI tool to find definitions of any English word",
+  "main": "index.js",
+  "bin": {
+    "word-def": "./index.js"
+  },
+  "scripts": {
+    "test": "echo \"No tests yet\" && exit 0"
+  },
+  "keywords": ["dictionary", "cli", "definition", "english"],
+  "author": "Oscar Roberts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/oskibobby13/word-def.git"
+  }
+}