GreekNameCorrection

A powerful, zero-dependency library for correcting, formatting, and validating Greek names with advanced features including transliteration, genitive conversion, and intelligent name processing. Works seamlessly in both Node.js and browser environments.

!NPM Version
!License
!Node Version

Features

✨ Zero Dependencies - Lightweight and fast
🇬🇷 Greek-Specific - Built for Greek name conventions
🔄 Transliteration - Greeklish ↔ Greek ↔ Latin
📝 Smart Formatting - Proper capitalization and syntax
👔 Title Support - Handles Greek honorifics (Δρ., Καθ., etc.)
🎩 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
🏛️ Katharevousa Support - Converts archaic forms
💾 Database-Safe - SQL-ready output
🔤 Sort Keys - Accent-free sorting support
✅ Validation - Greek name pattern validation
🔧 Flexible I/O - Supports strings, arrays, and objects
✨ Accent Addition - Automatically adds accents to unaccented Greek names using comprehensive name dictionary (1,100+ names) with intelligent fallback rules

Installation

``bash
npm install greek-name-correction
`

Quick Start

`javascript
const GreekNameCorrection = require('greek-name-correction');

// Simple correction
const name = GreekNameCorrection('γιώργος παπαδόπουλος');
console.log(name); // "Γιώργος Παπαδόπουλος"

// With options
const result = GreekNameCorrection('δρ. μαρια κωνσταντινου', {
preserveOriginal: true,
detectGender: true,
convertToGenitive: true
});
console.log(result);
// {
// corrected: "Δρ. Μαρία Κωνσταντίνου",
// original: "δρ. μαρια κωνσταντινου",
// isValid: true,
// title: "Δρ.",
// gender: "female",
// genitive: "Δρ. Μαρία Κωνσταντίνου",
// parts: { firstName: "Μαρία", lastName: "Κωνσταντίνου" }
// }
`

Command-Line Interface (CLI)

The library includes a CLI tool for use from the command line.

$3

To use the CLI globally:
`bash
npm install -g greek-name-correction
`

Or use it directly with npx:
`bash
npx greek-name-correction -name "NAME" [OPTIONS]
`

$3

`bash

Basic usage

greek-name-correction -name "γιώργος παπαδόπουλος"

→ "Γιώργος Παπαδόπουλος"

Positional argument (name without -name flag)

greek-name-correction "Ραυτόπουλος Σταύρος" -convertToCase vocative

→ "Ραυτόπουλε Σταύρο"

With options

greek-name-correction -name "Γιώργος Παπαδόπουλος" -convertToCase vocative

→ "Γιώργο Παπαδόπουλο"

JSON output with preserveOriginal

greek-name-correction -name "Μαρία Κωνσταντίνου" -detectGender -addGeneralTitle -preserveOriginal -json

→ JSON object with all details

`

$3

| Option | Description |
|--------|-------------|
| -name, --name | Name to correct (required if not provided as positional argument) |
| -convertToCase | Convert to case: vocative or accusative |
| -transliterate | Transliteration: greeklish-to-greek, greek-to-latin, greek-to-greeklish |
| -convertToGenitive | Convert to genitive case |
| -preserveOriginal | Return object with original and corrected name |
| -detectGender | Detect gender from name |
| -detectDiminutive | Detect diminutive forms |
| -suggestCorrections | Suggest corrections for common misspellings |
| -recognizeKatharevousa | Recognize and convert Katharevousa forms |
| -databaseSafe | Make output database-safe |
| -generateSortKey | Generate sort key (accent-free) |
| -statistics | Generate name statistics |
| -addGeneralTitle | Add general title (κ./κα) based on gender |
| -addAccents | Add accents to firstname and lastname (one accent per word) |
| -handleTitles | Handle titles (default: true) |
| -handleParticles | Handle Greek particles (default: true) |
| -strictMode | Enable strict mode |
| -json | Output result as JSON |
| -help, -h | Show help message |
| -version, -v | Show version |

$3

`bash

Vocative case conversion

greek-name-correction -name "Γιώργος Παπαδόπουλος" -convertToCase vocative

Accusative case conversion

greek-name-correction -name "Δημήτρης Νικολάου" -convertToCase accusative

Transliteration

greek-name-correction -name "giorgos papadopoulos" -transliterate greeklish-to-greek

Multiple options with JSON output

greek-name-correction -name "Μαρία Κωνσταντίνου" -detectGender -addGeneralTitle -preserveOriginal -json

