kaabalah 6.15.0 → 6.16.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 (113) hide show
  1. package/README.md +15 -0
  2. package/dist/astrology/index.d.mts +39 -1
  3. package/dist/astrology/index.d.ts +39 -1
  4. package/dist/astrology/index.js +75 -53
  5. package/dist/astrology/index.mjs +3 -1
  6. package/dist/chunk-2IC6H3FI.js +1600 -0
  7. package/dist/chunk-2IC6H3FI.js.map +1 -0
  8. package/dist/{chunk-RAQDVWNK.mjs → chunk-3JMY4U4S.mjs} +546 -3
  9. package/dist/chunk-3JMY4U4S.mjs.map +1 -0
  10. package/dist/chunk-3QN5V3DP.js +4737 -0
  11. package/dist/chunk-3QN5V3DP.js.map +1 -0
  12. package/dist/{chunk-UNXDDLZS.js → chunk-6LZOAU6E.js} +548 -3
  13. package/dist/chunk-6LZOAU6E.js.map +1 -0
  14. package/dist/{chunk-LXJ3THNW.mjs → chunk-7JWBIAUF.mjs} +12 -9
  15. package/dist/chunk-7JWBIAUF.mjs.map +1 -0
  16. package/dist/{chunk-Q7YAKPBH.js → chunk-7OWGGDRF.js} +80 -1015
  17. package/dist/chunk-7OWGGDRF.js.map +1 -0
  18. package/dist/{chunk-2WCC2KCJ.js → chunk-BALOSCWQ.mjs} +22 -3
  19. package/dist/chunk-BALOSCWQ.mjs.map +1 -0
  20. package/dist/{chunk-RQLHFFXR.js → chunk-BKFHIKFY.js} +645 -185
  21. package/dist/chunk-BKFHIKFY.js.map +1 -0
  22. package/dist/{chunk-SXARKCYN.js → chunk-CMXTZKWW.js} +552 -144
  23. package/dist/chunk-CMXTZKWW.js.map +1 -0
  24. package/dist/{chunk-6GDEXIDI.js → chunk-HEZCZXQC.js} +25 -22
  25. package/dist/chunk-HEZCZXQC.js.map +1 -0
  26. package/dist/chunk-ICUDGCYX.js +15 -0
  27. package/dist/chunk-ICUDGCYX.js.map +1 -0
  28. package/dist/chunk-IT7GZ337.mjs +4679 -0
  29. package/dist/chunk-IT7GZ337.mjs.map +1 -0
  30. package/dist/{chunk-NOZKIUGP.mjs → chunk-J5Y325TG.mjs} +80 -1015
  31. package/dist/chunk-J5Y325TG.mjs.map +1 -0
  32. package/dist/chunk-JY4QC6FR.js +2214 -0
  33. package/dist/chunk-JY4QC6FR.js.map +1 -0
  34. package/dist/{chunk-URDMOQRN.mjs → chunk-L5EYUE4B.js} +27 -2
  35. package/dist/chunk-L5EYUE4B.js.map +1 -0
  36. package/dist/{chunk-OTSJWMWK.mjs → chunk-LQVHJ3VY.mjs} +432 -29
  37. package/dist/chunk-LQVHJ3VY.mjs.map +1 -0
  38. package/dist/{chunk-CFNMEJTR.mjs → chunk-MWLSSRHL.mjs} +626 -166
  39. package/dist/chunk-MWLSSRHL.mjs.map +1 -0
  40. package/dist/{chunk-CW6QDSMF.js → chunk-PBBF5DKC.js} +88 -21
  41. package/dist/chunk-PBBF5DKC.js.map +1 -0
  42. package/dist/chunk-RUE6NTVT.mjs +2211 -0
  43. package/dist/chunk-RUE6NTVT.mjs.map +1 -0
  44. package/dist/{chunk-X5HGLMEF.mjs → chunk-UO2RQQZO.mjs} +770 -3
  45. package/dist/chunk-UO2RQQZO.mjs.map +1 -0
  46. package/dist/chunk-W2N7STO3.mjs +13 -0
  47. package/dist/chunk-W2N7STO3.mjs.map +1 -0
  48. package/dist/{chunk-ICEVPLT4.mjs → chunk-WP5MRAYG.mjs} +2314 -4
  49. package/dist/chunk-WP5MRAYG.mjs.map +1 -0
  50. package/dist/{chunk-XHITSUSQ.js → chunk-WRF3EORB.js} +2330 -14
  51. package/dist/chunk-WRF3EORB.js.map +1 -0
  52. package/dist/{chunk-OSMB2MJR.mjs → chunk-Z3JZ5DZN.mjs} +68 -3
  53. package/dist/chunk-Z3JZ5DZN.mjs.map +1 -0
  54. package/dist/cli.js +34203 -23209
  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 +67 -53
  59. package/dist/core/index.mjs +4 -2
  60. package/dist/gematria/index.d.mts +153 -1
  61. package/dist/gematria/index.d.ts +153 -1
  62. package/dist/gematria/index.js +15 -5
  63. package/dist/gematria/index.mjs +4 -2
  64. package/dist/iching/index.d.mts +786 -29
  65. package/dist/iching/index.d.ts +786 -29
  66. package/dist/iching/index.js +66 -40
  67. package/dist/iching/index.mjs +5 -3
  68. package/dist/ifa/index.d.mts +44 -1
  69. package/dist/ifa/index.d.ts +44 -1
  70. package/dist/ifa/index.js +11 -2
  71. package/dist/ifa/index.mjs +2 -1
  72. package/dist/index.d.mts +7 -7
  73. package/dist/index.d.ts +7 -7
  74. package/dist/index.js +369 -267
  75. package/dist/index.mjs +12 -10
  76. package/dist/numerology/index.d.mts +872 -1
  77. package/dist/numerology/index.d.ts +872 -1
  78. package/dist/numerology/index.js +28 -18
  79. package/dist/numerology/index.mjs +5 -3
  80. package/dist/semantic/index.d.mts +92 -15
  81. package/dist/semantic/index.d.ts +92 -15
  82. package/dist/semantic/index.js +57 -35
  83. package/dist/semantic/index.mjs +9 -7
  84. package/dist/tarot/index.d.mts +9 -4
  85. package/dist/tarot/index.d.ts +9 -4
  86. package/dist/tarot/index.js +32 -30
  87. package/dist/tarot/index.mjs +5 -3
  88. package/dist/visual/index.js +48 -46
  89. package/dist/visual/index.mjs +5 -3
  90. package/package.json +7 -3
  91. package/dist/chunk-2WCC2KCJ.js.map +0 -1
  92. package/dist/chunk-47BAJUYW.js +0 -830
  93. package/dist/chunk-47BAJUYW.js.map +0 -1
  94. package/dist/chunk-6GDEXIDI.js.map +0 -1
  95. package/dist/chunk-CFNMEJTR.mjs.map +0 -1
  96. package/dist/chunk-CW6QDSMF.js.map +0 -1
  97. package/dist/chunk-ICEVPLT4.mjs.map +0 -1
  98. package/dist/chunk-LXJ3THNW.mjs.map +0 -1
  99. package/dist/chunk-NOZKIUGP.mjs.map +0 -1
  100. package/dist/chunk-OSMB2MJR.mjs.map +0 -1
  101. package/dist/chunk-OTSJWMWK.mjs.map +0 -1
  102. package/dist/chunk-PEHDLSUH.mjs +0 -2227
  103. package/dist/chunk-PEHDLSUH.mjs.map +0 -1
  104. package/dist/chunk-Q7YAKPBH.js.map +0 -1
  105. package/dist/chunk-RAQDVWNK.mjs.map +0 -1
  106. package/dist/chunk-RQLHFFXR.js.map +0 -1
  107. package/dist/chunk-SWWLTDR6.js +0 -2280
  108. package/dist/chunk-SWWLTDR6.js.map +0 -1
  109. package/dist/chunk-SXARKCYN.js.map +0 -1
  110. package/dist/chunk-UNXDDLZS.js.map +0 -1
  111. package/dist/chunk-URDMOQRN.mjs.map +0 -1
  112. package/dist/chunk-X5HGLMEF.mjs.map +0 -1
  113. package/dist/chunk-XHITSUSQ.js.map +0 -1
