kaabalah 6.16.0 → 6.17.0

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 (114) hide show
  1. package/README.md +19 -6
  2. package/dist/astrology/index.d.mts +3423 -148
  3. package/dist/astrology/index.d.ts +3423 -148
  4. package/dist/astrology/index.js +849 -59
  5. package/dist/astrology/index.mjs +4 -2
  6. package/dist/{chunk-MWLSSRHL.mjs → chunk-4BKDSA7L.mjs} +3 -4
  7. package/dist/chunk-4BKDSA7L.mjs.map +1 -0
  8. package/dist/chunk-4WVN4RMM.mjs +1139 -0
  9. package/dist/chunk-4WVN4RMM.mjs.map +1 -0
  10. package/dist/{chunk-J5Y325TG.mjs → chunk-4ZFY3GBP.mjs} +2210 -3
  11. package/dist/chunk-4ZFY3GBP.mjs.map +1 -0
  12. package/dist/{chunk-LQVHJ3VY.mjs → chunk-54QDLBID.mjs} +41 -41
  13. package/dist/{chunk-LQVHJ3VY.mjs.map → chunk-54QDLBID.mjs.map} +1 -1
  14. package/dist/{chunk-PBBF5DKC.js → chunk-6SBCBVTZ.js} +21 -21
  15. package/dist/{chunk-WP5MRAYG.mjs → chunk-COEM6U4V.mjs} +3 -4
  16. package/dist/chunk-COEM6U4V.mjs.map +1 -0
  17. package/dist/{chunk-3JMY4U4S.mjs → chunk-DBRPCQRR.mjs} +245 -211
  18. package/dist/chunk-DBRPCQRR.mjs.map +1 -0
  19. package/dist/{chunk-WRF3EORB.js → chunk-DCJYTCJZ.js} +16 -17
  20. package/dist/chunk-DCJYTCJZ.js.map +1 -0
  21. package/dist/{chunk-UO2RQQZO.mjs → chunk-DK2VS36Z.mjs} +2 -2
  22. package/dist/{chunk-HEZCZXQC.js → chunk-E353GPHE.js} +16 -16
  23. package/dist/{chunk-6LZOAU6E.js → chunk-GDJSVV46.js} +272 -241
  24. package/dist/chunk-GDJSVV46.js.map +1 -0
  25. package/dist/{chunk-Z3JZ5DZN.mjs → chunk-IZBM4CPN.mjs} +2 -2
  26. package/dist/chunk-J3WVI5Y3.mjs +16280 -0
  27. package/dist/chunk-J3WVI5Y3.mjs.map +1 -0
  28. package/dist/{chunk-7OWGGDRF.js → chunk-JFRVH3TD.js} +2288 -80
  29. package/dist/chunk-JFRVH3TD.js.map +1 -0
  30. package/dist/chunk-MZBY6G5S.js +1182 -0
  31. package/dist/chunk-MZBY6G5S.js.map +1 -0
  32. package/dist/{chunk-7JWBIAUF.mjs → chunk-NS5AXNEW.mjs} +3 -3
  33. package/dist/chunk-QU4RKOBD.js +16536 -0
  34. package/dist/chunk-QU4RKOBD.js.map +1 -0
  35. package/dist/{chunk-CMXTZKWW.js → chunk-UCNBHGIY.js} +157 -157
  36. package/dist/{chunk-CMXTZKWW.js.map → chunk-UCNBHGIY.js.map} +1 -1
  37. package/dist/{chunk-BKFHIKFY.js → chunk-XRSK74V5.js} +179 -180
  38. package/dist/chunk-XRSK74V5.js.map +1 -0
  39. package/dist/{chunk-2IC6H3FI.js → chunk-YVLKVB6W.js} +52 -52
  40. package/dist/cli.js +27609 -11656
  41. package/dist/cli.js.map +1 -1
  42. package/dist/core/index.js +56 -57
  43. package/dist/core/index.mjs +2 -3
  44. package/dist/core-B3_-9yli.d.mts +279 -0
  45. package/dist/core-cWIQtely.d.ts +279 -0
  46. package/dist/gematria/index.js +7 -8
  47. package/dist/gematria/index.mjs +2 -3
  48. package/dist/iching/index.d.mts +37 -37
  49. package/dist/iching/index.d.ts +37 -37
  50. package/dist/iching/index.js +46 -47
  51. package/dist/iching/index.mjs +3 -4
  52. package/dist/index.d.mts +139 -2
  53. package/dist/index.d.ts +139 -2
  54. package/dist/index.js +1422 -301
  55. package/dist/index.js.map +1 -1
  56. package/dist/index.mjs +190 -10
  57. package/dist/index.mjs.map +1 -1
  58. package/dist/numerology/index.d.mts +437 -252
  59. package/dist/numerology/index.d.ts +437 -252
  60. package/dist/numerology/index.js +108 -28
  61. package/dist/numerology/index.mjs +4 -4
  62. package/dist/schedule-types-DsR1_guG.d.mts +200 -0
  63. package/dist/schedule-types-DsR1_guG.d.ts +200 -0
  64. package/dist/semantic/index.d.mts +10 -9
  65. package/dist/semantic/index.d.ts +10 -9
  66. package/dist/semantic/index.js +41 -41
  67. package/dist/semantic/index.mjs +8 -8
  68. package/dist/swisseph.node-734BKSOZ.js +10 -0
  69. package/dist/swisseph.node-734BKSOZ.js.map +1 -0
  70. package/dist/swisseph.node-TDPYTBSS.mjs +8 -0
  71. package/dist/swisseph.node-TDPYTBSS.mjs.map +1 -0
  72. package/dist/tarot/index.js +30 -31
  73. package/dist/tarot/index.mjs +3 -4
  74. package/dist/visual/index.d.mts +1 -0
  75. package/dist/visual/index.d.ts +1 -0
  76. package/dist/visual/index.js +46 -47
  77. package/dist/visual/index.mjs +3 -4
  78. package/dist/wasm/build/swisseph.node-734BKSOZ.js +10 -0
  79. package/dist/wasm/build/swisseph.node-734BKSOZ.js.map +1 -0
  80. package/dist/wasm/build/swisseph.node-TDPYTBSS.mjs +8 -0
  81. package/dist/wasm/build/swisseph.node-TDPYTBSS.mjs.map +1 -0
  82. package/package.json +4 -2
  83. package/dist/chunk-3JMY4U4S.mjs.map +0 -1
  84. package/dist/chunk-3QN5V3DP.js +0 -4737
  85. package/dist/chunk-3QN5V3DP.js.map +0 -1
  86. package/dist/chunk-6LZOAU6E.js.map +0 -1
  87. package/dist/chunk-7OWGGDRF.js.map +0 -1
  88. package/dist/chunk-BKFHIKFY.js.map +0 -1
  89. package/dist/chunk-IT7GZ337.mjs +0 -4679
  90. package/dist/chunk-IT7GZ337.mjs.map +0 -1
  91. package/dist/chunk-J5Y325TG.mjs.map +0 -1
  92. package/dist/chunk-JY4QC6FR.js +0 -2214
  93. package/dist/chunk-JY4QC6FR.js.map +0 -1
  94. package/dist/chunk-MWLSSRHL.mjs.map +0 -1
  95. package/dist/chunk-RUE6NTVT.mjs +0 -2211
  96. package/dist/chunk-RUE6NTVT.mjs.map +0 -1
  97. package/dist/chunk-WP5MRAYG.mjs.map +0 -1
  98. package/dist/chunk-WRF3EORB.js.map +0 -1
  99. package/dist/swisseph.node-53QCJWTI.mjs +0 -3471
  100. package/dist/swisseph.node-53QCJWTI.mjs.map +0 -1
  101. package/dist/swisseph.node-CGBZTQ5N.js +0 -3473
  102. package/dist/swisseph.node-CGBZTQ5N.js.map +0 -1
  103. package/dist/swisseph.node-GPVFDOB6.wasm +0 -0
  104. package/dist/wasm/build/swisseph.node-53QCJWTI.mjs +0 -3471
  105. package/dist/wasm/build/swisseph.node-53QCJWTI.mjs.map +0 -1
  106. package/dist/wasm/build/swisseph.node-CGBZTQ5N.js +0 -3473
  107. package/dist/wasm/build/swisseph.node-CGBZTQ5N.js.map +0 -1
  108. package/dist/wasm/build/swisseph.node-GPVFDOB6.wasm +0 -0
  109. /package/dist/{chunk-PBBF5DKC.js.map → chunk-6SBCBVTZ.js.map} +0 -0
  110. /package/dist/{chunk-2IC6H3FI.js.map → chunk-DK2VS36Z.mjs.map} +0 -0
  111. /package/dist/{chunk-7JWBIAUF.mjs.map → chunk-E353GPHE.js.map} +0 -0
  112. /package/dist/{chunk-Z3JZ5DZN.mjs.map → chunk-IZBM4CPN.mjs.map} +0 -0
  113. /package/dist/{chunk-HEZCZXQC.js.map → chunk-NS5AXNEW.mjs.map} +0 -0
  114. /package/dist/{chunk-UO2RQQZO.mjs.map → chunk-YVLKVB6W.js.map} +0 -0
