@aulunarcana/ephemeris 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +17 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -112,6 +112,23 @@ A requested body whose table isn't loaded (or whose date is outside
112
112
  table coverage) is listed in `chart.outOfRange` instead of failing
113
113
  the chart.
114
114
 
115
+ ## Fast path: positions only
116
+
117
+ For transit scans and anything else that samples a few bodies across
118
+ many instants, `computeBodies` returns just the requested bodies'
119
+ apparent positions and daily rates — identical numbers to the full
120
+ chart, at a fraction of the cost (a full chart computes houses,
121
+ nodes, lots, aspects, and patterns you may not need):
122
+
123
+ ```js
124
+ const { bodies } = engine.computeBodies(
125
+ { year: 2026, month: 1, day: 1, hour: 12, minute: 0 }, // UTC fields
126
+ ["jupiter", "saturn", "mars"],
127
+ );
128
+ bodies.jupiter.longitudeRad; // apparent ecliptic longitude
129
+ bodies.jupiter.longitudeRateRadPerDay; // analytic rate (negative = retrograde)
130
+ ```
131
+
115
132
  ## Time handling
116
133
 
117
134
  `computeChart` takes naive civil time plus an IANA zone and resolves
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aulunarcana/ephemeris",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "AuLun Ephemeris: NASA-grade astronomical ephemeris and chart engine (WASM). Free for non-commercial use; commercial licenses available.",
5
5
  "type": "module",
6
6
  "repository": {