astroceleste-engine 0.0.12 → 0.0.14

package/NOTICE

@@ -33,6 +33,12 @@ Ephemeris data: NASA JPL planetary ephemerides (DE440s and others) are public do
 works of the U.S. Government, fetched at build/run time and not distributed here, except
 for a one-year DE440s excerpt used by the tests (tests/data/de440s_2000.bsp).
 
+The minor-body longitude tables (src/data/minor/*.bin) and their test check points
+(tests/fixtures/minor_bodies.json) are sampled from the JPL Horizons on-line solar system
+data and ephemeris computation service (https://ssd.jpl.nasa.gov/horizons/), Solar
+System Dynamics Group, Jet Propulsion Laboratory, California Institute of Technology, by
+scripts/fetch_minor_bodies.py.
+
 The Zi Wei Dou Shu star brightness table (src/chinese/ziwei.rs) is taken from iztro
 (https://github.com/SylarLong/iztro), used under the MIT license:
 

package/README.md

@@ -12,7 +12,7 @@ computed entirely in the browser (or Node), identical to the Astroceleste server
 [API guide](https://github.com/ffalcinelli/astroceleste-engine/blob/main/docs/api.md)
 
 ```js
-import init, { Engine, synastry, derivedChart } from "astroceleste-engine";
+import init, { Engine, synastry, derivedChart, bazi, ziWei, timeLords } from "astroceleste-engine";
 
 await init();
 const engine = new Engine();
@@ -23,16 +23,27 @@ const chart = engine.chart({
   utc: "1987-05-17T14:30:00Z",
   latitude: 41.9,
   longitude: 12.5,
-  house_system: "P",        // optional: P, W, E, O
+  house_system: "P",        // optional: P, K, R, C, T, B, M, O, S, E, V, W
   zodiac_type: "sidereal",  // optional: tropical (default) or sidereal
   ayanamsa: "lahiri",       // optional
+  chinese_calendar: true,   // optional: add the Chinese calendar of the moment
 });
-const horary = engine.horary(request);                 // chart + horary_data
+const horary = engine.horary({ ...request, quesited_house: 7 }); // chart + horary_data
 const transit = engine.transit(chart.planets, request);
+const election = engine.election(request, { purpose: "contract" });
+const windows = engine.elections(request, "1987-06-17T00:00:00Z", { purpose: "launch" });
 synastry(chartA.planets, chartB.planets);
 derivedChart(chart, 5);
+timeLords(birthUtc, sunLongitude, ascendantLongitude, fromUtc, toUtc);
+bazi(chart.chinese_calendar, request.utc, 12.5, 60);   // Four Pillars, UTC offset in minutes
+ziWei(chart.chinese_calendar, request.utc, 12.5, 60);  // Zi Wei Dou Shu
 ```
 
+Also: `engine.chineseCalendar(utc)`, `engine.kernels`, `engine.coverage`,
+`engine.supports(jd)`, `chartDignities(chart, "dorothean")`, `degreeQualities(longitude)`,
+`degreeQualityTable()` and `julianDay(utc)`. The [API guide](https://github.com/ffalcinelli/astroceleste-engine/blob/main/docs/api.md)
+describes every option and result.
+
 To ship a smaller kernel, cut the range you need (positions are unchanged inside it):
 
 ```js
@@ -41,7 +52,7 @@ const small = excerptKernel(fullKernelBytes, 2415020.5, 2488069.5); // 1900-2100
 ```
 
 Errors are thrown as `Error` objects with a `code` (`ephemeris_out_of_range`,
-`invalid_input`, `invalid_kernel`).
+`ephemeris_error`, `invalid_input`, `invalid_kernel`, `internal_error`).
 
 JPL kernels: https://ssd.jpl.nasa.gov/ftp/eph/planets/bsp/ (`de440s.bsp` covers 1849-2150,
 32 MB). Licensed under MIT OR Apache-2.0.

package/astroceleste_engine_wasm.d.ts

@@ -16,6 +16,12 @@ export class Engine {
      * The chart of a moment and place.
      */
     chart(request: any): any;
+    /**
+     * The Chinese calendar around `utc` (ISO 8601): solar terms, lunar months and the
+     * equation of time; `null` when the loaded kernels do not cover the year or so it
+     * needs.
+     */
+    chineseCalendar(utc: string): any;
     /**
      * A chart with its electional assessment under `election_data`. `criteria` may be
      * `undefined` for the defaults.
@@ -39,10 +45,20 @@ export class Engine {
      * The sky of `request`, with its cross-aspects to `natalPlanets`.
      */
     transit(natal_planets: any, request: any): any;
+    /**
+     * The panchanga at `utc` (ISO 8601) for a place: sunrise, vara, tithi, nakshatra,
+     * yoga, karana, lunar month and year; `null` when the loaded kernels do not cover the
+     * lunar month around it.
+     */
+    vedicCalendar(utc: string, latitude: number, longitude: number): any;
     /**
      * `[firstJD, lastJD]` covered by the loaded kernels, or `undefined`.
      */
     readonly coverage: Float64Array | undefined;
+    /**
+     * The loaded kernels as `[name, firstJD, lastJD]`, in preference order.
+     */
+    readonly kernels: any;
 }
 
 /**
@@ -85,6 +101,14 @@ export function excerptKernel(kernel: Uint8Array, start_jd: number, end_jd: numb
  */
 export function julianDay(utc: string): number;
 