@@ -109,6 +109,27 @@ interface TextSelection {
109
109
  readonly text: ClassicalText;
110
110
  }
111
111
 
112
+ /** Classical text with a selected display value beside the unchanged Chinese and English. */
113
+ interface ClassicalTextContent extends ClassicalText {
114
+ readonly content: string;
115
+ }
116
+ interface HexagramTextContent {
117
+ readonly judgment: ClassicalTextContent;
118
+ readonly image: ClassicalTextContent;
119
+ readonly lines: readonly ClassicalTextContent[];
120
+ readonly useNine?: ClassicalTextContent;
121
+ readonly useSix?: ClassicalTextContent;
122
+ }
123
+ /** Bilingual classical texts keyed by hexagram number and text position. */
124
+ declare const HEXAGRAM_TEXTS: Readonly<Record<string, Readonly<{
125
+ en: string;
126
+ pt: string;
127
+ }>>>;
128
+ /** Localized classical text. Unknown numbers return undefined. Chinese and English stay available. */
129
+ declare function getHexagramText(number: number, language?: string): HexagramTextContent | undefined;
130
+ /** Apply language selection to a text already chosen by the unchanged Zhu Xi rules. */
131
+ declare function getOracleTextContent(selection: TextSelection, language?: string): ClassicalTextContent;
132
+
112
133
  /** Portuguese hexagram display names, keyed by King Wen number. */
113
134
  declare const HEXAGRAM_NAMES_PT: Readonly<Record<string, string>>;
114
135
  declare const HEXAGRAMS: readonly Hexagram[];
@@ -380,32 +401,32 @@ declare function listHexagramGates(): {
380
401
  }[];
381
402
 
382
403
  declare const SOVEREIGN_HEXAGRAMS: readonly Readonly<{
383
- hexagramNumber: 1 | 2 | 11 | 12 | 19 | 20 | 24 | 44 | 43 | 33 | 34 | 23;
384
- lunarMonth: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
404
+ hexagramNumber: 2 | 1 | 11 | 33 | 44 | 24 | 12 | 19 | 20 | 43 | 34 | 23;
405
+ lunarMonth: 2 | 1 | 4 | 11 | 9 | 10 | 7 | 6 | 12 | 3 | 8 | 5;
385
406
  branch: "子" | "丑" | "寅" | "卯" | "辰" | "巳" | "午" | "未" | "申" | "酉" | "戌" | "亥";
386
407
  approximateSolarWindow: Readonly<{
387
408
  start: Readonly<{
388
- month: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
389
- day: 4 | 5 | 6 | 7 | 8;
409
+ month: 2 | 1 | 4 | 11 | 9 | 10 | 7 | 6 | 12 | 3 | 8 | 5;
410
+ day: 4 | 7 | 6 | 8 | 5;
390
411
  }>;
391
412
  end: Readonly<{
392
- month: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
393
- day: 3 | 4 | 5 | 6 | 7;
413
+ month: 2 | 1 | 4 | 11 | 9 | 10 | 7 | 6 | 12 | 3 | 8 | 5;
414
+ day: 4 | 7 | 6 | 3 | 5;
394
415
  }>;
395
416
  }>;
396
417
  }>[];
