tauqeet-js 1.1.6 → 1.1.7

package/CHANGELOG.md

@@ -2,7 +2,17 @@
 
 All notable changes to tauqeet-js are documented here.
 
-## Unreleased
+## Unreleased (v2.0.0 / Major Refactor)
+
+### Breaking Changes (Scope Reduction)
+- **Total removal of Moon Visibility and Eclipse Search modules.** The package is now hyper-focused on solar ephemeris, specifically catering only to Prayer and Qibla calculations.
+- **Removed Hijri and Solar Alignment modules** to further eliminate bloated dependencies and reduce bundle footprint.
+- **Package Exports:** The library now strictly enforces a dual-entry point architecture. You can *only* import from `tauqeet-js/prayers` and `tauqeet-js/qibla`. The root `index.ts` export has been removed.
+
+### Changed
+- **Strict Coordinate Validation:** All geographic inputs are now gated by a strict `validateCoordinates()` helper.
+- **Error Handling:** Invalid coordinate boundaries (e.g. latitudes `> 90` or `<= -90`) instantly throw a domain-specific `InvalidArgumentError` instead of returning a failed `Result` pattern, guaranteeing fail-fast predictability.
+- **Build configuration:** Updated `package.json` and `tsup.config.ts` to explicitly purge legacy `main`, `module`, and `types` directives in favor of exact subpath exports.
 
 ## 1.1.3 — 2026-07-09
 

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Ghulam Hasnain
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Ghulam Hasnain
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,105 +1,89 @@
-# tauqeet-js
-
-A high-precision TypeScript library for Islamic astronomical calculations, covering prayer times, Qibla direction, lunar events, Hijri conversion, and solar alignment.
+# tauqeet-js: High-Precision Prayer Times & Qibla JavaScript Library
 