package/README.md CHANGED
@@ -25,8 +25,8 @@ All modules are tree-shakable and can be imported independently:
25
25
  | Module | Import | Description |
26
26
  |--------|--------|-------------|
27
27
  | Core | `kaabalah/core` | Tree of Life graph with cross-system correspondences |
28
- | Numerology | `kaabalah/numerology` | Life path, cycles, challenges, personal year |
29
- | Astrology | `kaabalah/astrology` | Birth charts, synastry, composite, transits, solar returns, profections, firdaria, astrocartography, dignity, decans, dodecatemoria |
28
+ | Numerology | `kaabalah/numerology` | Life path, cycles, challenges, personal year, dated schedules (as-of snapshots and timelines from civil dates), partial birth dates, pinnacles |
29
+ | Astrology | `kaabalah/astrology` | Birth charts, sect and lots, synastry, composite and Davison, exact transit and return events, progressions, profections, firdaria, orb policies, input quality, bulk collections, Jyotish (Dhruva and Lahiri nakshatras, dashas), astrocartography, dignity, decans, dodecatemoria |
30
30
  | Gematria | `kaabalah/gematria` | Hebrew letter numerology |
31
31
  | Tarot | `kaabalah/tarot` | 78-card deck with profiles, archetypes, correspondences, multi-deck images, spread engine |