397
418
  declare function getSovereignHexagram(number: number): Readonly<{
398
- hexagramNumber: 1 | 2 | 11 | 12 | 19 | 20 | 24 | 44 | 43 | 33 | 34 | 23;
399
- lunarMonth: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
419
+ hexagramNumber: 2 | 1 | 11 | 33 | 44 | 24 | 12 | 19 | 20 | 43 | 34 | 23;
420
+ lunarMonth: 2 | 1 | 4 | 11 | 9 | 10 | 7 | 6 | 12 | 3 | 8 | 5;
400
421
  branch: "子" | "丑" | "寅" | "卯" | "辰" | "巳" | "午" | "未" | "申" | "酉" | "戌" | "亥";
401
422
  approximateSolarWindow: Readonly<{
402
423
  start: Readonly<{
403
- month: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
404
- day: 4 | 5 | 6 | 7 | 8;
424
+ month: 2 | 1 | 4 | 11 | 9 | 10 | 7 | 6 | 12 | 3 | 8 | 5;
425
+ day: 4 | 7 | 6 | 8 | 5;
405
426
  }>;
406
427
  end: Readonly<{
407
- month: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
408
- day: 3 | 4 | 5 | 6 | 7;
428
+ month: 2 | 1 | 4 | 11 | 9 | 10 | 7 | 6 | 12 | 3 | 8 | 5;
429
+ day: 4 | 7 | 6 | 3 | 5;
409
430
  }>;
410
431
  }>;
411
432
  }> | null;
@@ -653,18 +674,18 @@ declare function deriveReading(input: CastInput): {
653
674
  };
654
675
  };
655
676
  sovereign: Readonly<{
656
- hexagramNumber: 1 | 2 | 11 | 12 | 19 | 20 | 24 | 44 | 43 | 33 | 34 | 23;
657
- lunarMonth: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
677
+ hexagramNumber: 2 | 1 | 11 | 33 | 44 | 24 | 12 | 19 | 20 | 43 | 34 | 23;
678
+ lunarMonth: 2 | 1 | 4 | 11 | 9 | 10 | 7 | 6 | 12 | 3 | 8 | 5;
658
679
  branch: "子" | "丑" | "寅" | "卯" | "辰" | "巳" | "午" | "未" | "申" | "酉" | "戌" | "亥";
659
680
  approximateSolarWindow: Readonly<{
660
681
  start: Readonly<{
661
- month: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
662
- day: 4 | 5 | 6 | 7 | 8;
682
+ month: 2 | 1 | 4 | 11 | 9 | 10 | 7 | 6 | 12 | 3 | 8 | 5;
683
+ day: 4 | 7 | 6 | 8 | 5;
663
684
  }>;
664
685
  end: Readonly<{
665
- month: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
666
- day: 3 | 4 | 5 | 6 | 7;
667
- }>; /** Derive the complete record from the six stored lines; no date, network, or interpretation. */
686
+ month: 2 | 1 | 4 | 11 | 9 | 10 | 7 | 6 | 12 | 3 | 8 | 5;
687
+ day: 4 | 7 | 6 | 3 | 5;
688
+ }>;
668
689
  }>;
669
690
  }> | null;
670
691
  };
@@ -904,18 +925,18 @@ declare function deriveReading(input: CastInput): {
904
925
  };
905
926
  };
906
927
  sovereign: Readonly<{
907
- hexagramNumber: 1 | 2 | 11 | 12 | 19 | 20 | 24 | 44 | 43 | 33 | 34 | 23;
908
- lunarMonth: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
928
+ hexagramNumber: 2 | 1 | 11 | 33 | 44 | 24 | 12 | 19 | 20 | 43 | 34 | 23;
929
+ lunarMonth: 2 | 1 | 4 | 11 | 9 | 10 | 7 | 6 | 12 | 3 | 8 | 5;
909
930
  branch: "子" | "丑" | "寅" | "卯" | "辰" | "巳" | "午" | "未" | "申" | "酉" | "戌" | "亥";
910
931
  approximateSolarWindow: Readonly<{
911
932
  start: Readonly<{
912
- month: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
913
- day: 4 | 5 | 6 | 7 | 8;
933
+ month: 2 | 1 | 4 | 11 | 9 | 10 | 7 | 6 | 12 | 3 | 8 | 5;
934
+ day: 4 | 7 | 6 | 8 | 5;
914
935
  }>;
915
936
  end: Readonly<{
916
- month: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
917
- day: 3 | 4 | 5 | 6 | 7;
918
- }>; /** Derive the complete record from the six stored lines; no date, network, or interpretation. */
937
+ month: 2 | 1 | 4 | 11 | 9 | 10 | 7 | 6 | 12 | 3 | 8 | 5;
938
+ day: 4 | 7 | 6 | 3 | 5;
939
+ }>;
919
940
  }>;
920
941
  }> | null;
921
942
  } | null;
@@ -923,10 +944,746 @@ declare function deriveReading(input: CastInput): {
923
944
  oracle: readonly TextSelection[];
924
945
  };
925
946
  type IChingReading = ReturnType<typeof deriveReading>;
