Numerology Engine TS 🔮

Advanced numerology calculation engine for tarot and esoteric applications. Calculate life path numbers, expression numbers, soul urge numbers, and more!

Features

• Life Path Number: Core numerological number representing life's purpose
• Expression Number: Represents talents, abilities, and potential
• Soul Urge Number: Inner motivations and heart's desires
• Personality Number: How others perceive you
• Birthday Number: Natural talents
• Life Challenges: Obstacles to overcome
• Life Pinnacles: Peak achievement periods
• Life Cycles: Major life periods

Installation

npm install numerology-engine-ts

Usage

import { NumerologyEngine, calculateLifePath } from 'numerology-engine-ts';

// Quick calculation
const lifePath = calculateLifePath('1990-05-15'); // Returns: 6

// Complete reading
const reading = NumerologyEngine.calculateReading({
  fullName: 'John Doe Smith',
  birthDate: '1990-05-15'
});

console.log(reading);
// {
//   lifePathNumber: 6,
//   expressionNumber: 8,
//   soulUrgeNumber: 3,
//   personalityNumber: 5,
//   birthdayNumber: 15,
//   challenges: [1, 4, 3, 7],
//   pinnacles: [2, 3, 5, 2],
//   lifeCycles: [2, 6, 8]
// }

API Reference

NumerologyEngine.calculateReading(birthInfo)

Returns a complete numerological analysis.

Parameters:

• birthInfo: Object with fullName and birthDate

Returns: NumerologyReading object

Individual Calculations

• calculateLifePath(birthDate) - Life path number
• calculateExpression(fullName) - Expression number
• calculateSoulUrge(fullName) - Soul urge number

Master Numbers

The engine properly handles master numbers (11, 22, 33) and doesn't reduce them to single digits, as they carry special significance in numerology.

Dependencies

• luxon - For advanced date handling

License

MIT