Add accents to unaccented names

greek-name-correction -name "γιωργος παπαδοπουλος" -addAccents

→ "Γιώργος Παπαδόπουλος"

Get help

greek-name-correction -help
`

Note for Windows/PowerShell users: If you encounter issues with Greek characters in quotes, try:
- Using single quotes: greek-name-correction -name 'Γιώργος Παπαδόπουλος'
- Or use a file input: echo "Γιώργος Παπαδόπουλος" | greek-name-correction

Usage Examples

$3

`javascript
// Correct capitalization and spacing
GreekNameCorrection('γιώργος παπαδόπουλος');
// → "Γιώργος Παπαδόπουλος"

GreekNameCorrection('ΜΑΡΙΑ ΚΩΝΣΤΑΝΤΙΝΟΥ');
// → "Μαρία Κωνσταντίνου"
`

$3

`javascript
const names = [
'νίκος αλεξίου',
'ΕΛΕΝΗ ΓΕΩΡΓΙΟΥ',
'δημήτρης του παπά'
];

GreekNameCorrection(names);
// → ["Νίκος Αλεξίου", "Ελένη Γεωργίου", "Δημήτρης του Παπά"]
`

$3

`javascript
const person = {
id: 1,
fullname: 'κώστας παπαδάκης',
age: 30
};

GreekNameCorrection(person, {
jsonKey: 'fullname',
outputKey: 'correctedName'
});
// → { id: 1, fullname: 'κώστας παπαδάκης', age: 30, correctedName: 'Κώστας Παπαδάκης' }
`

$3

`javascript
// Greeklish to Greek
GreekNameCorrection('giorgos papadopoulos', {
transliterate: 'greeklish-to-greek'
});
// → "Γιοργος Παπαδοπουλος"

// Greek to Latin
GreekNameCorrection('Γιώργος Παπαδόπουλος', {
transliterate: 'greek-to-latin'
});
// → "Giorgos Papadopoulos"

// Greek to Greeklish
GreekNameCorrection('Γιώργος Παπαδόπουλος', {
transliterate: 'greek-to-greeklish'
});
// → "Giorgos Papadopoulos"
`

$3

`javascript
GreekNameCorrection('Γιώργος Παπαδόπουλος', {
preserveOriginal: true,
convertToGenitive: true
});
// → {
// corrected: "Γιώργος Παπαδόπουλος",
// genitive: "Γιώργου Παπαδόπουλου"
// }
`

$3

`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'
});
// → "Μαρία Κωνσταντίνου"
`

$3

`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'
});
// → "Μαρία Κωνσταντίνου"
`

$3

`javascript
GreekNameCorrection('δρ. γιώργος παπαδόπουλος', {
preserveOriginal: true,
handleTitles: true
});
// → {
// corrected: "Δρ. Γιώργος Παπαδόπουλος",
// title: "Δρ."
// }
`

$3

`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
// }
`

$3

`javascript
// Add accents to unaccented Greek names (one accent per word)
// Uses comprehensive name dictionary for accurate placement
GreekNameCorrection('γιωργος παπαδοπουλος', {
addAccents: true
});
// → "Γιώργος Παπαδόπουλος"

GreekNameCorrection('μαρια κωνσταντινου', {
addAccents: true
});
// → "Μαρία Κωνσταντίνου"

// Words that already have accents are preserved
GreekNameCorrection('Γιώργος Παπαδόπουλος', {
addAccents: true
});
// → "Γιώργος Παπαδόπουλος" (unchanged)

// Works with preserveOriginal option
GreekNameCorrection('νικος αλεξιου', {
addAccents: true,
preserveOriginal: true
});
// → {
// corrected: "Νίκος Αλεξίου",
// original: "νικος αλεξιου",
// isValid: true
// }

// Each word gets exactly one accent
GreekNameCorrection('δημήτρης νικολάου', {
addAccents: true
});
// → "Δημήτρης Νικολάου"

