kaabalah 6.15.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 (141) hide show
  1. package/README.md +33 -5
  2. package/dist/astrology/index.d.mts +3457 -144
  3. package/dist/astrology/index.d.ts +3457 -144
  4. package/dist/astrology/index.js +865 -53
  5. package/dist/astrology/index.mjs +5 -1
  6. package/dist/{chunk-CFNMEJTR.mjs → chunk-4BKDSA7L.mjs} +625 -166
  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-NOZKIUGP.mjs → chunk-4ZFY3GBP.mjs} +2296 -1024
  11. package/dist/chunk-4ZFY3GBP.mjs.map +1 -0
  12. package/dist/{chunk-OTSJWMWK.mjs → chunk-54QDLBID.mjs} +446 -43
  13. package/dist/chunk-54QDLBID.mjs.map +1 -0
  14. package/dist/{chunk-CW6QDSMF.js → chunk-6SBCBVTZ.js} +88 -21
  15. package/dist/chunk-6SBCBVTZ.js.map +1 -0
  16. package/dist/{chunk-2WCC2KCJ.js → chunk-BALOSCWQ.mjs} +22 -3
  17. package/dist/chunk-BALOSCWQ.mjs.map +1 -0
  18. package/dist/{chunk-ICEVPLT4.mjs → chunk-COEM6U4V.mjs} +2313 -4
  19. package/dist/chunk-COEM6U4V.mjs.map +1 -0
  20. package/dist/chunk-DBRPCQRR.mjs +1398 -0
  21. package/dist/chunk-DBRPCQRR.mjs.map +1 -0
  22. package/dist/{chunk-XHITSUSQ.js → chunk-DCJYTCJZ.js} +2329 -14
  23. package/dist/chunk-DCJYTCJZ.js.map +1 -0
  24. package/dist/{chunk-X5HGLMEF.mjs → chunk-DK2VS36Z.mjs} +770 -3
  25. package/dist/chunk-DK2VS36Z.mjs.map +1 -0
  26. package/dist/{chunk-6GDEXIDI.js → chunk-E353GPHE.js} +25 -22
  27. package/dist/chunk-E353GPHE.js.map +1 -0
  28. package/dist/chunk-GDJSVV46.js +1413 -0
  29. package/dist/chunk-GDJSVV46.js.map +1 -0
  30. package/dist/chunk-ICUDGCYX.js +15 -0
  31. package/dist/chunk-ICUDGCYX.js.map +1 -0
  32. package/dist/{chunk-OSMB2MJR.mjs → chunk-IZBM4CPN.mjs} +68 -3
  33. package/dist/chunk-IZBM4CPN.mjs.map +1 -0
  34. package/dist/chunk-J3WVI5Y3.mjs +16280 -0
  35. package/dist/chunk-J3WVI5Y3.mjs.map +1 -0
  36. package/dist/{chunk-Q7YAKPBH.js → chunk-JFRVH3TD.js} +2296 -1023
  37. package/dist/chunk-JFRVH3TD.js.map +1 -0
  38. package/dist/{chunk-URDMOQRN.mjs → chunk-L5EYUE4B.js} +27 -2
  39. package/dist/chunk-L5EYUE4B.js.map +1 -0
  40. package/dist/chunk-MZBY6G5S.js +1182 -0
  41. package/dist/chunk-MZBY6G5S.js.map +1 -0
  42. package/dist/{chunk-LXJ3THNW.mjs → chunk-NS5AXNEW.mjs} +12 -9
  43. package/dist/chunk-NS5AXNEW.mjs.map +1 -0
  44. package/dist/chunk-QU4RKOBD.js +16536 -0
  45. package/dist/chunk-QU4RKOBD.js.map +1 -0
  46. package/dist/{chunk-SXARKCYN.js → chunk-UCNBHGIY.js} +566 -158
  47. package/dist/chunk-UCNBHGIY.js.map +1 -0
  48. package/dist/chunk-W2N7STO3.mjs +13 -0
  49. package/dist/chunk-W2N7STO3.mjs.map +1 -0
  50. package/dist/{chunk-RQLHFFXR.js → chunk-XRSK74V5.js} +644 -185
  51. package/dist/chunk-XRSK74V5.js.map +1 -0
  52. package/dist/chunk-YVLKVB6W.js +1600 -0
  53. package/dist/chunk-YVLKVB6W.js.map +1 -0
  54. package/dist/cli.js +50087 -23140
  55. package/dist/cli.js.map +1 -1
  56. package/dist/core/index.d.mts +24 -1
  57. package/dist/core/index.d.ts +24 -1
  58. package/dist/core/index.js +66 -53
  59. package/dist/core/index.mjs +3 -2
  60. package/dist/core-B3_-9yli.d.mts +279 -0
  61. package/dist/core-cWIQtely.d.ts +279 -0
  62. package/dist/gematria/index.d.mts +153 -1
  63. package/dist/gematria/index.d.ts +153 -1
  64. package/dist/gematria/index.js +14 -5
  65. package/dist/gematria/index.mjs +3 -2
  66. package/dist/iching/index.d.mts +782 -25
  67. package/dist/iching/index.d.ts +782 -25
  68. package/dist/iching/index.js +65 -40
  69. package/dist/iching/index.mjs +4 -3
  70. package/dist/ifa/index.d.mts +44 -1
  71. package/dist/ifa/index.d.ts +44 -1
  72. package/dist/ifa/index.js +11 -2
  73. package/dist/ifa/index.mjs +2 -1
  74. package/dist/index.d.mts +144 -7
  75. package/dist/index.d.ts +144 -7
  76. package/dist/index.js +1599 -376
  77. package/dist/index.js.map +1 -1
  78. package/dist/index.mjs +192 -10
  79. package/dist/index.mjs.map +1 -1
  80. package/dist/numerology/index.d.mts +1296 -240
  81. package/dist/numerology/index.d.ts +1296 -240
  82. package/dist/numerology/index.js +113 -23
  83. package/dist/numerology/index.mjs +5 -3
  84. package/dist/schedule-types-DsR1_guG.d.mts +200 -0
  85. package/dist/schedule-types-DsR1_guG.d.ts +200 -0
  86. package/dist/semantic/index.d.mts +94 -16
  87. package/dist/semantic/index.d.ts +94 -16
  88. package/dist/semantic/index.js +57 -35
  89. package/dist/semantic/index.mjs +9 -7
  90. package/dist/swisseph.node-734BKSOZ.js +10 -0
  91. package/dist/swisseph.node-734BKSOZ.js.map +1 -0
  92. package/dist/swisseph.node-TDPYTBSS.mjs +8 -0
  93. package/dist/swisseph.node-TDPYTBSS.mjs.map +1 -0
  94. package/dist/tarot/index.d.mts +9 -4
  95. package/dist/tarot/index.d.ts +9 -4
  96. package/dist/tarot/index.js +31 -30
  97. package/dist/tarot/index.mjs +4 -3
  98. package/dist/visual/index.d.mts +1 -0
  99. package/dist/visual/index.d.ts +1 -0
  100. package/dist/visual/index.js +47 -46
  101. package/dist/visual/index.mjs +4 -3
  102. package/dist/wasm/build/swisseph.node-734BKSOZ.js +10 -0
  103. package/dist/wasm/build/swisseph.node-734BKSOZ.js.map +1 -0
  104. package/dist/wasm/build/swisseph.node-TDPYTBSS.mjs +8 -0
  105. package/dist/wasm/build/swisseph.node-TDPYTBSS.mjs.map +1 -0
  106. package/package.json +10 -4
  107. package/dist/chunk-2WCC2KCJ.js.map +0 -1
  108. package/dist/chunk-47BAJUYW.js +0 -830
  109. package/dist/chunk-47BAJUYW.js.map +0 -1
  110. package/dist/chunk-6GDEXIDI.js.map +0 -1
  111. package/dist/chunk-CFNMEJTR.mjs.map +0 -1
  112. package/dist/chunk-CW6QDSMF.js.map +0 -1
  113. package/dist/chunk-ICEVPLT4.mjs.map +0 -1
  114. package/dist/chunk-LXJ3THNW.mjs.map +0 -1
  115. package/dist/chunk-NOZKIUGP.mjs.map +0 -1
  116. package/dist/chunk-OSMB2MJR.mjs.map +0 -1
  117. package/dist/chunk-OTSJWMWK.mjs.map +0 -1
  118. package/dist/chunk-PEHDLSUH.mjs +0 -2227
  119. package/dist/chunk-PEHDLSUH.mjs.map +0 -1
  120. package/dist/chunk-Q7YAKPBH.js.map +0 -1
  121. package/dist/chunk-RAQDVWNK.mjs +0 -821
  122. package/dist/chunk-RAQDVWNK.mjs.map +0 -1
  123. package/dist/chunk-RQLHFFXR.js.map +0 -1
  124. package/dist/chunk-SWWLTDR6.js +0 -2280
  125. package/dist/chunk-SWWLTDR6.js.map +0 -1
  126. package/dist/chunk-SXARKCYN.js.map +0 -1
  127. package/dist/chunk-UNXDDLZS.js +0 -837
  128. package/dist/chunk-UNXDDLZS.js.map +0 -1
  129. package/dist/chunk-URDMOQRN.mjs.map +0 -1
  130. package/dist/chunk-X5HGLMEF.mjs.map +0 -1
  131. package/dist/chunk-XHITSUSQ.js.map +0 -1
  132. package/dist/swisseph.node-53QCJWTI.mjs +0 -3471
  133. package/dist/swisseph.node-53QCJWTI.mjs.map +0 -1
  134. package/dist/swisseph.node-CGBZTQ5N.js +0 -3473
  135. package/dist/swisseph.node-CGBZTQ5N.js.map +0 -1
  136. package/dist/swisseph.node-GPVFDOB6.wasm +0 -0
  137. package/dist/wasm/build/swisseph.node-53QCJWTI.mjs +0 -3471
  138. package/dist/wasm/build/swisseph.node-53QCJWTI.mjs.map +0 -1
  139. package/dist/wasm/build/swisseph.node-CGBZTQ5N.js +0 -3473
  140. package/dist/wasm/build/swisseph.node-CGBZTQ5N.js.map +0 -1
  141. package/dist/wasm/build/swisseph.node-GPVFDOB6.wasm +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' });