32
32
  | I Ching | `kaabalah/iching` | 64 hexagrams, classical Chinese and original English, Han technical derivations, tree-backed Kaabalah, coin casting |
@@ -34,12 +34,16 @@ All modules are tree-shakable and can be imported independently:
34
34
  | Semantic | `kaabalah/semantic` | Theme profiles, kaabalistic overlay correspondences, symbol metadata |
35
35
  | Visual | `kaabalah/visual` | Tree of Life and astrology wheel SVG generation plus layout/render-model data |
36
36
 
37
+ Civil-date helpers (`parseCivilDate`, `completedYears`, ...) and JSON/Markdown tabulation helpers (`toTable`, `toMarkdownTable`) are exported from the package root `kaabalah`.
38
+
39
+ The Swiss Ephemeris runtime assets are also exported for bundlers and servers: `kaabalah/swisseph-runtime` (JS) and `kaabalah/swisseph-wasm` (WebAssembly). See the [WebAssembly guide](https://docs.kaabalah.com/guides/webassembly/).
40
+
37
41
  ## Quick Example
38
42
 
39
43
  ```typescript
40
44
  import { createTree, id, KaabalahTypes } from 'kaabalah/core';
41
45
  import { getBirthChart } from 'kaabalah/astrology';
42
- import { calculateKaabalisticLifePath } from 'kaabalah/numerology';
46
+ import { calculateKaabalisticLifePath, getNumerologySnapshot } from 'kaabalah/numerology';
43
47
  import { getTarotCorrespondenceProfile } from 'kaabalah/tarot';
44
48
  import { generateAstroWheelSvg, generateTreeSvg } from 'kaabalah/visual';
45
49
 
@@ -51,7 +55,8 @@ const chart = await getBirthChart({
51
55
  latitude: 48.856, longitude: 2.352,
52
56
  });
53
57
 
54
- const lifePath = calculateKaabalisticLifePath(new Date('1990-06-15'));
58
+ const lifePath = calculateKaabalisticLifePath(new Date(1990, 5, 15, 12)); // legacy Date API: local noon
59
+ const asOf = getNumerologySnapshot({ birth: '1990-06-15', asOf: '2026-01-01' }); // civil dates: no timezone workaround
55
60
  const magician = getTarotCorrespondenceProfile({ tarotCardName: 'The Magician' });
56
61
  const svg = generateTreeSvg({ background: 'transparent', palette: 'monochrome' });
57
62
  const wheelSvg = generateAstroWheelSvg(chart, { background: 'transparent' });
@@ -81,7 +86,7 @@ getTarotCardProfile({ tarotCardNumber: 20 }, 'pt-BR')?.tarotMeaning;
81
86
  getIChingReadingContent('879777', 'pt-BR').oracle[0].text.content;
82
87
  ```
83
88
 
84
- See [Portuguese text APIs](docs/localization/pt-BR-api.md) for card/deck descriptions, spreads, numerology, gematria, tree descriptions, astrology labels and CLI language selection.
89
+ See [Portuguese text APIs](https://docs.kaabalah.com/guides/localization/) for card/deck descriptions, spreads, numerology, gematria, tree descriptions, astrology labels and CLI language selection.
85
90
 
86
91
  ## CLI
87
92
 
@@ -92,13 +97,21 @@ npx kaabalah help --language pt-BR # Portuguese help
92
97
  npx kaabalah iching:reading --lines 879777 --json --compact
93
98
  npx kaabalah iching:hexagram 25 --json --compact
94
99
  npx kaabalah iching:cast --json --compact
100
+ npx kaabalah tarot:spread --spread-id=celtic-cross --json --compact
101
+ npx kaabalah tree:topology --route=lightning --json --compact
95
102
  npx kaabalah numerology 1990-01-15 --json --compact
103
+ npx kaabalah numerology:snapshot 1990-01-15 Ana --as-of=2026-03-01 --json --compact
104
+ npx kaabalah numerology:timeline 1990-01-15 --from=2026-01-01 --to=2027-01-01 --layers=personal-month --json --compact
96
105
  npx kaabalah astrology 1990-01-15 14:30 --lat=40.71 --lon=-74 --json
106
+ npx kaabalah astrology 1990-01-15 --quality=untimed --lat=40.71 --lon=-74 --json --compact --fields=status,moonDayRange
107
+ npx kaabalah astrology:jyotish 1990-01-15 14:30 --lat=40.71 --lon=-74 --frame=lahiri --as-of=2026-03-01 --json --compact --fields=activeDasha
108
+ npx kaabalah astrology:collection --manifest=people.json --json --compact --fields=summary
109
+ npx kaabalah capabilities --json --compact
97
110
  npx kaabalah astrology:wheel 1990-01-15 14:30 --lat=40.71 --lon=-74 --json --compact --fields=svg
98
111
  npx kaabalah tree:node "tarotArkAnnu:The Magician" --depth=2 --json
99
112
  ```
100
113
 
101
- Run `kaabalah help --json` to discover commands and schemas. See the [CLI Reference](https://docs.kaabalah.com/getting-started/cli/) for the full list.
114
+ Dates are real calendar days (`YYYY-MM-DD`, years 0001-9999): `2026-02-30` exits with `INVALID_DATE`. Calculations are deterministic except random draws (`tarot`, `tarot:spread --spread-id`, `iching:cast`), geocoding, and commands that default to today. `--as-of` pins the evaluation date of numerology commands; `astrology:collection --ndjson` is the only streaming (non-single-document) mode. Run `kaabalah help --json` to discover commands and schemas. See the [CLI Reference](https://docs.kaabalah.com/getting-started/cli/) for the full list.
102
115
 
103
116
  ## Support
104
117