kaabalah 6.3.0 → 6.4.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.
package/README.md CHANGED
@@ -188,6 +188,46 @@ const houseProfiles = listHouseThemeProfiles();
188
188
  Semantic profiles are deterministic, library-owned metadata layered on top of canonical correspondences. Downstream apps should consume the profile `id`, `houseNumber` or `cardNumber`, `keywords`, `tokens`, and grouped `correspondences`, while keeping scoring, ranking, and UI presentation app-side.
189
189
  For houses, `primaryLabel` is the semantic life-area label and `houseLabel` preserves the structural astrological label (`Ascendant`, `Imum Coeli`, `Descendant`, `Medium Coeli`, etc.).
190
190
 
191
+ ### Kaabalistic Overlay Correspondences
192
+
193
+ ```typescript
194
+ import {
195
+ buildKaabalisticMapData,
196
+ getAstrologyTreeMarkers,
197
+ getKaabalisticCorrespondenceTargets,
198
+ getPlanetSymbolMetadata,
199
+ getZodiacSignSymbolMetadata
200
+ } from "kaabalah/semantic";
201
+
202
+ const signTargets = getKaabalisticCorrespondenceTargets({
203
+ kind: "sign",
204
+ sign: "Libra"
205
+ });
206
+
207
+ const sunSymbol = getPlanetSymbolMetadata("Sun");
208
+ const libraSymbol = getZodiacSignSymbolMetadata("Libra");
209
+
210
+ const astrologyMarkers = getAstrologyTreeMarkers({
211
+ planets,
212
+ nodes,
213
+ houses,
214
+ });
215
+
216
+ const mapData = buildKaabalisticMapData({
217
+ astrology: { planets, nodes, houses },
218
+ numerology: birthDate,
219
+ gematria: name,
220
+ });
221
+ ```
222
+
223
+ Use these semantic helpers when the app needs canonical overlay inputs for a Tree of Life view:
224
+
225
+ - `getKaabalisticCorrespondenceTargets(...)` returns typed sphere/path targets for a sign, planet-in-sign, angle, node, number, or Hebrew letter.
226
+ - `getAstrologyTreeMarkers(...)`, `getNumerologyTreeMarkers(...)`, and `getGematriaTreeMarkers(...)` return render-ready marker descriptors with no layout coordinates.
227
+ - `buildKaabalisticMapData(...)` combines markers, grouped target counts, and item-to-target summaries for mixed astrology/numerology/gematria map views.
228
+
229
+ The rendering layer should stay thin: ask `kaabalah/semantic` for correspondences or marker descriptors, then place them with `getTreeLayout()` from `kaabalah/visual`.
230
+
191
231
  ### Canonical Tree SVG Rendering
192
232
 
193
233
  ```typescript
@@ -302,6 +342,7 @@ kaabalah astrology:composite --input-json=- --json < composite.json
302
342
  kaabalah tree:node path:1 --json
303
343
  kaabalah tree:node "tarotArkAnnu:The Magician" --depth=2 --json
304
344
  kaabalah tree:node sphere:Kether --type=tarotArkAnnu --json
345
+ kaabalah tree:node westernZodiacSign:Libra --depth=2 --json --fields=correspondenceMap.sphere,correspondenceMap.path,correspondenceMap.westernElement
305
346
  ```
306
347
 
307
348
  ### Global Flags