kaabalah 5.5.0 → 5.6.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 (54) hide show
  1. package/README.md +25 -0
  2. package/dist/{chunk-T67M2WBD.js → chunk-3HYK4Q4B.js} +263 -50
  3. package/dist/chunk-3HYK4Q4B.js.map +1 -0
  4. package/dist/{chunk-5ID55YUP.mjs → chunk-3SFBJHP2.mjs} +3 -3
  5. package/dist/{chunk-5ID55YUP.mjs.map → chunk-3SFBJHP2.mjs.map} +1 -1
  6. package/dist/chunk-4NMXTZX4.mjs +525 -0
  7. package/dist/chunk-4NMXTZX4.mjs.map +1 -0
  8. package/dist/{chunk-ZZ3YMT2R.js → chunk-EVQ432JA.js} +23 -23
  9. package/dist/{chunk-ZZ3YMT2R.js.map → chunk-EVQ432JA.js.map} +1 -1
  10. package/dist/{chunk-2J6CVLH2.mjs → chunk-IHQPXEB7.mjs} +263 -51
  11. package/dist/chunk-IHQPXEB7.mjs.map +1 -0
  12. package/dist/{chunk-M7XQFDS4.mjs → chunk-OGWTKRJK.js} +236 -43
  13. package/dist/chunk-OGWTKRJK.js.map +1 -0
  14. package/dist/{chunk-XSAXO3D2.mjs → chunk-S6BFRUJQ.mjs} +3 -3
  15. package/dist/{chunk-XSAXO3D2.mjs.map → chunk-S6BFRUJQ.mjs.map} +1 -1
  16. package/dist/{chunk-G5BG73Y5.js → chunk-U3JFWP24.mjs} +225 -46
  17. package/dist/chunk-U3JFWP24.mjs.map +1 -0
  18. package/dist/chunk-XB6PXEKO.js +529 -0
  19. package/dist/chunk-XB6PXEKO.js.map +1 -0
  20. package/dist/{chunk-2WENLHIP.js → chunk-XTVGQXCL.js} +4 -4
  21. package/dist/{chunk-2WENLHIP.js.map → chunk-XTVGQXCL.js.map} +1 -1
  22. package/dist/cli.js +1061 -126
  23. package/dist/cli.js.map +1 -1
  24. package/dist/{registry-DOiHyH-r.d.mts → constants-DbFwuCjR.d.mts} +1 -177
  25. package/dist/{registry-DOiHyH-r.d.ts → constants-DbFwuCjR.d.ts} +1 -177
  26. package/dist/core/index.d.mts +66 -3
  27. package/dist/core/index.d.ts +66 -3
  28. package/dist/core/index.js +55 -39
  29. package/dist/core/index.mjs +2 -2
  30. package/dist/correspondence-model-D8c42J4c.d.mts +281 -0
  31. package/dist/correspondence-model-DhmBYoMf.d.ts +281 -0
  32. package/dist/gematria/index.d.mts +2 -1
  33. package/dist/gematria/index.d.ts +2 -1
  34. package/dist/gematria/index.js +5 -5
  35. package/dist/gematria/index.mjs +2 -2
  36. package/dist/index.d.mts +4 -3
  37. package/dist/index.d.ts +4 -3
  38. package/dist/index.js +111 -71
  39. package/dist/index.mjs +5 -5
  40. package/dist/numerology/index.js +18 -18
  41. package/dist/numerology/index.mjs +3 -3
  42. package/dist/tarot/index.d.mts +64 -2
  43. package/dist/tarot/index.d.ts +64 -2
  44. package/dist/tarot/index.js +30 -4
  45. package/dist/tarot/index.mjs +3 -1
  46. package/package.json +1 -1
  47. package/dist/chunk-2J6CVLH2.mjs.map +0 -1
  48. package/dist/chunk-AD7T42HJ.js +0 -4
  49. package/dist/chunk-AD7T42HJ.js.map +0 -1
  50. package/dist/chunk-G5BG73Y5.js.map +0 -1
  51. package/dist/chunk-M7XQFDS4.mjs.map +0 -1
  52. package/dist/chunk-RFSO3JRG.mjs +0 -3
  53. package/dist/chunk-RFSO3JRG.mjs.map +0 -1
  54. package/dist/chunk-T67M2WBD.js.map +0 -1
package/README.md CHANGED
@@ -72,6 +72,31 @@ const gematriaValue = calculateGematria('kaabalah');
72
72
  const spread = getRandomSpread(3, true);
