greek-name-correction 2.1.0 → 2.1.1

package/README.md

@@ -13,7 +13,8 @@ A powerful, zero-dependency Node.js library for correcting, formatting, and vali
 🔄 **Transliteration** - Greeklish ↔ Greek ↔ Latin  
 📝 **Smart Formatting** - Proper capitalization and syntax  
 👔 **Title Support** - Handles Greek honorifics (Δρ., Καθ., etc.)  
-🔀 **Genitive Conversion** - Automatic του/της forms  
+🎩 **Auto Title Addition** - Automatically adds general titles (Κ. for men, Κα for women)  
+🔀 **Case Conversion** - Genitive, vocative, and accusative forms  
 🎯 **Gender Detection** - Identifies gender from name endings  
 📊 **Statistics** - Comprehensive name analysis  
 🔍 **Diminutive Detection** - Recognizes nickname patterns  
@@ -122,10 +123,60 @@ GreekNameCorrection('Γιώργος Παπαδόπουλος', {
 });
 // → { 
 //     corrected: "Γιώργος Παπαδόπουλος",
-//     genitive: "Γιώργος Παπαδόπουλου"
+//     genitive: "Γιώργου Παπαδόπουλου"
 //   }
 ```
 
+### Vocative Case Conversion
+```javascript
+// Convert to vocative case (for addressing someone)
+GreekNameCorrection('Γιώργος Παπαδόπουλος', {
+  convertToCase: 'vocative'
+});
+// → "Γιώργο Παπαδόπουλο"
+
+// With preserveOriginal to get both forms
+GreekNameCorrection('Γιάννης Αλεξίου', {
+  convertToCase: 'vocative',
+  preserveOriginal: true
+});
+// → {
+//     corrected: "Γιάννης Αλεξίου",
+//     vocative: "Γιάννη Αλεξίου"
+//   }
+
+// Feminine names usually remain unchanged
+GreekNameCorrection('Μαρία Κωνσταντίνου', {
+  convertToCase: 'vocative'
+});
+// → "Μαρία Κωνσταντίνου"
+```
+
+### Accusative Case Conversion
+```javascript
+// Convert to accusative case (for direct objects)
+GreekNameCorrection('Γιώργος Παπαδόπουλος', {
+  convertToCase: 'accusative'
+});
+// → "Γιώργο Παπαδόπουλο"
+
+// With preserveOriginal to get both forms
+GreekNameCorrection('Κώστας Παπαδάκης', {
+  convertToCase: 'accusative',
+  preserveOriginal: true
+});
+// → {
+//     corrected: "Κώστας Παπαδάκης",
+//     accusative: "Κώστα Παπαδάκη"
+//   }
+
+// Feminine names usually remain unchanged
+GreekNameCorrection('Μαρία Κωνσταντίνου', {
+  convertToCase: 'accusative'
+});
+// → "Μαρία Κωνσταντίνου"
+```
+
 ### Title Handling
 ```javascript
 GreekNameCorrection('δρ. γιώργος παπαδόπουλος', {
@@ -138,6 +189,39 @@ GreekNameCorrection('δρ. γιώργος παπαδόπουλος', {
 //   }
 ```
 
+### Automatic General Title Addition
+```javascript
+// Add general title (κ. for men, κα for women) if no title exists
+// Titles are always lowercase
+GreekNameCorrection('Γιώργος Παπαδόπουλος', {
+  addGeneralTitle: true
+});
+// → "κ. Γιώργος Παπαδόπουλος"
+
+GreekNameCorrection('Μαρία Κωνσταντίνου', {
+  addGeneralTitle: true
+});
+// → "κα Μαρία Κωνσταντίνου"
+
+// Names with existing titles are not modified
+GreekNameCorrection('Δρ. Γιώργος Παπαδόπουλος', {
+  addGeneralTitle: true
+});
+// → "Δρ. Γιώργος Παπαδόπουλος"
+
+// Works with preserveOriginal option
+GreekNameCorrection('Ελένη Γεωργίου', {
+  addGeneralTitle: true,
+  preserveOriginal: true
+});
+// → {
+//     corrected: "κα Ελένη Γεωργίου",
+//     original: "Ελένη Γεωργίου",
+//     title: "κα",
+//     isValid: true
+//   }
+```
+
 ### Name Corrections
 ```javascript
 GreekNameCorrection('γιοργος παπαδοπουλος', {
@@ -258,9 +342,11 @@ GreekNameCorrection(input, options)
 | `removeExtraSpaces` | `boolean` | `true` | Remove extra whitespace |
 | `handleParticles` | `boolean` | `true` | Handle Greek particles (του/της/των) |
 | `convertToGenitive` | `boolean` | `false` | Convert to genitive case |
+| `convertToCase` | `string\|null` | `null` | Convert to case: `'vocative'` or `'accusative'` |
 | `transliterate` | `string\|null` | `null` | Transliteration mode: `'greeklish-to-greek'`, `'greek-to-latin'`, `'greek-to-greeklish'` |
 | `detectDiminutive` | `boolean` | `false` | Detect diminutive/nickname forms |
 | `handleTitles` | `boolean` | `true` | Extract and format titles |
+| `addGeneralTitle` | `boolean` | `false` | Automatically add general title (κ. for men, κα for women) if no title exists (always lowercase) |
 | `suggestCorrections` | `boolean` | `false` | Suggest corrections for misspellings |
 | `recognizeKatharevousa` | `boolean` | `false` | Convert archaic Greek forms |
 | `databaseSafe` | `boolean` | `false` | Remove problematic characters |
@@ -286,6 +372,8 @@ When `preserveOriginal: true`, returns an object with:
   parts?: Object,           // Name parts (if splitNames)
   diminutive?: Array,       // Diminutive info (if detectDiminutive)
   genitive?: string,        // Genitive form (if convertToGenitive)
+  vocative?: string,        // Vocative form (if convertToCase: 'vocative')
+  accusative?: string,      // Accusative form (if convertToCase: 'accusative')
   sortKey?: string,         // Sort key (if generateSortKey)
   statistics?: Object,      // Name statistics (if statistics)
   wasCorrected?: boolean,   // If corrections were applied
@@ -303,6 +391,14 @@ The library recognizes and properly formats the following Greek titles:
 - **Religious**: Αρχιεπίσκοπος, Μητροπολίτης, Επίσκοπος, Πατήρ
 - **Military**: Στρατηγός, Ταξίαρχος, Συνταγματάρχης, Αντισυνταγματάρχης
 
+### Automatic General Title Addition
+
+When `addGeneralTitle: true` is enabled, the library automatically adds general titles based on detected gender:
+- **κ.** (κύριος) for male names
+- **κα** (κυρία) for female names
+
+**Note:** General titles are always added in lowercase format. This feature only adds titles when no existing title is detected, ensuring that professional or academic titles are preserved.
+
 ## Common Name Corrections
 
 The library automatically corrects common Greek name misspellings:
@@ -347,6 +443,7 @@ const result = GreekNameCorrection('dr giorgos tou papa', {
   transliterate: 'greeklish-to-greek',
   preserveOriginal: true,
   handleTitles: true,
+  addGeneralTitle: true,
   handleParticles: true,
   suggestCorrections: true,
   detectGender: true,
@@ -448,6 +545,20 @@ const recipient = GreekNameCorrection(name, {
 });
 
 console.log(`Προς: ${recipient.genitive}`);
+
+// Use vocative case for addressing someone
+const addressee = GreekNameCorrection('Γιώργος Παπαδόπουλος', {
+  convertToCase: 'vocative'
+});
+
+console.log(`Αγαπητέ ${addressee},`); // "Αγαπητέ Γιώργο Παπαδόπουλο,"
+
+// Use accusative case for direct objects
+const object = GreekNameCorrection('Δημήτρης Νικολάου', {
+  convertToCase: 'accusative'
+});
+
+console.log(`Είδα τον ${object}`); // "Είδα τον Δημήτρη Νικολάου"
 ```
 
 ### 5. Gender-Based Processing
@@ -513,8 +624,9 @@ The test suite covers:
 - Array processing
 - Object processing
 - All transliteration modes
-- Genitive conversion
+- Case conversions (genitive, vocative, accusative)
 - Title handling
+- Automatic general title addition
 - Diminutive detection
 - Gender detection
 - Statistics generation
@@ -522,7 +634,10 @@ The test suite covers:
 
 ## Changelog
 
-### Version 2.1.0 (Current)
+### Version 2.1.1 (Current)
+- ✨ **Automatic General Title Addition** - Added `addGeneralTitle` option to automatically add general titles (κ. for men, κα for women) when no title exists
+
+### Version 2.1.0
 - 🏗️ **Modular Architecture** - Complete codebase refactoring into logical modules
 - 📦 **Improved Structure** - Separated into `transliteration.js`, `cases.js`, `validation.js`, `utils.js`, `constants.js`
 - 🔧 **Better Maintainability** - Clean separation of concerns for easier testing and development
@@ -530,7 +645,7 @@ The test suite covers:
 
 ### Version 2.0.0
 - ✨ Added transliteration support (Greeklish ↔ Greek ↔ Latin)
-- ✨ Added genitive case conversion
+- ✨ Added case conversion (genitive, vocative, accusative)
 - ✨ Added diminutive detection
 - ✨ Added title/honorific support
 - ✨ Added name correction suggestions

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "greek-name-correction",
-    "version": "2.1.0",
+    "version": "2.1.1",
     "description": "A zero-dependency Node.js library for correcting and formatting Greek names with transliteration, genitive conversion, and advanced features",
     "main": "src/index.js",
     "scripts": {

package/src/index.js

@@ -23,7 +23,8 @@ const {
   generateSortKey,
   generateStatistics,
   detectGender,
-  splitNameParts
+  splitNameParts,
+  addGeneralTitleIfMissing
 } = require("./utils");
 
 /**
@@ -54,7 +55,8 @@ function GreekNameCorrection(input, options = {}) {
     recognizeKatharevousa: false,
     databaseSafe: false,
     generateSortKey: false,
-    statistics: false
+    statistics: false,
+    addGeneralTitle: false
   };
 
   const config = { ...defaults, ...options };
@@ -131,7 +133,21 @@ function GreekNameCorrection(input, options = {}) {
       genitiveForm = convertToGenitive(processed, config);
     }
 
-    // Convert to case (vocative or accusative) - before re-attaching title
+    // Database-safe output
+    if (config.databaseSafe) {
+      processed = makeDatabaseSafe(processed);
+    }
+
+    // Add general title (Κ. or Κα) if no title exists and option is enabled
+    // This is done after processing so gender detection works on the final name
+    if (config.addGeneralTitle && !extractedTitle) {
+      const generalTitle = addGeneralTitleIfMissing(processed);
+      if (generalTitle) {
+        extractedTitle = generalTitle;
+      }
+    }
+
+    // Convert to case (vocative or accusative) - after adding general title if needed
     let caseForm = null;
     if (config.convertToCase) {
       if (config.convertToCase === "vocative") {
@@ -139,18 +155,13 @@ function GreekNameCorrection(input, options = {}) {
       } else if (config.convertToCase === "accusative") {
         caseForm = convertToAccusative(processed, config);
       }
-      // Re-attach title to case form if it was extracted
+      // Re-attach title to case form if it was extracted or added
       if (extractedTitle && caseForm) {
         caseForm = extractedTitle + " " + caseForm;
       }
     }
 
-    // Database-safe output
-    if (config.databaseSafe) {
-      processed = makeDatabaseSafe(processed);
-    }
-
-    // Re-attach title if it was extracted
+    // Re-attach title if it was extracted or added
     if (extractedTitle) {
       processed = extractedTitle + " " + processed;
     }

package/src/utils.js

@@ -218,6 +218,26 @@ function splitNameParts(fullname) {
   };
 }
 
+// Add general title (κ. for men, κα for women) if no title exists
+function addGeneralTitleIfMissing(nameWithoutTitle) {
+  if (!nameWithoutTitle || nameWithoutTitle.trim() === "") {
+    return null;
+  }
+
+  // Detect gender from the name
+  const gender = detectGender(nameWithoutTitle);
+
+  // Add appropriate title based on gender (always lowercase)
+  if (gender === "male") {
+    return "κ.";
+  } else if (gender === "female") {
+    return "κα";
+  }
+
+  // If gender is unknown, don't add a title
+  return null;
+}
+
 module.exports = {
   capitalizeGreekName,
   isGreekParticle,
@@ -229,5 +249,6 @@ module.exports = {
   generateSortKey,
   generateStatistics,
   detectGender,
-  splitNameParts
+  splitNameParts,
+  addGeneralTitleIfMissing
 };