// Uses name dictionary for accurate accent placement
// Falls back to heuristic rules for unknown names
GreekNameCorrection('γιαννης γεωργιου', {
addAccents: true
});
// → "Γιάννης Γεωργίου"
`

Note: The addAccents feature (v2.2.1+) uses a comprehensive name dictionary built from generate_greek_names.js with over 1,100 Greek names. It first checks the dictionary for accurate accent placement, then falls back to intelligent heuristic rules based on word endings for names not in the dictionary.

$3

`javascript
GreekNameCorrection('γιοργος παπαδοπουλος', {
preserveOriginal: true,
suggestCorrections: true
});
// → {
// corrected: "Γιώργος Παπαδόπουλος",
// wasCorrected: true,
// suggestedCorrection: "γιώργος παπαδόπουλος"
// }
`

$3

`javascript
GreekNameCorrection('Γιωργάκης Παπαδάκης', {
preserveOriginal: true,
detectDiminutive: true
});
// → {
// corrected: "Γιωργάκης Παπαδάκης",
// diminutive: [
// { word: "Γιωργάκης", isDiminutive: true, possibleBase: "γιωργας/ης", diminutiveType: "άκης" },
// { word: "Παπαδάκης", isDiminutive: true, possibleBase: "παπαδας/ης", diminutiveType: "άκης" }
// ]
// }
`

$3

`javascript
GreekNameCorrection('Γιάννης Παπαδόπουλος', {
preserveOriginal: true,
detectGender: true
});
// → { corrected: "Γιάννης Παπαδόπουλος", gender: "male" }

GreekNameCorrection('Μαρία Παπαδοπούλου', {
preserveOriginal: true,
detectGender: true
});
// → { corrected: "Μαρία Παπαδοπούλου", gender: "female" }
`

$3

`javascript
GreekNameCorrection('Γιώργος@# Παπα!δόπουλος', {
databaseSafe: true
});
// → "Γιώργος Παπαδόπουλος"
`

$3

`javascript
GreekNameCorrection('Άννα Παπαδοπούλου', {
preserveOriginal: true,
generateSortKey: true
});
// → {
// corrected: "Άννα Παπαδοπούλου",
// sortKey: "αννα παπαδοπουλου"
// }
`

$3

`javascript
GreekNameCorrection('Δρ. Γιώργος της Μαρίας Παπαδόπουλος', {
preserveOriginal: true,
statistics: true,
handleTitles: true,
handleParticles: true
});
// → {
// corrected: "Δρ. Γιώργος της Μαρίας Παπαδόπουλος",
// statistics: {
// length: 41,
// originalLength: 41,
// wordCount: 3,
// hasParticles: true,
// hasAccents: true,
// hasDiaeresis: false,
// isAllCaps: false,
// isAllLower: false,
// hasNumbers: false,
// hasSpecialChars: false
// }
// }
`

API Reference

$3

`javascript
GreekNameCorrection(input, options)
`

#### Parameters

- input {string|string[]|Object|Object[]} - Name(s) to process
- string: Single name
- string[]: Array of names
- Object: Single object with name property
- Object[]: Array of objects with name property

- options {Object} - Configuration options (all optional)

#### Options

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| jsonKey | string | 'fullname' | Property name for input names in objects |
| outputKey | string | 'correctedFullname' | Property name for corrected names in objects |
| preserveOriginal | boolean | false | Return detailed object instead of string |
| splitNames | boolean | true | Split and process name parts separately |
| detectGender | boolean | false | Detect gender from name endings |
| normalizeTonotics | boolean | true | Normalize Greek accent marks |
| handleDiacritics | boolean | true | Properly handle Greek diacritics |
| strictMode | boolean | false | Strict Greek character validation |
| 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) |
| addAccents | boolean | false | Add accents to firstname and lastname (one accent per word). Uses comprehensive name dictionary (1,100+ names) for accurate placement, with intelligent fallback rules |
| suggestCorrections | boolean | false | Suggest corrections for misspellings |
| recognizeKatharevousa | boolean | false | Convert archaic Greek forms |
| databaseSafe | boolean | false | Remove problematic characters |
| generateSortKey | boolean | false | Generate accent-free sort key |
| statistics | boolean | false | Generate name statistics |

#### Return Value

Returns the same type as input:
- string → string (or Object if preserveOriginal: true)
- string[] → string[] (or Object[] if preserveOriginal: true)
- Object → Object (with added corrected name property)
- Object[] → Object[] (with added corrected name properties)

When preserveOriginal: true, returns an object with:
`javascript
{
corrected: string, // Corrected name
original: string, // Original input
isValid: boolean, // Validation result
title?: string, // Extracted title (if handleTitles)
gender?: string, // Detected gender (if detectGender)
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
suggestedCorrection?: string // Suggested correction
}
`

Supported Greek Titles

The library recognizes and properly formats the following Greek titles:

- General: Κος, Κα, Δις, Κυρ, Κυρία, Κύριος, Δεσποινίς
- Academic: Δρ, Καθ, Καθηγητής, Καθηγήτρια
- Political: Πρωθυπουργός, Υπουργός, Βουλευτής, Δήμαρχος, Περιφερειάρχης
- Religious: Αρχιεπίσκοπος, Μητροπολίτης, Επίσκοπος, Πατήρ
- Military: Στρατηγός, Ταξίαρχος, Συνταγματάρχης, Αντισυνταγματάρχης

$3

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:

| Misspelling | Correction |
|-------------|------------|
| γιοργος | γιώργος |
| δημητρης | δημήτρης |
| νικος | νίκος |
| μαρια | μαρία |
| ελενη | ελένη |
| κωνσταντινος | κωνσταντίνος |
| ιωαννης | ιωάννης |
| And many more... | |

Transliteration Tables

$3

The library uses intelligent multi-character pattern matching:

- th → θ
- ch → χ
- ps → ψ
- ou → ου
- ai → αι
- ei → ει
- mp → μπ
- nt → ντ
- gk → γκ
- And all single characters...

$3

Full support for all Greek characters including accented vowels and diaeresis.

Advanced Usage

$3

`javascript
const result = GreekNameCorrection('dr giorgos tou papa', {
transliterate: 'greeklish-to-greek',
preserveOriginal: true,
handleTitles: true,
addGeneralTitle: true,
addAccents: true,
handleParticles: true,
suggestCorrections: true,
detectGender: true,
convertToGenitive: true,
generateSortKey: true,
statistics: true,
detectDiminutive: true,
databaseSafe: true
});