@@ -69,21 +74,44 @@ const cast = castThreeCoins(); // inject an RNG for reproducible tests
69
74
 
70
75
  Store the six cast lines; derive the cast, moving lines, transformed and nuclear figures, palace, 納甲, 六親, 世/應 relations, line transforms, Zhu Xi texts, sovereign months, and separate Kaabalah gate/family/pillar layers. Static casts have a null transformed state. With six moving lines, 乾 uses 用九 and 坤 uses 用六. Transform `after` relatives use the destination palace; `afterInCastPalace` provides the original palace frame. See the [I Ching API and source notes](src/iching/README.md).
71
76
 
77
+ ## Language
78
+
79
+ English is the default. Pass `'pt-BR'` to localized text getters:
80
+
81
+ ```ts
82
+ import { getTarotCardProfile } from 'kaabalah/tarot';
83
+ import { getIChingReadingContent } from 'kaabalah/iching';
84
+
85
+ getTarotCardProfile({ tarotCardNumber: 20 }, 'pt-BR')?.tarotMeaning;
86
+ getIChingReadingContent('879777', 'pt-BR').oracle[0].text.content;
87
+ ```
88
+
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.
90
+
72
91
  ## CLI
73
92
 
74
93
  ```bash
75
94
  npx kaabalah help # list all commands
76
95
  npx kaabalah help --json # full schema introspection
96
+ npx kaabalah help --language pt-BR # Portuguese help
77
97
  npx kaabalah iching:reading --lines 879777 --json --compact
78
98
  npx kaabalah iching:hexagram 25 --json --compact
79
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
80
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
81
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
82
110
  npx kaabalah astrology:wheel 1990-01-15 14:30 --lat=40.71 --lon=-74 --json --compact --fields=svg
83
111
  npx kaabalah tree:node "tarotArkAnnu:The Magician" --depth=2 --json
84
112
  ```
85
113
 
86
- 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.
87
115
 
88
116
  ## Support
89
117