73
73
  ```
74
74
 
75
+ ### Canonical Tarot Image Resolution
76
+
77
+ ```typescript
78
+ import { id, KaabalahTypes } from "kaabalah/core";
79
+ import {
80
+ getTarotArchetype,
81
+ getTarotRepresentation,
82
+ resolveTarotImageUrl
83
+ } from "kaabalah/tarot";
84
+
85
+ const archetype = getTarotArchetype({
86
+ pathId: id(KaabalahTypes.PATH, 2)
87
+ });
88
+
89
+ const riderWaite = getTarotRepresentation({ pathSlug: "beth" }, "rider-waite");
90
+ const papusImageUrl = resolveTarotImageUrl(
91
+ { tarotCardFilename: "02_the_high_priestess" },
92
+ "papus_pt"
93
+ );
94
+
95
+ // Persist the canonical archetype ID (for example `path:2`), not the image URL.
96
+ ```
97
+
98
+ The tarot resolver currently supports major-card archetypes only. Use `path:<1-22>` as the canonical persisted key, and treat path slugs, major-card filenames, and major-card numbers as lookup aliases.
99
+
75
100
  ## CLI
76
101
 
77
102
  Kaabalah includes a command-line interface for quick calculations without writing code.
@@ -964,7 +964,7 @@ var TAROT_ARKANNUS_DATA = {
964
964
  meaning: "Commencement of an enterprise."
965
965
  },
966
966
  KIER_EGYPTIAN: {
967
- name: "The Unexpected"
967
+ name: "Initiation"
968
968
  }
969
969
  }
970
970
  },
@@ -981,7 +981,7 @@ var TAROT_ARKANNUS_DATA = {
981
981
  meaning: "Opposition to the commencement of the enterprise. The enterprise is commenced when an unexpected obstacle suddenly prevents its execution."
982
982
  },
983
983
  KIER_EGYPTIAN: {
984
- name: "Uncertainty"
984
+ name: "Desolation"
985
985
  }
986
986
  }
987
987
  },
@@ -998,7 +998,7 @@ var TAROT_ARKANNUS_DATA = {
998
998
  meaning: "Realization of the commencement of the enterprise. The basis of the work is now definitely established, and the undertaking can be fearlessly continued."
999
999
  },
1000
1000
  KIER_EGYPTIAN: {
1001
- name: "Domesticity"
1001
+ name: "Innovation"
1002
1002
  }
1003
1003
  }
1004
1004
  },
@@ -1015,7 +1015,7 @@ var TAROT_ARKANNUS_DATA = {
1015
1015
  meaning: "Obstacles to the enterprise."
1016
1016
  },
1017
1017
  KIER_EGYPTIAN: {
1018
- name: "Exchange"
1018
+ name: "Alliance"
1019
1019
  }
1020
1020
  }
1021
1021
  },
@@ -1032,7 +1032,7 @@ var TAROT_ARKANNUS_DATA = {
1032
1032
  meaning: "Opposition to the obstacles. Victory after surmounting them."
1033
1033
  },
1034
1034
  KIER_EGYPTIAN: {
1035
- name: "Impediment"
1035
+ name: "Magnificence"
1036
1036
  }
1037
1037
  }
1038
1038
  },
@@ -1049,7 +1049,7 @@ var TAROT_ARKANNUS_DATA = {
1049
1049
  meaning: "Realization of the opposition. At last the obstacles succeed. Failure of the enterprise in the midst of its execution."
1050
1050
  },
1051
1051
  KIER_EGYPTIAN: {
1052
- name: "Magnificence"
1052
+ name: "Impediment"
1053
1053
  }
1054
1054
  }
1055
1055
  },
@@ -1066,7 +1066,7 @@ var TAROT_ARKANNUS_DATA = {
1066
1066
  meaning: "Certain success to the enterprise."
1067
1067
  },
1068
1068
  KIER_EGYPTIAN: {
1069
- name: "Alliance"
1069
+ name: "Exchange"
1070
1070
  }
1071
1071
  }
1072
1072
  },
@@ -1083,7 +1083,7 @@ var TAROT_ARKANNUS_DATA = {
1083
1083
  meaning: "Opposition to its success. The enterprise will only partially succeed."
1084
1084
  },
1085
1085
  KIER_EGYPTIAN: {
1086
- name: "Innovation"
1086
+ name: "Domesticity"
1087
1087
  }
1088
1088
  }
1089
1089
  },
@@ -1100,7 +1100,7 @@ var TAROT_ARKANNUS_DATA = {
1100
1100
  meaning: "Realization of success. Success is continued."
1101
1101
  },
1102
1102
  KIER_EGYPTIAN: {
1103
- name: "Desolation"
1103
+ name: "Uncertainty"
1104
1104
  }
1105
1105
  }
1106
1106
  },
@@ -1117,7 +1117,7 @@ var TAROT_ARKANNUS_DATA = {
1117
1117
  meaning: "Uncertainty in the management of the enterprise."
1118
1118
  },
1119
1119
  KIER_EGYPTIAN: {
1120
- name: "Initiation"
1120
+ name: "The Unexpected"
1121
1121
  }
1122
1122
  }
1123
1123
  },
@@ -1202,7 +1202,7 @@ var TAROT_ARKANNUS_DATA = {
1202
1202
  meaning: "Commencement of a love affair."
1203
1203
  },
1204
1204
  KIER_EGYPTIAN: {
1205
- name: "Dissension"
1205
+ name: "Attraction"
1206
1206
  }
1207
1207
  }
1208
1208
  },
@@ -1219,7 +1219,7 @@ var TAROT_ARKANNUS_DATA = {
1219
1219
  meaning: "Opposition to this commencement. Unimportant obstacles raised by one of the lovers."
1220
1220
  },
1221
1221
  KIER_EGYPTIAN: {
1222
- name: "Preeminence"
1222
+ name: "Versatility"
1223
1223
  }
1224
1224
  }
1225
1225
  },
@@ -1236,7 +1236,7 @@ var TAROT_ARKANNUS_DATA = {
1236
1236
  meaning: "Realization of this commencement. The love is mutual."
1237
1237
  },
1238
1238
  KIER_EGYPTIAN: {
1239
- name: "Premonition"
1239
+ name: "Consummation"
1240
1240
  }
1241
1241
  }
1242
1242
  },
@@ -1253,7 +1253,7 @@ var TAROT_ARKANNUS_DATA = {
1253
1253
  meaning: "Serious obstacles to the love. They arise from other persons, not from the lovers."
1254
1254
  },
1255
1255
  KIER_EGYPTIAN: {
1256
- name: "Expressiveness"
1256
+ name: "Conjecture"
1257
1257
  }
1258
1258
  }
1259
1259
  },
@@ -1270,7 +1270,7 @@ var TAROT_ARKANNUS_DATA = {
1270
1270
  meaning: "Opposition to the obstacles. Victory over the obstacles after a struggle."
1271
1271
  },
1272
1272
  KIER_EGYPTIAN: {
1273
- name: "Regeneration"
1273
+ name: "Patrimony"
1274
1274
  }
1275
1275
  }
1276
1276
  },
@@ -1287,7 +1287,7 @@ var TAROT_ARKANNUS_DATA = {
1287
1287
  meaning: "The obstacles triumph. Love destroyed in the midst of happiness. Widowhood."
1288
1288
  },
1289
1289
  KIER_EGYPTIAN: {
1290
- name: "Patrimony"
1290
+ name: "Regeneration"
1291
1291
  }
1292
1292
  }
1293
1293
  },
@@ -1304,7 +1304,7 @@ var TAROT_ARKANNUS_DATA = {
1304
1304
  meaning: "Success assured to the lovers."
1305
1305
  },
1306
1306
  KIER_EGYPTIAN: {
1307
- name: "Conjecture"
1307
+ name: "Expressiveness"
1308
1308
  }
1309
1309
  }
1310
1310
  },
@@ -1321,7 +1321,7 @@ var TAROT_ARKANNUS_DATA = {
1321
1321
  meaning: "Partial failure of love. Love only partially succeeds."
1322
1322
  },
1323
1323
  KIER_EGYPTIAN: {
1324
- name: "Consummation"
1324
+ name: "Delusion"
1325
1325
  }
1326
1326
  }
1327
1327
  },
@@ -1338,7 +1338,7 @@ var TAROT_ARKANNUS_DATA = {
1338
1338
  meaning: "Motherhood."
1339
1339
  },
1340
1340
  KIER_EGYPTIAN: {
1341
- name: "Versatility"
1341
+ name: "Preeminence"
1342
1342
  }
1343
1343
  }
1344
1344
  },
@@ -1355,7 +1355,7 @@ var TAROT_ARKANNUS_DATA = {
1355
1355
  meaning: "Uncertainty in the management of the love affair."
1356
1356
  },
1357
1357
  KIER_EGYPTIAN: {
1358
- name: "Attraction"
1358
+ name: "Dissension"
1359
1359
  }
1360
1360
  }
1361
1361
  },
@@ -1440,7 +1440,7 @@ var TAROT_ARKANNUS_DATA = {
1440
1440
  meaning: "Commencement of enmity."
1441
1441
  },
1442
1442
  KIER_EGYPTIAN: {
1443
- name: "Contrition"
1443
+ name: "Vehemence"
1444
1444
  }
1445
1445
  }
1446
1446
  },
@@ -1457,7 +1457,7 @@ var TAROT_ARKANNUS_DATA = {
1457
1457
  meaning: "Opposition to this commencement. The enmity does not last."
1458
1458
  },
1459
1459
  KIER_EGYPTIAN: {
1460
- name: "Pilgrimage"
1460
+ name: "Communion"
1461
1461
  }
1462
1462
  }
1463
1463
  },
@@ -1474,7 +1474,7 @@ var TAROT_ARKANNUS_DATA = {
1474
1474
  meaning: "Realization of the enmity. Hatred."
1475
1475
  },
1476
1476
  KIER_EGYPTIAN: {
1477
- name: "Rivalry"
1477
+ name: "Proscription"
1478
1478
  }
1479
1479
  }
1480
1480
  },
@@ -1491,7 +1491,7 @@ var TAROT_ARKANNUS_DATA = {
1491
1491
  meaning: "Opposition to the hatred. Success against the enemy."
1492
1492
  },
1493
1493
  KIER_EGYPTIAN: {
1494
- name: "Meditation"
1494
+ name: "Solitude"
1495
1495
  }
1496
1496
  }
1497
1497
  },
@@ -1508,7 +1508,7 @@ var TAROT_ARKANNUS_DATA = {
1508
1508
  meaning: "Opposition to this opposition. The enemy triumphs at the moment one fancies the victory is secured."
1509
1509
  },
1510
1510
  KIER_EGYPTIAN: {
1511
- name: "Revelation"
1511
+ name: "Evolution"
1512
1512
  }
1513
1513
  }
1514
1514
  },
@@ -1525,7 +1525,7 @@ var TAROT_ARKANNUS_DATA = {
1525
1525
  meaning: "Equilibrium of the opposition. The enemy is rendered powerless at last."
1526
1526
  },
1527
1527
  KIER_EGYPTIAN: {
1528
- name: "Evolution"
1528
+ name: "Revelation"
1529
1529
  }
1530
1530
  }
1531
1531
  },
@@ -1542,7 +1542,7 @@ var TAROT_ARKANNUS_DATA = {
1542
1542
  meaning: "Success assured to the enemy."
1543
1543
  },
1544
1544
  KIER_EGYPTIAN: {
1545
- name: "Solitude"
1545
+ name: "Meditation"
1546
1546
  }
1547
1547
  }
1548
1548
  },
@@ -1559,7 +1559,7 @@ var TAROT_ARKANNUS_DATA = {
1559
1559
  meaning: "Partial opposition to this success. The enemy only partially triumphs."
1560
1560
  },
1561
1561
  KIER_EGYPTIAN: {
1562
- name: "Proscription"
1562
+ name: "Rivalry"
1563
1563
  }
1564
1564
  }
1565
1565
  },
@@ -1576,7 +1576,7 @@ var TAROT_ARKANNUS_DATA = {
1576
1576
  meaning: "Certain duration of the hatred."
1577
1577
  },
1578
1578
  KIER_EGYPTIAN: {
1579
- name: "Communion"
1579
+ name: "Pilgrimage"
1580
1580
  }
1581
1581
  }
1582
1582
  },
@@ -1593,7 +1593,7 @@ var TAROT_ARKANNUS_DATA = {
1593
1593
  meaning: "Uncertainty in the enmity."
1594
1594
  },
1595
1595
  KIER_EGYPTIAN: {
1596
- name: "Vehemence"
1596
+ name: "Contrition"
1597
1597
  }
1598
1598
  }
1599
1599
  },
@@ -1678,7 +1678,7 @@ var TAROT_ARKANNUS_DATA = {
1678
1678
  meaning: "Commencement of fortune. Inheritance. Gifts. Economy."
1679
1679
  },
1680
1680
  KIER_EGYPTIAN: {
1681
- name: "The Unforeseen"
1681
+ name: "Rebirth"
1682
1682
  }
1683
1683
  }
1684
1684
  },
@@ -1695,7 +1695,7 @@ var TAROT_ARKANNUS_DATA = {
1695
1695
  meaning: "Opposition to this commencement. Difficulty in well establishing the first landmarks of good fortune."
1696
1696
  },
1697
1697
  KIER_EGYPTIAN: {
1698
- name: "Cooperation"
1698
+ name: "Confusion"
1699
1699
  }
1700
1700
  }
1701
1701
  },
@@ -1712,7 +1712,7 @@ var TAROT_ARKANNUS_DATA = {
1712
1712
  meaning: "Realization of this commencement of fortune. A small sum."
1713
1713
  },
1714
1714
  KIER_EGYPTIAN: {
1715
- name: "Avarice"
1715
+ name: "The Provider"
1716
1716
  }
1717
1717
  }
1718
1718
  },
@@ -1729,7 +1729,7 @@ var TAROT_ARKANNUS_DATA = {
1729
1729
  meaning: "Opposition of fortune. Loss of money."
1730
1730
  },
1731
1731
  KIER_EGYPTIAN: {
1732
- name: "Purification"
1732
+ name: "Generosity"
1733
1733
  }
1734
1734
  }
1735
1735
  },
@@ -1746,7 +1746,7 @@ var TAROT_ARKANNUS_DATA = {
1746
1746
  meaning: "Opposition to this opposition. A success coming which will balance the low."
1747
1747
  },
1748
1748
  KIER_EGYPTIAN: {
1749
- name: "Love and Desire"
1749
+ name: "Offering"
1750
1750
  }
1751
1751
  }
1752
1752
  },
@@ -1763,7 +1763,7 @@ var TAROT_ARKANNUS_DATA = {
1763
1763
  meaning: "Realization of the opposition. Ruin."
1764
1764
  },
1765
1765
  KIER_EGYPTIAN: {
1766
- name: "Offering"
1766
+ name: "Love and Desire"
1767
1767
  }
1768
1768
  }
1769
1769
  },
@@ -1780,7 +1780,7 @@ var TAROT_ARKANNUS_DATA = {
1780
1780
  meaning: "Success assured. A large fortune."
1781
1781
  },
1782
1782
  KIER_EGYPTIAN: {
1783
- name: "Generosity"
1783
+ name: "Purification"
1784
1784
  }
1785
1785
  }
1786
1786
  },
@@ -1797,7 +1797,7 @@ var TAROT_ARKANNUS_DATA = {
1797
1797
  meaning: "Partial success. Great loss of money at the moment apparently of definitely securing the fortune."
1798
1798
  },
1799
1799
  KIER_EGYPTIAN: {
1800
- name: "The Provider"
1800
+ name: "Avarice"
1801
1801
  }
1802
1802
  }
1803
1803
  },
@@ -1814,7 +1814,7 @@ var TAROT_ARKANNUS_DATA = {
1814
1814
  meaning: "Equilibrium of equilibrium. A durable fortune."
1815
1815
  },
1816
1816
  KIER_EGYPTIAN: {
1817
- name: "Confusion"
1817
+ name: "Cooperation"
1818
1818
  }
1819
1819
  }
1820
1820
  },
@@ -1831,7 +1831,7 @@ var TAROT_ARKANNUS_DATA = {
1831
1831
  meaning: "Uncertainty in the fortune. Great success and great reverses."
1832
1832
  },
1833
1833
  KIER_EGYPTIAN: {
1834
- name: "Rebirth"
1834
+ name: "The Unforeseen"
1835
1835
  }
1836
1836
  }
1837
1837
  }
@@ -2109,6 +2109,11 @@ var COLORS_DATA = {
2109
2109
  }
2110
2110
  };
2111
2111
 
2112
+ // src/core/correspondence-model.ts
2113
+ function makeCorrespondenceId(left, right) {
2114
+ return [left, right].sort().join("<->");
2115
+ }
2116
+
2112
2117
  // src/core/types.ts
2113
2118
  var KaabalahTypes = /* @__PURE__ */ ((KaabalahTypes2) => {
2114
2119
  KaabalahTypes2["SPHERE"] = "sphere";
@@ -3472,6 +3477,101 @@ var linkColorsAndWesternAstrology = (tree) => {
3472
3477
  }
3473
3478
  return tree;
3474
3479
  };
3480
+ var linkTarotAndWesternAstrology = (tree) => {
3481
+ if (!tree.loadedParts.includes("tarot") || !tree.loadedParts.includes("westernAstrology")) {
3482
+ throw new Error("Both parts must be loaded for a bridge to happen");
3483
+ }
3484
+ const courtCardsSigns = [
3485
+ {
3486
+ courtCard: id("tarotArkAnnu" /* TAROT_ARK_ANNU */, TAROT_ARKANNUS.KING_OF_WANDS),
3487
+ sign: id(
3488
+ "westernZodiacSign" /* WESTERN_ZODIAC_SIGN */,
3489
+ WESTERN_ZODIAC_SIGNS.ARIES
3490
+ )
3491
+ },
3492
+ {
3493
+ courtCard: id("tarotArkAnnu" /* TAROT_ARK_ANNU */, TAROT_ARKANNUS.QUEEN_OF_WANDS),
3494
+ sign: id(
3495
+ "westernZodiacSign" /* WESTERN_ZODIAC_SIGN */,
3496
+ WESTERN_ZODIAC_SIGNS.LEO
3497
+ )
3498
+ },
3499
+ {
3500
+ courtCard: id("tarotArkAnnu" /* TAROT_ARK_ANNU */, TAROT_ARKANNUS.KNIGHT_OF_WANDS),
3501
+ sign: id(
3502
+ "westernZodiacSign" /* WESTERN_ZODIAC_SIGN */,
3503
+ WESTERN_ZODIAC_SIGNS.SAGITTARIUS
3504
+ )
3505
+ },
3506
+ {
3507
+ courtCard: id("tarotArkAnnu" /* TAROT_ARK_ANNU */, TAROT_ARKANNUS.KING_OF_CUPS),
3508
+ sign: id(
3509
+ "westernZodiacSign" /* WESTERN_ZODIAC_SIGN */,
3510
+ WESTERN_ZODIAC_SIGNS.CANCER
3511
+ )
3512
+ },
3513
+ {
3514
+ courtCard: id("tarotArkAnnu" /* TAROT_ARK_ANNU */, TAROT_ARKANNUS.QUEEN_OF_CUPS),
3515
+ sign: id(
3516
+ "westernZodiacSign" /* WESTERN_ZODIAC_SIGN */,
3517
+ WESTERN_ZODIAC_SIGNS.SCORPIO
3518
+ )
3519
+ },
3520
+ {
3521
+ courtCard: id("tarotArkAnnu" /* TAROT_ARK_ANNU */, TAROT_ARKANNUS.KNIGHT_OF_CUPS),
3522
+ sign: id(
3523
+ "westernZodiacSign" /* WESTERN_ZODIAC_SIGN */,
3524
+ WESTERN_ZODIAC_SIGNS.PISCES
3525
+ )
3526
+ },
3527
+ {
3528
+ courtCard: id("tarotArkAnnu" /* TAROT_ARK_ANNU */, TAROT_ARKANNUS.KING_OF_SWORDS),
3529
+ sign: id(
3530
+ "westernZodiacSign" /* WESTERN_ZODIAC_SIGN */,
3531
+ WESTERN_ZODIAC_SIGNS.LIBRA
3532
+ )
3533
+ },
3534
+ {
3535
+ courtCard: id("tarotArkAnnu" /* TAROT_ARK_ANNU */, TAROT_ARKANNUS.QUEEN_OF_SWORDS),
3536
+ sign: id(
3537
+ "westernZodiacSign" /* WESTERN_ZODIAC_SIGN */,
3538
+ WESTERN_ZODIAC_SIGNS.AQUARIUS
3539
+ )
3540
+ },
3541
+ {
3542
+ courtCard: id("tarotArkAnnu" /* TAROT_ARK_ANNU */, TAROT_ARKANNUS.KNIGHT_OF_SWORDS),
3543
+ sign: id(
3544
+ "westernZodiacSign" /* WESTERN_ZODIAC_SIGN */,
3545
+ WESTERN_ZODIAC_SIGNS.GEMINI
3546
+ )
3547
+ },
3548
+ {
3549
+ courtCard: id("tarotArkAnnu" /* TAROT_ARK_ANNU */, TAROT_ARKANNUS.KING_OF_PENTACLES),
3550
+ sign: id(
3551
+ "westernZodiacSign" /* WESTERN_ZODIAC_SIGN */,
3552
+ WESTERN_ZODIAC_SIGNS.CAPRICORN
3553
+ )
3554
+ },
3555
+ {
3556
+ courtCard: id("tarotArkAnnu" /* TAROT_ARK_ANNU */, TAROT_ARKANNUS.QUEEN_OF_PENTACLES),
3557
+ sign: id(
3558
+ "westernZodiacSign" /* WESTERN_ZODIAC_SIGN */,
3559
+ WESTERN_ZODIAC_SIGNS.TAURUS
3560
+ )
3561
+ },
3562
+ {
3563
+ courtCard: id("tarotArkAnnu" /* TAROT_ARK_ANNU */, TAROT_ARKANNUS.KNIGHT_OF_PENTACLES),
3564
+ sign: id(
3565
+ "westernZodiacSign" /* WESTERN_ZODIAC_SIGN */,
3566
+ WESTERN_ZODIAC_SIGNS.VIRGO
3567
+ )
3568
+ }
3569
+ ];
3570
+ for (const { courtCard, sign } of courtCardsSigns) {
3571
+ tree.link(courtCard, sign);
3572
+ }
3573
+ return tree;
3574
+ };
3475
3575
  var loadWesternAstrology = (tree) => {
3476
3576
  const planets = Object.values(PLANETS);
3477
3577
  const planetsIds = {};
@@ -4472,6 +4572,11 @@ var BRIDGES = [
4472
4572
  id: "kaabalah-music-westernAstrology",
4473
4573
  needs: ["music", "westernAstrology"],
4474
4574
  run: (t) => linkSoundsAndWesternAstrology(t)
4575
+ },
4576
+ {
4577
+ id: "kaabalah-tarot-westernAstrology",
4578
+ needs: ["tarot", "westernAstrology"],
4579
+ run: (t) => linkTarotAndWesternAstrology(t)
4475
4580
  }
4476
4581
  ];
4477
4582
 
@@ -6395,7 +6500,13 @@ var ModuleManager = class {
6395
6500
  if (!loadedSystem) {
6396
6501
  throw new Error(`System ${systemKey} not found`);
6397
6502
  }
6398
- loadedSystem.LOADERS.base(this.t);
6503
+ this.t.runWithMutationSource(
6504
+ {
6505
+ kind: "system",
6506
+ system: systemKey
6507
+ },
6508
+ () => loadedSystem.LOADERS.base(this.t)
6509
+ );
6399
6510
  this.activeSystem = systemKey;
6400
6511
  this.loadedParts.clear();
6401
6512
  this.loadedParts.add("base");
@@ -6415,13 +6526,28 @@ var ModuleManager = class {
6415
6526
  if (this.loadedParts.has(partKey)) {
6416
6527
  return;
6417
6528
  }
6418
- system.LOADERS[partKey](this.t);
6529
+ this.t.runWithMutationSource(
6530
+ {
6531
+ kind: "part",
6532
+ system: this.activeSystem,
6533
+ part: partKey
6534
+ },
6535
+ () => system.LOADERS[partKey](this.t)
6536
+ );
6419
6537
  this.loadedParts.add(partKey);
6420
6538
  const possiblePartBridges = system.BRIDGES.filter(
6421
6539
  (b) => b.needs.includes(partKey) && !this.bridgedParts.has(b.id) && b.needs.every((n) => this.loadedParts.has(n))
6422
6540
  );
6423
6541
  for (const bridge of possiblePartBridges) {
6424
- bridge.run(this.t);
6542
+ this.t.runWithMutationSource(
6543
+ {
6544
+ kind: "bridge",
6545
+ system: this.activeSystem,
6546
+ bridgeId: bridge.id,
6547
+ parts: [...bridge.needs]
6548
+ },
6549
+ () => bridge.run(this.t)
6550
+ );
6425
6551
  this.bridgedParts.add(bridge.id);
6426
6552
  }
6427
6553
  }
@@ -6458,7 +6584,15 @@ var ModuleManager = class {
6458
6584
  throw new Error(`Bridge ${bridgeKey} not found`);
6459
6585
  }
6460
6586
  if (!this.bridgedParts.has(bridge.id) && bridge.needs.every((n) => this.loadedParts.has(n))) {
6461
- bridge.run(this.t);
6587
+ this.t.runWithMutationSource(
6588
+ {
6589
+ kind: "bridge",
6590
+ system: this.activeSystem,
6591
+ bridgeId: bridge.id,
6592
+ parts: [...bridge.needs]
6593
+ },
6594
+ () => bridge.run(this.t)
6595
+ );
6462
6596
  this.bridgedParts.add(bridge.id);
6463
6597
  }
6464
6598
  }
@@ -6494,12 +6628,60 @@ var ModuleManager = class {
6494
6628
  };
6495
6629
 
6496
6630
  // src/core/tree-of-life.ts
6631
+ function mergeCorrespondenceMetadata(current, next) {
6632
+ if (!current) {
6633
+ return next ? { ...next } : void 0;
6634
+ }
6635
+ if (!next) {
6636
+ return { ...current };
6637
+ }
6638
+ return {
6639
+ ...current,
6640
+ ...next,
6641
+ tags: [.../* @__PURE__ */ new Set([...current.tags ?? [], ...next.tags ?? []])],
6642
+ attributes: {
6643
+ ...current.attributes ?? {},
6644
+ ...next.attributes ?? {}
6645
+ }
6646
+ };
6647
+ }
6648
+ function mergeCorrespondenceSources(current, next) {
6649
+ const seen = /* @__PURE__ */ new Set();
6650
+ const merged = [];
6651
+ for (const source of [...current, next]) {
6652
+ const key = JSON.stringify(source);
6653
+ if (seen.has(key)) {
6654
+ continue;
6655
+ }
6656
+ seen.add(key);
6657
+ merged.push({
6658
+ ...source,
6659
+ ...source.kind === "bridge" ? { parts: [...source.parts] } : {}
6660
+ });
6661
+ }
6662
+ return merged;
6663
+ }
6497
6664
  var TreeOfLife = class {
6498
6665
  constructor() {
6499
6666
  this.nodes = /* @__PURE__ */ new Map();
6500
6667
  this.adjacent = /* @__PURE__ */ new Map();
6668
+ this.edges = /* @__PURE__ */ new Map();
6669
+ this.mutationSources = [{ kind: "manual" }];
6501
6670
  this.modules = new ModuleManager(this);
6502
6671
  }
6672
+ getCurrentMutationSource() {
6673
+ return this.mutationSources[this.mutationSources.length - 1] ?? {
6674
+ kind: "manual"
6675
+ };
6676
+ }
6677
+ runWithMutationSource(source, fn) {
6678
+ this.mutationSources.push(source);
6679
+ try {
6680
+ return fn();
6681
+ } finally {
6682
+ this.mutationSources.pop();
6683
+ }
6684
+ }
6503
6685
  /**
6504
6686
  * Loads the tree of life system to be used
6505
6687
  * @param systemKey - the key of the system to load
@@ -6561,28 +6743,57 @@ var TreeOfLife = class {
6561
6743
  getNodes() {
6562
6744
  return [...this.nodes.values()];
6563
6745
  }
6746
+ getEdge(left, right) {
6747
+ return this.edges.get(makeCorrespondenceId(left, right));
6748
+ }
6749
+ getEdges(nodeId) {
6750
+ if (!nodeId) {
6751
+ return [...this.edges.values()];
6752
+ }
6753
+ return [...this.adjacent.get(nodeId) ?? []].map((relatedNodeId) => this.getEdge(nodeId, relatedNodeId)).filter((edge) => Boolean(edge));
6754
+ }
6564
6755
  /**
6565
6756
  * Links two nodes bi-directionally
6566
6757
  * @param firstNode - the id of the first node
6567
6758
  * @param secondNode - the id of the second node
6568
6759
  */
6569
- link(firstNode, secondNode) {
6760
+ link(firstNode, secondNode, options = {}) {
6570
6761
  if (!this.nodes.has(firstNode) || !this.nodes.has(secondNode)) {
6571
6762
  throw new Error("unknown node id");
6572
6763
  }
6573
6764
  if (firstNode === secondNode) {
6574
6765
  return;
6575
6766
  }
6576
- if (this.adjacent.has(firstNode) && this.adjacent.get(firstNode)?.has(secondNode)) {
6577
- return;
6578
- }
6767
+ const edgeId = makeCorrespondenceId(firstNode, secondNode);
6768
+ const source = options.source ?? this.getCurrentMutationSource();
6769
+ const existingEdge = this.edges.get(edgeId);
6579
6770
  const put = (leftNode, rightNode) => {
6580
6771
  const set = this.adjacent.get(leftNode) ?? /* @__PURE__ */ new Set();
6581
6772
  set.add(rightNode);
6582
6773
  this.adjacent.set(leftNode, set);
6583
6774
  };
6775
+ if (existingEdge) {
6776
+ this.edges.set(edgeId, {
6777
+ ...existingEdge,
6778
+ metadata: mergeCorrespondenceMetadata(
6779
+ existingEdge.metadata,
6780
+ options.metadata
6781
+ ),
6782
+ sources: mergeCorrespondenceSources(existingEdge.sources, source)
6783
+ });
6784
+ put(firstNode, secondNode);
6785
+ put(secondNode, firstNode);
6786
+ return;
6787
+ }
6584
6788
  put(firstNode, secondNode);
6585
6789
  put(secondNode, firstNode);
6790
+ this.edges.set(edgeId, {
6791
+ id: edgeId,
6792
+ left: firstNode,
6793
+ right: secondNode,
6794
+ metadata: mergeCorrespondenceMetadata(void 0, options.metadata),
6795
+ sources: mergeCorrespondenceSources([], source)
6796
+ });
6586
6797
  }
6587
6798
  /**
6588
6799
  * Gets the current node and all its direct relations, or, when filtered by node type, only the direct relations of that type.
@@ -6667,6 +6878,7 @@ var TreeOfLife = class {
6667
6878
  const neighbors = this.adjacent.get(id2);
6668
6879
  if (neighbors) {
6669
6880
  for (const neighbor of neighbors) {
6881
+ this.edges.delete(makeCorrespondenceId(id2, neighbor));
6670
6882
  const set = this.adjacent.get(neighbor);
6671
6883
  if (!set) {
6672
6884
  continue;
@@ -6882,6 +7094,7 @@ exports.WESTERN_ZODIAC_SIGNS = WESTERN_ZODIAC_SIGNS;
6882
7094
  exports.WesternAstrologyTypes = WesternAstrologyTypes;
6883
7095
  exports.createTree = createTree;
6884
7096
  exports.id = id;
7097
+ exports.makeCorrespondenceId = makeCorrespondenceId;
6885
7098
  exports.parseId = parseId;
6886
- //# sourceMappingURL=chunk-T67M2WBD.js.map
6887
- //# sourceMappingURL=chunk-T67M2WBD.js.map
7099
+ //# sourceMappingURL=chunk-3HYK4Q4B.js.map
7100
+ //# sourceMappingURL=chunk-3HYK4Q4B.js.map