console.log(result);
// Complete analysis with all features enabled
`

$3

`javascript
const employees = [
{ empId: 1, employeeName: 'giorgos papadopoulos', dept: 'IT' },
{ empId: 2, employeeName: 'maria konstantinou', dept: 'HR' }
];

const processed = GreekNameCorrection(employees, {
jsonKey: 'employeeName',
outputKey: 'greekName',
transliterate: 'greeklish-to-greek',
detectGender: true,
preserveOriginal: true
});
`

$3

`javascript
// For SQL Server / PostgreSQL
const safeName = GreekNameCorrection(userInput, {
databaseSafe: true,
removeExtraSpaces: true,
strictMode: true
});

// For sorting queries
const { corrected, sortKey } = GreekNameCorrection(name, {
preserveOriginal: true,
generateSortKey: true
});

// INSERT INTO users (name, name_sort) VALUES (?, ?)
// [corrected, sortKey]
`

Use Cases

$3

`javascript
app.post('/register', (req, res) => {
const corrected = GreekNameCorrection(req.body.fullname, {
suggestCorrections: true,
handleTitles: true,
databaseSafe: true
});
// Save corrected name to database
});
`

$3

`javascript
// Convert Greeklish to Greek during import
const greekNames = csvData.map(row =>
GreekNameCorrection(row.name, {
transliterate: 'greeklish-to-greek'
})
);

// Convert to Latin for international systems
const latinNames = greekNames.map(name =>
GreekNameCorrection(name, {
transliterate: 'greek-to-latin'
})
);
`

$3

`javascript
// Generate search keys
const searchKey = GreekNameCorrection(searchTerm, {
generateSortKey: true,
preserveOriginal: true
}).sortKey;

// Search without accent sensitivity
`

$3

`javascript
// Generate formal documents with genitive forms
const recipient = GreekNameCorrection(name, {
convertToGenitive: true,
handleTitles: true,
preserveOriginal: true
});

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}); // "Είδα τον Δημήτρη Νικολάου"
`

$3

`javascript
const person = GreekNameCorrection(name, {
detectGender: true,
preserveOriginal: true
});

const pronoun = person.gender === 'male' ? 'ο' : 'η';
console.log(${pronoun} ${person.corrected});
`

Performance

- Zero dependencies: No external packages required
- Efficient: Processes thousands of names per second
- Memory-friendly: Minimal memory footprint
- Pure JavaScript: No native bindings

Browser Support

The library is fully compatible with browser environments! It automatically detects the runtime environment and works seamlessly in both Node.js and browsers.

$3

- ✅ Automatic Environment Detection - No configuration needed
- ✅ Zero Browser Errors - No __dirname or Node.js-specific globals required
- ✅ Full Feature Support - All features work in browsers, including case conversion
- ✅ Smart Fallback - Uses hard-coded rules in browsers, markdown files in Node.js when available

$3

`javascript
// Works directly in browser (with bundler like Webpack, Browserify, or Vite)
import GreekNameCorrection from 'greek-name-correction';