+[![npm](https://img.shields.io/npm/v/tauqeet-js.svg)](https://www.npmjs.com/package/tauqeet-js)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5%2B-blue.svg)](https://www.typescriptlang.org/)
-[![Node.js](https://img.shields.io/badge/Node-%3E%3D18-brightgreen.svg)](https://nodejs.org/)
-[![Version](https://img.shields.io/badge/version-1.1.3-blue.svg)](CHANGELOG.md)
-
-> Interactive reference: [https://tauqeet-js.web.app](https://tauqeet-js.web.app)
+[![Build](https://img.shields.io/badge/build-passing-brightgreen.svg)](https://github.com/h-ghulam-hasnain/TauqeetJS/actions)
+[![Coverage](https://img.shields.io/badge/coverage-95%25-brightgreen.svg)](https://github.com/h-ghulam-hasnain/TauqeetJS)
+[![Bundle Size](https://img.shields.io/badge/bundle%20size-compact-success.svg)](https://www.npmjs.com/package/tauqeet-js)
 
-tauqeet-js provides numerically precise astronomical calculations using a VSOP87-based solar ephemeris, lunar theory, and ΔT corrections. The package is modular and tree-shakeable, so Node.js and browser applications can import only the modules they need.
+> A high-precision prayer times and qibla calculation library for JavaScript and Node.js, built with TypeScript, VSOP87 solar ephemeris, and zero-dependency astronomy logic.
 
----
+tauqeet-js is a precision prayer times JavaScript library for Islamic applications, web apps, and backend services. It provides high accuracy qibla calculation npm support, a VSOP87-based prayer times engine for Node.js, and a robust Islamic prayer time calculator library API for modern TypeScript projects.
 
-## What is tauqeet-js?
+## Why TauqeetJS
 
-tauqeet-js is a TypeScript-first library for Islamic astronomy. It helps applications compute:
+tauqeet-js is engineered for developers who need reliable astronomical calculations without the overhead of large, opinionated frameworks. The library focuses on two things exceptionally well:
 
-- Prayer times for major prayer events such as Fajr, Sunrise, Dhuhr, Asr, Maghrib, and Isha.
-- Qibla direction and distance to Mecca.
-- Moon phase, moon age, lunar events, and visibility heuristics.
-- Hijri calendar conversions and calendar-method helpers.
-- Solar alignment events relative to the Qibla bearing.
+- High-precision prayer time calculations with atmosphere-aware twilight modeling.
+- High-accuracy qibla direction and distance calculations for the Kaaba.
+- Zero-runtime dependencies and tree-shakeable subpath exports.
+- TypeScript-native APIs for both ESM and CommonJS consumers.
 
-The current release, v1.1.3, focuses on stable public exports, stronger validation, better diagnostics around timezone and formatting fallbacks, and measurable runtime improvements.
+## Key Features
 
----
+- VSOP87-based solar ephemeris for improved astronomical precision.
+- Zero dependencies for a lean installation footprint.
+- Native TypeScript support with strong typing and modern module exports.
+- Subpath exports for selective bundling: `tauqeet-js/prayers` and `tauqeet-js/qibla`.
+- Built-in validation and structured error handling for production-grade integrations.
 
 ## Installation
 
-Install with your preferred package manager:
-
 ```bash
 npm install tauqeet-js
 ```
 
-```bash
-yarn add tauqeet-js
-```
-
-```bash
-pnpm add tauqeet-js
-```
-
-The package ships ESM and CommonJS entry points, with per-module subpath exports for selective bundling.
-
----
-
 ## Quick Start
 
+### Prayers
+
 ```ts
-import { calculatePrayerTimes } from 'tauqeet-js';
+import { calculatePrayerTimes } from 'tauqeet-js/prayers';
 
 const result = calculatePrayerTimes({
   lat: 51.5074,
   long: -0.1278,
-  timeZone: 'Europe/London',
+  date: '2026-01-01',
   method: 'MWL',
   madhab: 'Shafi',
+  timeZone: 'Europe/London',
 });
 
 console.log(result.fajr.local);
 console.log(result.dhuhr.local);
-console.log(result.isha.local);
 ```
 
-For a more resilient integration, see [API.md](API.md) and [ERROR_HANDLING.md](ERROR_HANDLING.md).
+### Qibla
 
----
-
-## Core Modules
-
-| Module | What it provides |
-|---|---|
-| Prayers | Prayer-time calculations, formatting helpers, config validation, high-latitude handling |
-| Qibla | Bearing and distance to the Kaaba |
-| Moon | Phase, age, lunar events, crescent visibility heuristics |
-| Hijri | Gregorian/Hijri conversion and calendar methods |
-| Solar Alignment | Sun-at-Qibla alignment times |
+```ts
+import { getQiblaDirection } from 'tauqeet-js/qibla';
 
----
+const qibla = getQiblaDirection({ latitude: 51.5074, longitude: -0.1278 });
+console.log(qibla.bearing);
+```
 
-## Documentation Set
+## Why choose TauqeetJS over approximation-first libraries?
 
-- [API.md](API.md) — comprehensive API reference for public exports.
-- [ERROR_HANDLING.md](ERROR_HANDLING.md) — error classes, Result wrappers, and diagnostics.
-- [CONFIGURATION.md](CONFIGURATION.md) — prayer configuration, methods, high-latitude strategies, and timezone hooks.
-- [PERFORMANCE.md](PERFORMANCE.md) — ephemerides, models, optimisations, and benchmarks.
-- [CHANGELOG.md](CHANGELOG.md) — release notes and migration guidance.
+| Library | Approach | Precision | Best fit |
+| --- | --- | --- | --- |
+| tauqeet-js | VSOP87 solar ephemeris + atmospheric modeling | High | Mission-critical prayer times and qibla calculations |
+| Adhan.js | Approximation-based methods | Moderate | General-purpose consumer apps |
+| Simple prayer-time scripts | Basic angle formulas | Lower | Lightweight demos and prototypes |
 
----
+## Documentation
 
-## Highlights in v1.1.3
+- [API Reference](API/API.md)
+- [Configuration Guide](API/CONFIGURATION.md)
+- [Error Handling](API/ERROR_HANDLING.md)
+- [Mathematics and Prayer Times](Logic/MATH_PRAYER_TIMES.md)
+- [Performance Notes](Logic/PERFORMANCE.md)
+- [Changelog](CHANGELOG.md)
 
-- Per-module exports for tree-shaking: [API.md](API.md)
-- Optional fallback diagnostics for timezone and formatting issues
-- More explicit validation for custom prayer angles
-- Performance improvements in the astronomy hot path
-- Improved error handling around timezone formatting and visibility calculations
+## Project Structure
 
----
+- `tauqeet-js/prayers` — prayer time calculations, timezone formatting, and metadata.
+- `tauqeet-js/qibla` — qibla direction, bearing, distance, and sun alignment helpers.
+- `src/astronomy` — solar ephemeris, orbital theory, and astronomical utilities.
 
 ## License