+/**
+ * The Vedic reading of a computed `chart` born at `birth` (ISO 8601 UTC): sidereal
+ * placements with their nakshatras, the vargas and the Vimshottari dasha. `options`:
+ * `{ ayanamsa?, outer_planets?, vargas?, hora?, dasha_year?, dasha_path?, dasha_depth?,
+ * date? }`, or `undefined` for the defaults. No kernel is needed.
+ */
+export function jyotish(chart: any, birth: string, options: any): any;
+
 /**
  * Cross-aspects from chart B's planets (overlay) to chart A's (base).
  */
@@ -116,15 +140,19 @@ export interface InitOutput {
     readonly derivedChart: (a: any, b: number, c: number, d: number) => [number, number, number];
     readonly engine_addKernel: (a: number, b: number, c: number, d: number, e: number) => [number, number];
     readonly engine_chart: (a: number, b: any) => [number, number, number];
+    readonly engine_chineseCalendar: (a: number, b: number, c: number) => [number, number, number];
     readonly engine_coverage: (a: number) => [number, number];
     readonly engine_election: (a: number, b: any, c: any) => [number, number, number];
     readonly engine_elections: (a: number, b: any, c: number, d: number, e: any) => [number, number, number];
     readonly engine_horary: (a: number, b: any) => [number, number, number];
+    readonly engine_kernels: (a: number) => [number, number, number];
     readonly engine_new: () => number;
     readonly engine_supports: (a: number, b: number) => number;
     readonly engine_transit: (a: number, b: any, c: any) => [number, number, number];
+    readonly engine_vedicCalendar: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
     readonly excerptKernel: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly julianDay: (a: number, b: number) => [number, number, number];
+    readonly jyotish: (a: any, b: number, c: number, d: any) => [number, number, number];
     readonly synastry: (a: any, b: any, c: any) => [number, number, number];
     readonly timeLords: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number];
     readonly ziWei: (a: any, b: number, c: number, d: number, e: number, f: any) => [number, number, number];

package/astroceleste_engine_wasm.js

@@ -42,6 +42,22 @@ export class Engine {
         }
         return takeFromExternrefTable0(ret[0]);
     }