// All features work, including case conversion
const result = GreekNameCorrection('Γιώργος Παπαδόπουλος', {
convertToCase: 'vocative',
detectGender: true
});
`

The library automatically uses hard-coded rules for case conversion in browser environments, ensuring full functionality without file system access.

TypeScript

Full TypeScript support is included! The library comes with comprehensive type definitions for all features.

$3

TypeScript definitions are automatically included when you install the package:

`bash
npm install greek-name-correction
`

$3

`typescript
import GreekNameCorrection = require('greek-name-correction');
// or
import GreekNameCorrection from 'greek-name-correction';

// TypeScript will provide full type checking and IntelliSense
const result = GreekNameCorrection('γιάννης παπαδόπουλος', {
preserveOriginal: true,
detectGender: true,
convertToGenitive: true
});

// result is typed as GreekNameCorrectionResult
console.log(result.corrected); // string
console.log(result.gender); // 'male' | 'female' | 'unknown' | undefined
console.log(result.genitive); // string | undefined
`

$3

All types are exported for use in your TypeScript projects:

`typescript
import {
GreekNameCorrectionOptions,
GreekNameCorrectionResult,
Gender,
NameParts,
DiminutiveInfo,
NameStatistics,
TransliterationMode,
CaseConversion
} from 'greek-name-correction';
`

$3

- ✅ Full type safety - All function signatures are typed
- ✅ IntelliSense support - Autocomplete for all options
- ✅ Type inference - Return types are automatically inferred
- ✅ Overloads - Separate overloads for string, array, and object inputs
- ✅ JSDoc comments - Inline documentation in your IDE

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

$3

`bash

Clone the repository

git clone https://github.com/sraftopo/greek-name-correction.git

Install dependencies (none currently!)

npm install

Run tests

npm test
`

Testing

`bash
npm test
`

The test suite covers:
- Basic string correction
- Array processing
- Object processing
- All transliteration modes
- Case conversions (genitive, vocative, accusative)
- Title handling
- Automatic general title addition
- Accent addition
- Diminutive detection
- Gender detection
- Statistics generation
- Edge cases and error handling

Changelog

$3

- 🔧 Package Configuration - Updated repository URL format in package.json

$3

- 🔧 Enhanced Accent Addition - Improved addAccents feature with comprehensive name dictionary support. Now uses actual Greek name dictionaries from generate_greek_names.js for accurate accent placement on common names. Includes CLI support with -addAccents flag.
- ✨ Name Dictionary - Built-in dictionary with 1,100+ Greek names (first names, surnames, compound surnames) for accurate accent placement
- 🐛 CLI Fix - Added missing -addAccents flag to command-line interface

$3

- ✨ Accent Addition Feature - Added addAccents option to automatically add accents to unaccented Greek names (one accent per word). Intelligently places accents based on Greek accentuation rules and word endings.
- ✨ TypeScript Support - Added comprehensive TypeScript definitions (index.d.ts) with full type safety, IntelliSense support, and exported types

$3

- 🐛 Bug Fix - Fixed splitNameParts to correctly filter out general titles (κ. and κα) from name parts

$3

- ✨ Automatic General Title Addition - Added addGeneralTitle option to automatically add general titles (κ. for men, κα for women) when no title exists

$3

- 🏗️ 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
- ✨ Enhanced Code Organization - Each module has a single, clear responsibility

$3

- ✨ Added transliteration support (Greeklish ↔ Greek ↔ Latin)
- ✨ Added case conversion (genitive, vocative, accusative)
- ✨ Added diminutive detection
- ✨ Added title/honorific support
- ✨ Added name correction suggestions
- ✨ Added Katharevousa recognition
- ✨ Added database-safe output
- ✨ Added sort key generation
- ✨ Added comprehensive statistics
- 🐛 Improved accent normalization
- 🐛 Better particle handling

$3

- 🎉 Initial release
- ✅ Basic name correction
- ✅ Gender detection
- ✅ Name part splitting
- ✅ Validation

License

MIT © Stavros

Support

For bugs, questions, and discussions please use the GitHub Issues.

Acknowledgments

Built with ❤️ for the Greek developer community.

Special thanks to all contributors and users who help improve this library.

Related Projects

- greek-utils - General Greek language utilities
- transliteration - General transliteration library

---

Made in Greece 🇬🇷

If you find this library helpful, please consider giving it a ⭐️ on GitHub!