af34aef986
- Remove .npmignore (violation: npm-package-standard requires files field in package.json, not .npmignore; files field was already present and correct) - Add c8@^10.1.3 to devDependencies for native V8 coverage (ADR-008) - Fix coverage script: was 'node --test' (missing test.mjs), now correct - Replace lint job in ci.yml with coverage job per ci-standard.md four-job pattern (test/typecheck/pack-check/coverage); lint+format remain as local scripts invocable manually npm pack --dry-run: zero warnings, 11 files, expected contents verified. Tests: 119 ESM + 15 CJS = 134 pass, 0 fail. |
||
|---|---|---|
| .github | ||
| src | ||
| .editorconfig | ||
| .gitignore | ||
| .npmrc | ||
| .nvmrc | ||
| CHANGELOG.md | ||
| eslint.config.mjs | ||
| LICENSE | ||
| package.json | ||
| pnpm-lock.yaml | ||
| pnpm-workspace.yaml | ||
| README.md | ||
| test-cjs.cjs | ||
| test.mjs | ||
| tsconfig.json | ||
| tsup.config.ts | ||
pray-calc
Islamic prayer times for any location and date. The primary method uses a physics-grounded dynamic twilight angle algorithm that adjusts Fajr and Isha angles for latitude, season, Earth-Sun distance, and atmospheric conditions. Fourteen traditional fixed-angle methods are included for comparison. Single runtime dependency: nrel-spa.
Installation
npm install pray-calc
Quick Start
import { calcTimes } from 'pray-calc';
const times = calcTimes(
new Date('2024-06-21'),
40.7128, // New York latitude
-74.0060, // longitude
-4, // UTC offset (hours)
);
console.log(times.Fajr); // "03:51:24"
console.log(times.Sunrise); // "05:25:08"
console.log(times.Dhuhr); // "13:01:17"
console.log(times.Asr); // "17:02:43"
console.log(times.Maghrib); // "20:31:17"
console.log(times.Isha); // "22:07:43"
CommonJS:
const { calcTimes } = require('pray-calc');
Use calcTimesAll to get all 14 traditional method times alongside the dynamic result.
TypeScript
import type {
PrayerTimes,
FormattedPrayerTimes,
PrayerTimesAll,
MethodDefinition,
} from 'pray-calc';
Documentation
Full API reference, dynamic algorithm details, traditional method table, and high-latitude handling: GitHub Wiki
Related
- nrel-spa: NREL Solar Position Algorithm (the solar foundation)
- luxon-hijri: Hijri/Gregorian calendar
- moon-sighting: Crescent visibility calculations
Acknowledgments
Solar position calculations use nrel-spa, a port of the NREL SPA by Ibrahim Reda and Afshin Andreas. The seasonal twilight model builds on the work of Khalid Shaukat (Moonsighting Committee Worldwide).
License
MIT. Copyright (c) 2023-2026 Aric Camarata.