+    /**
+     * The Chinese calendar around `utc` (ISO 8601): solar terms, lunar months and the
+     * equation of time; `null` when the loaded kernels do not cover the year or so it
+     * needs.
+     * @param {string} utc
+     * @returns {any}
+     */
+    chineseCalendar(utc) {
+        const ptr0 = passStringToWasm0(utc, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.engine_chineseCalendar(this.__wbg_ptr, ptr0, len0);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * `[firstJD, lastJD]` covered by the loaded kernels, or `undefined`.
      * @returns {Float64Array | undefined}
@@ -98,6 +114,17 @@ export class Engine {
         }
         return takeFromExternrefTable0(ret[0]);
     }
+    /**
+     * The loaded kernels as `[name, firstJD, lastJD]`, in preference order.
+     * @returns {any}
+     */
+    get kernels() {
+        const ret = wasm.engine_kernels(this.__wbg_ptr);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     constructor() {
         const ret = wasm.engine_new();
         this.__wbg_ptr = ret;
@@ -126,6 +153,24 @@ export class Engine {
         }
         return takeFromExternrefTable0(ret[0]);
     }
+    /**
+     * The panchanga at `utc` (ISO 8601) for a place: sunrise, vara, tithi, nakshatra,
+     * yoga, karana, lunar month and year; `null` when the loaded kernels do not cover the
+     * lunar month around it.
+     * @param {string} utc
+     * @param {number} latitude
+     * @param {number} longitude
+     * @returns {any}
+     */
+    vedicCalendar(utc, latitude, longitude) {
+        const ptr0 = passStringToWasm0(utc, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.engine_vedicCalendar(this.__wbg_ptr, ptr0, len0, latitude, longitude);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
 }
 if (Symbol.dispose) Engine.prototype[Symbol.dispose] = Engine.prototype.free;
 
@@ -245,6 +290,26 @@ export function julianDay(utc) {
     return ret[0];
 }
 
+/**
+ * The Vedic reading of a computed `chart` born at `birth` (ISO 8601 UTC): sidereal
+ * placements with their nakshatras, the vargas and the Vimshottari dasha. `options`:
+ * `{ ayanamsa?, outer_planets?, vargas?, hora?, dasha_year?, dasha_path?, dasha_depth?,
+ * date? }`, or `undefined` for the defaults. No kernel is needed.
+ * @param {any} chart
+ * @param {string} birth
+ * @param {any} options
+ * @returns {any}
+ */
+export function jyotish(chart, birth, options) {
+    const ptr0 = passStringToWasm0(birth, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.jyotish(chart, ptr0, len0, options);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * Cross-aspects from chart B's planets (overlay) to chart A's (base).
  * @param {any} chart_a_planets
@@ -308,11 +373,11 @@ export function ziWei(calendar, birth, longitude, utcOffsetMinutes, options) {
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
-        __wbg_Error_67e7344beaa85059: function(arg0, arg1) {
+        __wbg_Error_30c8987f7c2ed4e2: function(arg0, arg1) {
             const ret = Error(getStringFromWasm0(arg0, arg1));
             return ret;
         },
-        __wbg_Number_c54e7112a3fa7e3e: function(arg0) {
+        __wbg_Number_14af1003b8dd5ead: function(arg0) {
             const ret = Number(arg0);
             return ret;
         },
@@ -323,68 +388,68 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_bigint_get_as_i64_b482365c149396c8: function(arg0, arg1) {
+        __wbg___wbindgen_bigint_get_as_i64_a2383202b9353e4c: function(arg0, arg1) {
             const v = arg1;
             const ret = typeof(v) === 'bigint' ? v : undefined;
             getDataViewMemory0().setBigInt64(arg0 + 8 * 1, isLikeNone(ret) ? BigInt(0) : ret, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
         },
-        __wbg___wbindgen_boolean_get_7a12af2b3f899c5a: function(arg0) {
+        __wbg___wbindgen_boolean_get_5b446f51afd21013: function(arg0) {
             const v = arg0;
             const ret = typeof(v) === 'boolean' ? v : undefined;
             return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
         },
-        __wbg___wbindgen_debug_string_0e68cf47c9cbd9b0: function(arg0, arg1) {
+        __wbg___wbindgen_debug_string_4687d8d8c2017d52: function(arg0, arg1) {
             const ret = debugString(arg1);
             const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
             const len1 = WASM_VECTOR_LEN;
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_in_50072d4d6e45c193: function(arg0, arg1) {
+        __wbg___wbindgen_in_92f62ee1427d9e49: function(arg0, arg1) {
             const ret = arg0 in arg1;
             return ret;
         },
-        __wbg___wbindgen_is_bigint_60fc0336cb14f5d7: function(arg0) {
+        __wbg___wbindgen_is_bigint_b123553bed3bb382: function(arg0) {
             const ret = typeof(arg0) === 'bigint';
             return ret;
         },
-        __wbg___wbindgen_is_function_fcda5e3902d732fe: function(arg0) {
+        __wbg___wbindgen_is_function_1f9d30630b8b1d3d: function(arg0) {
             const ret = typeof(arg0) === 'function';
             return ret;
         },
-        __wbg___wbindgen_is_null_5160b3e381865372: function(arg0) {
+        __wbg___wbindgen_is_null_e343b7d08827ba72: function(arg0) {
             const ret = arg0 === null;
             return ret;
         },
-        __wbg___wbindgen_is_object_edb6b15aa3afe12e: function(arg0) {
+        __wbg___wbindgen_is_object_3c45d4f2dde4e749: function(arg0) {
             const val = arg0;
             const ret = typeof(val) === 'object' && val !== null;
             return ret;
         },
-        __wbg___wbindgen_is_string_c4f7cb494a2a21f1: function(arg0) {
+        __wbg___wbindgen_is_string_90b56bc79aad6f6c: function(arg0) {
             const ret = typeof(arg0) === 'string';
             return ret;
         },
-        __wbg___wbindgen_is_undefined_8c687d0b90d5b524: function(arg0) {
+        __wbg___wbindgen_is_undefined_8865fb403f8fe9d8: function(arg0) {
             const ret = arg0 === undefined;
             return ret;
         },
-        __wbg___wbindgen_jsval_eq_9fdcd3c0a860dd3b: function(arg0, arg1) {
+        __wbg___wbindgen_jsval_eq_02babf21faa37971: function(arg0, arg1) {
             const ret = arg0 === arg1;
             return ret;
         },
-        __wbg___wbindgen_jsval_loose_eq_3c30021c243b64cd: function(arg0, arg1) {
+        __wbg___wbindgen_jsval_loose_eq_677f21e468d6b461: function(arg0, arg1) {
             const ret = arg0 == arg1;
             return ret;
         },
-        __wbg___wbindgen_number_get_1dc732b810cb937c: function(arg0, arg1) {
+        __wbg___wbindgen_number_get_2e0e7dee9f701a71: function(arg0, arg1) {
             const obj = arg1;
             const ret = typeof(obj) === 'number' ? obj : undefined;
             getDataViewMemory0().setFloat64(arg0 + 8 * 1, isLikeNone(ret) ? 0 : ret, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
         },
-        __wbg___wbindgen_string_get_92ab86bb19cbc12f: function(arg0, arg1) {
+        __wbg___wbindgen_string_get_0380ccaa2f57f0d9: function(arg0, arg1) {
             const obj = arg1;
             const ret = typeof(obj) === 'string' ? obj : undefined;
             var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -392,30 +457,30 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_throw_5d9e815e6fdf150f: function(arg0, arg1) {
+        __wbg___wbindgen_throw_41e9ee4f547fc59a: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
-        __wbg_call_269c5566fbede3eb: function() { return handleError(function (arg0, arg1) {
+        __wbg_call_6137034ef55c9d0f: function() { return handleError(function (arg0, arg1) {
             const ret = arg0.call(arg1);
             return ret;
         }, arguments); },
-        __wbg_done_cffed884d87aa22e: function(arg0) {
+        __wbg_done_b41a1d26cdb37fb6: function(arg0) {
             const ret = arg0.done;
             return ret;
         },
-        __wbg_entries_972a87586902cf87: function(arg0) {
+        __wbg_entries_fb6397112b1de25f: function(arg0) {
             const ret = Object.entries(arg0);
             return ret;
         },
-        __wbg_get_6cf5a4d4d8ad3c5a: function() { return handleError(function (arg0, arg1) {
+        __wbg_get_658f6698067d9515: function() { return handleError(function (arg0, arg1) {
             const ret = Reflect.get(arg0, arg1);
             return ret;
         }, arguments); },
-        __wbg_get_b1f0ab13c737f856: function(arg0, arg1) {
+        __wbg_get_6c896e0571ddae51: function(arg0, arg1) {
             const ret = arg0[arg1 >>> 0];
             return ret;
         },
-        __wbg_get_unchecked_363572bdd397d473: function(arg0, arg1) {
+        __wbg_get_unchecked_288889d017702237: function(arg0, arg1) {
             const ret = arg0[arg1 >>> 0];
             return ret;
         },
@@ -423,7 +488,7 @@ function __wbg_get_imports() {
             const ret = arg0[arg1];
             return ret;
         },
-        __wbg_instanceof_ArrayBuffer_d4ff01f8247925ae: function(arg0) {
+        __wbg_instanceof_ArrayBuffer_a99f175873e5d9b8: function(arg0) {
             let result;
             try {
                 result = arg0 instanceof ArrayBuffer;
@@ -433,7 +498,7 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_instanceof_Map_1ff6a2b54c899f0d: function(arg0) {
+        __wbg_instanceof_Map_b2611749102d7ba3: function(arg0) {
             let result;
             try {
                 result = arg0 instanceof Map;
@@ -443,7 +508,7 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_instanceof_Uint8Array_598adc0fef426aa8: function(arg0) {
+        __wbg_instanceof_Uint8Array_828cef2aaacafc31: function(arg0) {
             let result;
             try {
                 result = arg0 instanceof Uint8Array;
@@ -453,72 +518,72 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_isArray_5674713bb7b79043: function(arg0) {
+        __wbg_isArray_e15a2ff68ffdbef2: function(arg0) {
             const ret = Array.isArray(arg0);
             return ret;
         },
-        __wbg_isSafeInteger_8f51c743827d1ec5: function(arg0) {
+        __wbg_isSafeInteger_717808ad6a54bd9e: function(arg0) {
             const ret = Number.isSafeInteger(arg0);
             return ret;
         },
-        __wbg_iterator_22ddeb808cf55a6f: function() {
+        __wbg_iterator_e3c31c892080e444: function() {
             const ret = Symbol.iterator;
             return ret;
         },
-        __wbg_length_31bdaf014f5fbde2: function(arg0) {
+        __wbg_length_7f3c00c40364105e: function(arg0) {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_length_4e1adc0d42e23620: function(arg0) {
+        __wbg_length_d4bdea10311bd9cf: function(arg0) {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_new_1da3429bc3c4541c: function(arg0) {
+        __wbg_new_1dbf7428bba60a42: function(arg0) {
             const ret = new Uint8Array(arg0);
             return ret;
         },
-        __wbg_new_8d36e20aa758e411: function() {
+        __wbg_new_28744009d011f847: function() {
             const ret = new Map();
             return ret;
         },
-        __wbg_new_a32a1ab6c6655abe: function(arg0, arg1) {
+        __wbg_new_343a093a3c2ffb4e: function(arg0, arg1) {
             const ret = new Error(getStringFromWasm0(arg0, arg1));
             return ret;
         },
-        __wbg_new_bebc3f4757acf305: function() {
+        __wbg_new_617a8cdb8bb1130e: function() {
             const ret = new Object();
             return ret;
         },
-        __wbg_new_ffa92086ea89f79c: function() {
+        __wbg_new_ee2291f50781bf1d: function() {
             const ret = new Array();
             return ret;
         },
-        __wbg_next_95053e306b1c3aed: function(arg0) {
+        __wbg_next_33784799010f1bbe: function(arg0) {
             const ret = arg0.next;
             return ret;
         },
-        __wbg_next_f31ecb8646d2c605: function() { return handleError(function (arg0) {
+        __wbg_next_f4aac29c42af995c: function() { return handleError(function (arg0) {
             const ret = arg0.next();
             return ret;
         }, arguments); },
-        __wbg_prototypesetcall_ae9f5e7459250748: function(arg0, arg1, arg2) {
+        __wbg_prototypesetcall_bc27214492979395: function(arg0, arg1, arg2) {
             Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
         },
-        __wbg_set_13d25b81ab403f5e: function(arg0, arg1, arg2) {
-            arg0[arg1 >>> 0] = arg2;
-        },
-        __wbg_set_6be42768c690e380: function(arg0, arg1, arg2) {
-            arg0[arg1] = arg2;
-        },
-        __wbg_set_a377297433dfea63: function() { return handleError(function (arg0, arg1, arg2) {
+        __wbg_set_145a351398b48c65: function() { return handleError(function (arg0, arg1, arg2) {
             const ret = Reflect.set(arg0, arg1, arg2);
             return ret;
         }, arguments); },
-        __wbg_set_bf6dde4923b9b059: function(arg0, arg1, arg2) {
+        __wbg_set_6ae97e73113c4f0b: function(arg0, arg1, arg2) {
             const ret = arg0.set(arg1, arg2);
             return ret;
         },
-        __wbg_value_c227f843d21da141: function(arg0) {
+        __wbg_set_6be42768c690e380: function(arg0, arg1, arg2) {
+            arg0[arg1] = arg2;
+        },
+        __wbg_set_bea140a88be9b277: function(arg0, arg1, arg2) {
+            arg0[arg1 >>> 0] = arg2;
+        },
+        __wbg_value_f3c585ee8f5ba40c: function(arg0) {
             const ret = arg0.value;
             return ret;
         },

package/package.json

@@ -2,7 +2,7 @@
   "name": "astroceleste-engine",
   "type": "module",
   "description": "WebAssembly bindings for astroceleste-engine",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "license": "MIT OR Apache-2.0",
   "repository": {
     "type": "git",