mirror of
https://github.com/acamarata/pray-calc.git
synced 2026-06-30 19:04:26 +00:00
chore: untrack AGENTS.md (AI working memory, not source code)
This commit is contained in:
Aric Camarata
parent
cf68c044a6
commit
681126643f
1 changed files with 0 additions and 116 deletions
|
|
@ -1,116 +0,0 @@
|
|||
# pray-calc — PRI (Per-Repo Instructions)
|
||||
|
||||
**Cascade:** GCI → ASI → PPI (`/Volumes/X9/Sites/acamarata/.claude/CLAUDE.md`) → **PRI (this file)**
|
||||
|
||||
## What This Is
|
||||
|
||||
High-precision Islamic prayer times calculator in TypeScript. Computes Fajr, Dhuhr, Asr,
|
||||
Maghrib, Isha, Qiyam, Sunrise, and solar Noon for any location on Earth. Uses a physics-
|
||||
grounded dynamic twilight angle algorithm as the primary method. Includes 14 traditional
|
||||
fixed-angle methods for direct comparison.
|
||||
|
||||
**npm:** `pray-calc@2.1.0`
|
||||
**Language:** TypeScript source → dual CJS/ESM build (tsup)
|
||||
**Node requirement:** >=20
|
||||
**License:** MIT
|
||||
|
||||
## Dependencies
|
||||
|
||||
- **nrel-spa** (^2.0.1) — NREL Solar Position Algorithm (zero-dep, sync, acamarata's own)
|
||||
- No moon dependency. Moon data: use `moon-sighting` package.
|
||||
|
||||
Dev: @types/node, tsup, typescript
|
||||
|
||||
## v2 API Surface
|
||||
|
||||
```typescript
|
||||
// Core functions
|
||||
getTimes(date, lat, lng, tz?, elevation?, temperature?, pressure?, hanafi?): PrayerTimes
|
||||
calcTimes(...): FormattedPrayerTimes
|
||||
getTimesAll(...): PrayerTimesAll
|
||||
calcTimesAll(...): FormattedPrayerTimesAll
|
||||
|
||||
// Low-level
|
||||
getAngles(date, lat, lng, elevation?, temperature?, pressure?): TwilightAngles
|
||||
getAsr(solarNoon, latitude, declination, hanafi?): number
|
||||
getQiyam(fajrTime, ishaTime): number
|
||||
getMscFajr(date, latitude): number // minutes before sunrise
|
||||
getMscIsha(date, latitude, shafaq?): number // minutes after sunset
|
||||
|
||||
// Ephemeris
|
||||
solarEphemeris(jd): { decl, r, eclLon }
|
||||
toJulianDate(date): number
|
||||
|
||||
// Reference data
|
||||
METHODS: MethodDefinition[]
|
||||
```
|
||||
|
||||
`nrel-spa` API (v2.x): `getSpa(date, lat, lng, tz, opts, zeniths)` and `formatTime(h)`
|
||||
Note: `fractalTime` was renamed to `formatTime` in v2.0.0. `fractalTime` does not exist.
|
||||
|
||||
## Module Structure
|
||||
|
||||
```
|
||||
src/
|
||||
├── index.ts Main exports
|
||||
├── types.ts All TypeScript types
|
||||
├── getSolarEphemeris.ts Jean Meeus Ch. 25 — decl, r, eclLon
|
||||
├── getMSC.ts MSC piecewise seasonal model
|
||||
├── getAngles.ts Dynamic angle algorithm (3 layers)
|
||||
├── getAsr.ts Pure-math Asr (no SPA dependency)
|
||||
├── getQiyam.ts Last-third-of-night
|
||||
├── getTimes.ts Raw fractional-hour output
|
||||
├── calcTimes.ts Formatted HH:MM:SS output
|
||||
├── getTimesAll.ts All-methods batch SPA call
|
||||
└── calcTimesAll.ts All-methods formatted output
|
||||
```
|
||||
|
||||
## Domain Reference
|
||||
|
||||
Algorithm math, method angle table, and astronomical research facts:
|
||||
— load when working on angle calculations or method constants.
|
||||
|
||||
## getSpa Batch Pattern
|
||||
|
||||
`getTimesAll` uses one SPA call for all 14×2 + 2 dynamic zenith angles:
|
||||
|
||||
```typescript
|
||||
allZeniths = [90+fajrAngle, 90+ishaAngle, ...methodZeniths]
|
||||
// methodZeniths: 14 methods × 2 = 28 entries
|
||||
// Methods with null ishaAngle get placeholder 90+18 (overridden post-call)
|
||||
spaData.angles[0].sunrise → dynamic Fajr
|
||||
spaData.angles[1].sunset → dynamic Isha
|
||||
spaData.angles[2+i*2].sunrise → method[i] Fajr
|
||||
spaData.angles[2+i*2+1].sunset → method[i] Isha (if angle-based)
|
||||
```
|
||||
|
||||
## Commands
|
||||
|
||||
- `pnpm build` — tsup dual CJS/ESM build
|
||||
- `pnpm run typecheck` — tsc --noEmit
|
||||
- `pnpm test` — build + node test.mjs + node test-cjs.cjs (94 ESM + 12 CJS = 106 tests)
|
||||
|
||||
## Version History
|
||||
|
||||
- **v2.0.0** — TypeScript rewrite, 14 methods, physics corrections, no suncalc, no moon
|
||||
- **v1.7.2** — Last CJS version with moon functions (getMoon, getMoonPhase, etc.)
|
||||
- Moon functions migrated to `moon-sighting` package
|
||||
|
||||
## Moon Migration
|
||||
|
||||
All moon functions removed from v2. Users should:
|
||||
|
||||
```bash
|
||||
pnpm add moon-sighting
|
||||
```
|
||||
|
||||
Map: `getMoon` → `getMoon`, `getMoonPhase` → `getMoonPhase`, etc.
|
||||
See `.github/wiki/Moon-Migration.md` for full table. moon-sighting uses Meeus Ch.47/48 +
|
||||
Odeh 2006 visibility, no suncalc dependency.
|
||||
|
||||
## Related
|
||||
|
||||
- nrel-spa: `~/Sites/acamarata/nrel-spa/` — solar foundation
|
||||
- moon-sighting: `~/Sites/acamarata/moon-sighting/` — lunar data
|
||||
- praycalc.com — live demo
|
||||
- praycalc.net — documentation site
|
||||
Loading…
Reference in a new issue