mirror of
https://github.com/acamarata/nrel-spa-dart.git
synced 2026-07-01 19:34:25 +00:00
86db6c6bae
* feat: gap-fill API surface parity with nrel-spa JS (v1.0.1) Add formatTime, calcSpa, SpaFormattedResult, SpaFormattedAnglesResult, functionCode parameter for getSpa (spaZa/spaZaInc/spaZaRts/spaAll), incidence field on SpaResult, and export all function code constants. All 48 tests pass including numerical cross-validation against the NREL SPA reference date (Golden CO, 2003-10-17) and surface incidence angle. * docs: add CHANGELOG.md for v1.0.1 release * chore: polish pubspec, fix unused import, add wiki docs
29 lines
1.3 KiB
Markdown
29 lines
1.3 KiB
Markdown
# Changelog
|
|
|
|
## [1.0.1] - 2026-05-25
|
|
|
|
### Added
|
|
|
|
- `formatTime()` formats fractional hours to `HH:MM:SS` strings; returns `"N/A"` for non-finite or negative values
|
|
- `calcSpa()` wraps `getSpa()` and formats sunrise, solarNoon, and sunset as `HH:MM:SS` strings
|
|
- `SpaFormattedResult` — typed result for `calcSpa()` with string time fields
|
|
- `SpaFormattedAnglesResult` — formatted time strings for custom zenith angle results
|
|
- Function code constants exported from the public API: `spaZa`, `spaZaInc`, `spaZaRts`, `spaAll`
|
|
- `functionCode` parameter on `getSpa()` — controls calculation mode (ZA only, incidence, RTS, or all)
|
|
- `incidence` field on `SpaResult` — surface incidence angle in degrees; `NaN` unless `spaZaInc` or `spaAll` is used
|
|
|
|
### Changed
|
|
|
|
- `getSpa()` now defaults `functionCode` to `spaZaRts` (unchanged behaviour for existing callers)
|
|
- `SpaResult.sunrise`, `solarNoon`, `sunset` are `NaN` when `functionCode` is `spaZa` or `spaZaInc`, matching the JS reference implementation
|
|
|
|
## [1.0.0] - 2026-03-08
|
|
|
|
### Added
|
|
|
|
- `getSpa()` computes solar position for any date and location
|
|
- Custom zenith angle support for twilight calculations
|
|
- Full NREL SPA algorithm (Reda & Andreas, 2004)
|
|
- Accuracy: ±0.0003° for solar zenith angle
|
|
- Valid range: years -2000 to 6000
|
|
- Zero external dependencies
|