926
- /** Dates and question are caller-supplied labels; this helper never supplies a clock or interpretation. */
927
- declare function formatRecord(input: CastInput, labels?: {
947
+ /**
948
+ * Reading with selected text in `.content`, including oracle, cast, transformed and nuclear texts.
949
+ * English is the default; pt and pt-BR select Portuguese. Original Chinese and English remain.
950
+ */
951
+ declare function getIChingReadingContent(input: CastInput, language?: string): {
952
+ cast: {
953
+ hexagram: {
954
+ text: HexagramTextContent;
955
+ number: number;
956
+ hanzi: string;
957
+ pinyin: string;
958
+ wadeGiles: string;
959
+ pinyinVariants?: readonly string[] | undefined;
960
+ english: string;
961
+ portuguese: string;
962
+ symbol: string;
963
+ binary: string;
964
+ lower: Trigram;
965
+ upper: Trigram;
966
+ };
967
+ nuclear: {
968
+ hexagram: {
969
+ text: HexagramTextContent;
970
+ number: number;
971
+ hanzi: string;
972
+ pinyin: string;
973
+ wadeGiles: string;
974
+ pinyinVariants?: readonly string[] | undefined;
975
+ english: string;
976
+ portuguese: string;
977
+ symbol: string;
978
+ binary: string;
979
+ lower: Trigram;
980
+ upper: Trigram;
981
+ };
982
+ han: HanHexagram;
983
+ kaabalah: {
984
+ gate: {
985
+ upper: {
986
+ trigram: Trigram;
987
+ letter: {
988
+ id: NodeId<LetterTypes.HEBREW_LETTER>;
989
+ name: string;
990
+ character: string | undefined;
991
+ value: number | undefined;
992
+ };
993
+ path: {
994
+ id: NodeId<KaabalahTypes.PATH>;
995
+ number: number;
996
+ from: {
997
+ id: NodeId<KaabalahTypes.SPHERE>;
998
+ name: string;
999
+ };
1000
+ to: {
1001
+ id: NodeId<KaabalahTypes.SPHERE>;
1002
+ name: string;
1003
+ };
1004
+ };
1005
+ arcanum: {
1006
+ id: NodeId<TarotTypes.TAROT_ARK_ANNU>;
1007
+ number: number;
1008
+ name: string;
1009
+ };
1010
+ };
1011
+ lower: {
1012
+ trigram: Trigram;
1013
+ letter: {
1014
+ id: NodeId<LetterTypes.HEBREW_LETTER>;
1015
+ name: string;
1016
+ character: string | undefined;
1017
+ value: number | undefined;
1018
+ };
1019
+ path: {
1020
+ id: NodeId<KaabalahTypes.PATH>;
1021
+ number: number;
1022
+ from: {
1023
+ id: NodeId<KaabalahTypes.SPHERE>;
1024
+ name: string;
1025
+ };
1026
+ to: {
1027
+ id: NodeId<KaabalahTypes.SPHERE>;
1028
+ name: string;
1029
+ };
1030
+ };
1031
+ arcanum: {
1032
+ id: NodeId<TarotTypes.TAROT_ARK_ANNU>;
1033
+ number: number;
1034
+ name: string;
1035
+ };
1036
+ };
1037
+ order: "upper-lower";
1038
+ };
1039
+ rulingArcanum: {
1040
+ trigram: Trigram;
1041
+ letter: {
1042
+ id: NodeId<LetterTypes.HEBREW_LETTER>;
1043
+ name: string;
1044
+ character: string | undefined;
1045
+ value: number | undefined;
1046
+ };
1047
+ path: {
1048
+ id: NodeId<KaabalahTypes.PATH>;
1049
+ number: number;
1050
+ from: {
1051
+ id: NodeId<KaabalahTypes.SPHERE>;
1052
+ name: string;
1053
+ };
1054
+ to: {
1055
+ id: NodeId<KaabalahTypes.SPHERE>;
1056
+ name: string;
1057
+ };
1058
+ };
1059
+ arcanum: {
1060
+ id: NodeId<TarotTypes.TAROT_ARK_ANNU>;
1061
+ number: number;
1062
+ name: string;
1063
+ };
1064
+ };
1065
+ family: {
1066
+ upper: {
1067
+ trigram: Trigram;
1068
+ family: string;
1069
+ sphere: {
1070
+ id: NodeId<KaabalahTypes.SPHERE>;
1071
+ name: string;
1072
+ };
1073
+ };
1074
+ lower: {
1075
+ trigram: Trigram;
1076
+ family: string;
1077
+ sphere: {
1078
+ id: NodeId<KaabalahTypes.SPHERE>;
1079
+ name: string;
1080
+ };
1081
+ };
1082
+ };
1083
+ pillars: {
1084
+ upper: {
1085
+ left: boolean;
1086
+ middle: boolean;
1087
+ right: boolean;
1088
+ };
1089
+ lower: {
1090
+ left: boolean;
1091
+ middle: boolean;
1092
+ right: boolean;
1093
+ };
1094
+ };
1095
+ };
1096
+ selfNucleating: boolean;
1097
+ palace: Palace;
1098
+ };
1099
+ han: HanHexagram;
1100
+ kaabalah: {
1101
+ gate: {
1102
+ upper: {
1103
+ trigram: Trigram;
1104
+ letter: {
1105
+ id: NodeId<LetterTypes.HEBREW_LETTER>;
1106
+ name: string;
1107
+ character: string | undefined;
1108
+ value: number | undefined;
1109
+ };
1110
+ path: {
1111
+ id: NodeId<KaabalahTypes.PATH>;
1112
+ number: number;
1113
+ from: {
1114
+ id: NodeId<KaabalahTypes.SPHERE>;
1115
+ name: string;
1116
+ };
1117
+ to: {
1118
+ id: NodeId<KaabalahTypes.SPHERE>;
1119
+ name: string;
1120
+ };
1121
+ };
1122
+ arcanum: {
1123
+ id: NodeId<TarotTypes.TAROT_ARK_ANNU>;
1124
+ number: number;
1125
+ name: string;
1126
+ };
1127
+ };
1128
+ lower: {
1129
+ trigram: Trigram;
1130
+ letter: {
1131
+ id: NodeId<LetterTypes.HEBREW_LETTER>;
1132
+ name: string;
1133
+ character: string | undefined;
1134
+ value: number | undefined;
1135
+ };
1136
+ path: {
1137
+ id: NodeId<KaabalahTypes.PATH>;
1138
+ number: number;
1139
+ from: {
1140
+ id: NodeId<KaabalahTypes.SPHERE>;
1141
+ name: string;
1142
+ };
1143
+ to: {
1144
+ id: NodeId<KaabalahTypes.SPHERE>;
1145
+ name: string;
1146
+ };
1147
+ };
1148
+ arcanum: {
1149
+ id: NodeId<TarotTypes.TAROT_ARK_ANNU>;
1150
+ number: number;
1151
+ name: string;
1152
+ };
1153
+ };
1154
+ order: "upper-lower";
1155
+ };
1156
+ rulingArcanum: {
1157
+ trigram: Trigram;
1158
+ letter: {
1159
+ id: NodeId<LetterTypes.HEBREW_LETTER>;
1160
+ name: string;
1161
+ character: string | undefined;
1162
+ value: number | undefined;
1163
+ };
1164
+ path: {
1165
+ id: NodeId<KaabalahTypes.PATH>;
1166
+ number: number;
1167
+ from: {
1168
+ id: NodeId<KaabalahTypes.SPHERE>;
1169
+ name: string;
1170
+ };
1171
+ to: {
1172
+ id: NodeId<KaabalahTypes.SPHERE>;
1173
+ name: string;
1174
+ };
1175
+ };
1176
+ arcanum: {
1177
+ id: NodeId<TarotTypes.TAROT_ARK_ANNU>;
1178
+ number: number;
1179
+ name: string;
1180
+ };
1181
+ };
1182
+ family: {
1183
+ upper: {
1184
+ trigram: Trigram;
1185
+ family: string;
1186
+ sphere: {
1187
+ id: NodeId<KaabalahTypes.SPHERE>;
1188
+ name: string;
1189
+ };
1190
+ };
1191
+ lower: {
1192
+ trigram: Trigram;
1193
+ family: string;
1194
+ sphere: {
1195
+ id: NodeId<KaabalahTypes.SPHERE>;
1196
+ name: string;
1197
+ };
1198
+ };
1199
+ };
1200
+ pillars: {
1201
+ upper: {
1202
+ left: boolean;
1203
+ middle: boolean;
1204
+ right: boolean;
1205
+ };
1206
+ lower: {
1207
+ left: boolean;
1208
+ middle: boolean;
1209
+ right: boolean;
1210
+ };
1211
+ };
1212
+ };
1213
+ sovereign: Readonly<{
1214
+ hexagramNumber: 2 | 1 | 11 | 33 | 44 | 24 | 12 | 19 | 20 | 43 | 34 | 23;
1215
+ lunarMonth: 2 | 1 | 4 | 11 | 9 | 10 | 7 | 6 | 12 | 3 | 8 | 5;
1216
+ branch: "子" | "丑" | "寅" | "卯" | "辰" | "巳" | "午" | "未" | "申" | "酉" | "戌" | "亥";
1217
+ approximateSolarWindow: Readonly<{
1218
+ start: Readonly<{
1219
+ month: 2 | 1 | 4 | 11 | 9 | 10 | 7 | 6 | 12 | 3 | 8 | 5;
1220
+ day: 4 | 7 | 6 | 8 | 5;
1221
+ }>;
1222
+ end: Readonly<{
1223
+ month: 2 | 1 | 4 | 11 | 9 | 10 | 7 | 6 | 12 | 3 | 8 | 5;
1224
+ day: 4 | 7 | 6 | 3 | 5;
1225
+ }>;
1226
+ }>;
1227
+ }> | null;
1228
+ };
1229
+ transformed: {
1230
+ hexagram: {
1231
+ text: HexagramTextContent;
1232
+ number: number;
1233
+ hanzi: string;
1234
+ pinyin: string;
1235
+ wadeGiles: string;
1236
+ pinyinVariants?: readonly string[] | undefined;
1237
+ english: string;
1238
+ portuguese: string;
1239
+ symbol: string;
1240
+ binary: string;
1241
+ lower: Trigram;
1242
+ upper: Trigram;
1243
+ };
1244
+ nuclear: {
1245
+ hexagram: {
1246
+ text: HexagramTextContent;
1247
+ number: number;
1248
+ hanzi: string;
1249
+ pinyin: string;
1250
+ wadeGiles: string;
1251
+ pinyinVariants?: readonly string[] | undefined;
1252
+ english: string;
1253
+ portuguese: string;
1254
+ symbol: string;
1255
+ binary: string;
1256
+ lower: Trigram;
1257
+ upper: Trigram;
1258
+ };
1259
+ han: HanHexagram;
1260
+ kaabalah: {
1261
+ gate: {
1262
+ upper: {
1263
+ trigram: Trigram;
1264
+ letter: {
1265
+ id: NodeId<LetterTypes.HEBREW_LETTER>;
1266
+ name: string;
1267
+ character: string | undefined;
1268
+ value: number | undefined;
1269
+ };
1270
+ path: {
1271
+ id: NodeId<KaabalahTypes.PATH>;
1272
+ number: number;
1273
+ from: {
1274
+ id: NodeId<KaabalahTypes.SPHERE>;
1275
+ name: string;
1276
+ };
1277
+ to: {
1278
+ id: NodeId<KaabalahTypes.SPHERE>;
1279
+ name: string;
1280
+ };
1281
+ };
1282
+ arcanum: {
1283
+ id: NodeId<TarotTypes.TAROT_ARK_ANNU>;
1284
+ number: number;
1285
+ name: string;
1286
+ };
1287
+ };
1288
+ lower: {
1289
+ trigram: Trigram;
1290
+ letter: {
1291
+ id: NodeId<LetterTypes.HEBREW_LETTER>;
1292
+ name: string;
1293
+ character: string | undefined;
1294
+ value: number | undefined;
1295
+ };
1296
+ path: {
1297
+ id: NodeId<KaabalahTypes.PATH>;
1298
+ number: number;
1299
+ from: {
1300
+ id: NodeId<KaabalahTypes.SPHERE>;
1301
+ name: string;
1302
+ };
1303
+ to: {
1304
+ id: NodeId<KaabalahTypes.SPHERE>;
1305
+ name: string;
1306
+ };
1307
+ };
1308
+ arcanum: {
1309
+ id: NodeId<TarotTypes.TAROT_ARK_ANNU>;
1310
+ number: number;
1311
+ name: string;
1312
+ };
1313
+ };
1314
+ order: "upper-lower";
1315
+ };
1316
+ rulingArcanum: {
1317
+ trigram: Trigram;
1318
+ letter: {
1319
+ id: NodeId<LetterTypes.HEBREW_LETTER>;
1320
+ name: string;
1321
+ character: string | undefined;
1322
+ value: number | undefined;
1323
+ };
1324
+ path: {
1325
+ id: NodeId<KaabalahTypes.PATH>;
1326
+ number: number;
1327
+ from: {
1328
+ id: NodeId<KaabalahTypes.SPHERE>;
1329
+ name: string;
1330
+ };
1331
+ to: {
1332
+ id: NodeId<KaabalahTypes.SPHERE>;
1333
+ name: string;
1334
+ };
1335
+ };
1336
+ arcanum: {
1337
+ id: NodeId<TarotTypes.TAROT_ARK_ANNU>;
1338
+ number: number;
1339
+ name: string;
1340
+ };
1341
+ };
1342
+ family: {
1343
+ upper: {
1344
+ trigram: Trigram;
1345
+ family: string;
1346
+ sphere: {
1347
+ id: NodeId<KaabalahTypes.SPHERE>;
1348
+ name: string;
1349
+ };
1350
+ };
1351
+ lower: {
1352
+ trigram: Trigram;
1353
+ family: string;
1354
+ sphere: {
1355
+ id: NodeId<KaabalahTypes.SPHERE>;
1356
+ name: string;
1357
+ };
1358
+ };
1359
+ };
1360
+ pillars: {
1361
+ upper: {
1362
+ left: boolean;
1363
+ middle: boolean;
1364
+ right: boolean;
1365
+ };
1366
+ lower: {
1367
+ left: boolean;
1368
+ middle: boolean;
1369
+ right: boolean;
1370
+ };
1371
+ };
1372
+ };
1373
+ selfNucleating: boolean;
1374
+ palace: Palace;
1375
+ };
1376
+ han: HanHexagram;
1377
+ kaabalah: {
1378
+ gate: {
1379
+ upper: {
1380
+ trigram: Trigram;
1381
+ letter: {
1382
+ id: NodeId<LetterTypes.HEBREW_LETTER>;
1383
+ name: string;
1384
+ character: string | undefined;
1385
+ value: number | undefined;
1386
+ };
1387
+ path: {
1388
+ id: NodeId<KaabalahTypes.PATH>;
1389
+ number: number;
1390
+ from: {
1391
+ id: NodeId<KaabalahTypes.SPHERE>;
1392
+ name: string;
1393
+ };
1394
+ to: {
1395
+ id: NodeId<KaabalahTypes.SPHERE>;
1396
+ name: string;
1397
+ };
1398
+ };
1399
+ arcanum: {
1400
+ id: NodeId<TarotTypes.TAROT_ARK_ANNU>;
1401
+ number: number;
1402
+ name: string;
1403
+ };
1404
+ };
1405
+ lower: {
1406
+ trigram: Trigram;
1407
+ letter: {
1408
+ id: NodeId<LetterTypes.HEBREW_LETTER>;
1409
+ name: string;
1410
+ character: string | undefined;
1411
+ value: number | undefined;
1412
+ };
1413
+ path: {
1414
+ id: NodeId<KaabalahTypes.PATH>;
1415
+ number: number;
1416
+ from: {
1417
+ id: NodeId<KaabalahTypes.SPHERE>;
1418
+ name: string;
1419
+ };
1420
+ to: {
1421
+ id: NodeId<KaabalahTypes.SPHERE>;
1422
+ name: string;
1423
+ };
1424
+ };
1425
+ arcanum: {
1426
+ id: NodeId<TarotTypes.TAROT_ARK_ANNU>;
1427
+ number: number;
1428
+ name: string;
1429
+ };
1430
+ };
1431
+ order: "upper-lower";
1432
+ };
1433
+ rulingArcanum: {
1434
+ trigram: Trigram;
1435
+ letter: {
1436
+ id: NodeId<LetterTypes.HEBREW_LETTER>;
1437
+ name: string;
1438
+ character: string | undefined;
1439
+ value: number | undefined;
1440
+ };
1441
+ path: {
1442
+ id: NodeId<KaabalahTypes.PATH>;
1443
+ number: number;
1444
+ from: {
1445
+ id: NodeId<KaabalahTypes.SPHERE>;
1446
+ name: string;
1447
+ };
1448
+ to: {
1449
+ id: NodeId<KaabalahTypes.SPHERE>;
1450
+ name: string;
1451
+ };
1452
+ };
1453
+ arcanum: {
1454
+ id: NodeId<TarotTypes.TAROT_ARK_ANNU>;
1455
+ number: number;
1456
+ name: string;
1457
+ };
1458
+ };
1459
+ family: {
1460
+ upper: {
1461
+ trigram: Trigram;
1462
+ family: string;
1463
+ sphere: {
1464
+ id: NodeId<KaabalahTypes.SPHERE>;
1465
+ name: string;
1466
+ };
1467
+ };
1468
+ lower: {
1469
+ trigram: Trigram;
1470
+ family: string;
1471
+ sphere: {
1472
+ id: NodeId<KaabalahTypes.SPHERE>;
1473
+ name: string;
1474
+ };
1475
+ };
1476
+ };
1477
+ pillars: {
1478
+ upper: {
1479
+ left: boolean;
1480
+ middle: boolean;
1481
+ right: boolean;
1482
+ };
1483
+ lower: {
1484
+ left: boolean;
1485
+ middle: boolean;
1486
+ right: boolean;
1487
+ };
1488
+ };
1489
+ };
1490
+ sovereign: Readonly<{
1491
+ hexagramNumber: 2 | 1 | 11 | 33 | 44 | 24 | 12 | 19 | 20 | 43 | 34 | 23;
1492
+ lunarMonth: 2 | 1 | 4 | 11 | 9 | 10 | 7 | 6 | 12 | 3 | 8 | 5;
1493
+ branch: "子" | "丑" | "寅" | "卯" | "辰" | "巳" | "午" | "未" | "申" | "酉" | "戌" | "亥";
1494
+ approximateSolarWindow: Readonly<{
1495
+ start: Readonly<{
1496
+ month: 2 | 1 | 4 | 11 | 9 | 10 | 7 | 6 | 12 | 3 | 8 | 5;
1497
+ day: 4 | 7 | 6 | 8 | 5;
1498
+ }>;
1499
+ end: Readonly<{
1500
+ month: 2 | 1 | 4 | 11 | 9 | 10 | 7 | 6 | 12 | 3 | 8 | 5;
1501
+ day: 4 | 7 | 6 | 3 | 5;
1502
+ }>;
1503
+ }>;
1504
+ }> | null;
1505
+ } | null;
1506
+ oracle: {
1507
+ text: ClassicalTextContent;
1508
+ hexagramNumber: number;
1509
+ hanzi: string;
1510
+ kind: "line" | "judgment" | "useNine" | "useSix";
1511
+ line: LinePosition | null;
1512
+ primary: boolean;
1513
+ }[];
1514
+ lines: CastLines;
1515
+ lineCode: string;
1516
+ movingLines: readonly LinePosition[];
1517
+ lineTransforms: readonly LineTransform[];
1518
+ };
1519
+ type IChingReadingContent = ReturnType<typeof getIChingReadingContent>;
1520
+ /** Dates and question are caller-supplied labels; this helper never supplies a clock or interpretation. */
1521
+ declare function formatRecord(input: CastInput, labels?: {
1522
+ date?: string;
1523
+ question?: string;
1524
+ }): string;
1525
+ declare const ICHING_RECORD_LABELS: {
1526
+ readonly record: {
1527
+ readonly en: string;
1528
+ readonly pt: string;
1529
+ };
1530
+ readonly question: {
1531
+ readonly en: string;
1532
+ readonly pt: string;
1533
+ };
1534
+ readonly notSupplied: {
1535
+ readonly en: string;
1536
+ readonly pt: string;
1537
+ };
1538
+ readonly lines: {
1539
+ readonly en: string;
1540
+ readonly pt: string;
1541
+ };
1542
+ readonly cast: {
1543
+ readonly en: string;
1544
+ readonly pt: string;
1545
+ };
1546
+ readonly moving: {
1547
+ readonly en: string;
1548
+ readonly pt: string;
1549
+ };
1550
+ readonly transformed: {
1551
+ readonly en: string;
1552
+ readonly pt: string;
1553
+ };
1554
+ readonly none: {
1555
+ readonly en: string;
1556
+ readonly pt: string;
1557
+ };
1558
+ readonly nuclear: {
1559
+ readonly en: string;
1560
+ readonly pt: string;
1561
+ };
1562
+ readonly palace: {
1563
+ readonly en: string;
1564
+ readonly pt: string;
1565
+ };
1566
+ readonly castState: {
1567
+ readonly en: string;
1568
+ readonly pt: string;
1569
+ };
1570
+ readonly transformedState: {
1571
+ readonly en: string;
1572
+ readonly pt: string;
1573
+ };
1574
+ readonly selfNucleating: {
1575
+ readonly en: string;
1576
+ readonly pt: string;
1577
+ };
1578
+ readonly line: {
1579
+ readonly en: string;
1580
+ readonly pt: string;
1581
+ };
1582
+ readonly gate: {
1583
+ readonly en: string;
1584
+ readonly pt: string;
1585
+ };
1586
+ readonly upperLower: {
1587
+ readonly en: string;
1588
+ readonly pt: string;
1589
+ };
1590
+ readonly path: {
1591
+ readonly en: string;
1592
+ readonly pt: string;
1593
+ };
1594
+ readonly ruling: {
1595
+ readonly en: string;
1596
+ readonly pt: string;
1597
+ };
1598
+ readonly family: {
1599
+ readonly en: string;
1600
+ readonly pt: string;
1601
+ };
1602
+ readonly pillars: {
1603
+ readonly en: string;
1604
+ readonly pt: string;
1605
+ };
1606
+ readonly leftMiddleRight: {
1607
+ readonly en: string;
1608
+ readonly pt: string;
1609
+ };
1610
+ readonly upper: {
1611
+ readonly en: string;
1612
+ readonly pt: string;
1613
+ };
1614
+ readonly lower: {
1615
+ readonly en: string;
1616
+ readonly pt: string;
1617
+ };
1618
+ readonly on: {
1619
+ readonly en: string;
1620
+ readonly pt: string;
1621
+ };
1622
+ readonly off: {
1623
+ readonly en: string;
1624
+ readonly pt: string;
1625
+ };
1626
+ readonly transform: {
1627
+ readonly en: string;
1628
+ readonly pt: string;
1629
+ };
1630
+ readonly castPalace: {
1631
+ readonly en: string;
1632
+ readonly pt: string;
1633
+ };
1634
+ readonly binary: {
1635
+ readonly en: string;
1636
+ readonly pt: string;
1637
+ };
1638
+ readonly oracle: {
1639
+ readonly en: string;
1640
+ readonly pt: string;
1641
+ };
1642
+ readonly primary: {
1643
+ readonly en: string;
1644
+ readonly pt: string;
1645
+ };
1646
+ readonly judgment: {
1647
+ readonly en: string;
1648
+ readonly pt: string;
1649
+ };
1650
+ readonly useNine: {
1651
+ readonly en: string;
1652
+ readonly pt: string;
1653
+ };
1654
+ readonly useSix: {
1655
+ readonly en: string;
1656
+ readonly pt: string;
1657
+ };
1658
+ readonly wood: {
1659
+ readonly en: string;
1660
+ readonly pt: string;
1661
+ };
1662
+ readonly fire: {
1663
+ readonly en: string;
1664
+ readonly pt: string;
1665
+ };
1666
+ readonly earth: {
1667
+ readonly en: string;
1668
+ readonly pt: string;
1669
+ };
1670
+ readonly metal: {
1671
+ readonly en: string;
1672
+ readonly pt: string;
1673
+ };
1674
+ readonly water: {
1675
+ readonly en: string;
1676
+ readonly pt: string;
1677
+ };
1678
+ readonly noBranch: {
1679
+ readonly en: string;
1680
+ readonly pt: string;
1681
+ };
1682
+ };
1683
+ /** Human-readable record in Portuguese for pt/pt-BR; the existing English formatter stays unchanged. */
1684
+ declare function formatRecordContent(input: CastInput, language?: string, supplied?: {
928
1685
  date?: string;
929
1686
  question?: string;
930
1687
  }): string;
931
1688
 
932
- export { type CastInput, type CastLines, type ClassicalText, type Generation, HEXAGRAMS, HEXAGRAMS_BY_NUMBER, HEXAGRAM_DESCRIPTIONS, HEXAGRAM_NAMES_PT, type HanHexagram, type HanLine, type Hexagram, type HexagramDescription, type HexagramText, type IChingReading, LINE_POSITIONS, type LinePosition, type LineTransform, type LineValue, PALACE_TABLE, PHASE_HANZI, type Palace, type Phase, type PhaseRelation, type Relative, SOVEREIGN_HEXAGRAMS, TRIGRAMS, type TextSelection, type Trigram, type TrigramId, castThreeCoins, formatRecord, getBranchRelation, getCastHexagram, getFamilySphere, getHanHexagram, getHexagram, getHexagramByBinary, getHexagramByTrigrams, getHexagramDescription, getHexagramKaabalah, getHexagramName, getIChingReading, getLineTransforms, getMovingLines, getNuclearHexagram, getPalace, getPhaseRelation, getSixRelative, getSovereignHexagram, getTransformedHexagram, getTrigram, getTrigramGate, getTrigramPillars, linesFromHexagram, listHexagramGates, parseCastLines, selectZhuXiTexts };
1689
+ export { type CastInput, type CastLines, type ClassicalText, type ClassicalTextContent, type Generation, HEXAGRAMS, HEXAGRAMS_BY_NUMBER, HEXAGRAM_DESCRIPTIONS, HEXAGRAM_NAMES_PT, HEXAGRAM_TEXTS, type HanHexagram, type HanLine, type Hexagram, type HexagramDescription, type HexagramText, type HexagramTextContent, ICHING_RECORD_LABELS, type IChingReading, type IChingReadingContent, LINE_POSITIONS, type LinePosition, type LineTransform, type LineValue, PALACE_TABLE, PHASE_HANZI, type Palace, type Phase, type PhaseRelation, type Relative, SOVEREIGN_HEXAGRAMS, TRIGRAMS, type TextSelection, type Trigram, type TrigramId, castThreeCoins, formatRecord, formatRecordContent, getBranchRelation, getCastHexagram, getFamilySphere, getHanHexagram, getHexagram, getHexagramByBinary, getHexagramByTrigrams, getHexagramDescription, getHexagramKaabalah, getHexagramName, getHexagramText, getIChingReading, getIChingReadingContent, getLineTransforms, getMovingLines, getNuclearHexagram, getOracleTextContent, getPalace, getPhaseRelation, getSixRelative, getSovereignHexagram, getTransformedHexagram, getTrigram, getTrigramGate, getTrigramPillars, linesFromHexagram, listHexagramGates, parseCastLines, selectZhuXiTexts };