kaabalah 6.16.0 → 6.18.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 +3532 -151
  3. package/dist/astrology/index.d.ts +3532 -151
  4. package/dist/astrology/index.js +977 -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-LQVHJ3VY.mjs → chunk-4RCPLGM2.mjs} +41 -41
  9. package/dist/{chunk-LQVHJ3VY.mjs.map → chunk-4RCPLGM2.mjs.map} +1 -1
  10. package/dist/chunk-4WVN4RMM.mjs +1139 -0
  11. package/dist/chunk-4WVN4RMM.mjs.map +1 -0
  12. package/dist/{chunk-J5Y325TG.mjs → chunk-4ZFY3GBP.mjs} +2210 -3
  13. package/dist/chunk-4ZFY3GBP.mjs.map +1 -0
  14. package/dist/chunk-66XGIFHW.js +23683 -0
  15. package/dist/chunk-66XGIFHW.js.map +1 -0
  16. package/dist/{chunk-PBBF5DKC.js → chunk-6SBCBVTZ.js} +21 -21
  17. package/dist/{chunk-CMXTZKWW.js → chunk-CHZUOTVW.js} +157 -157
  18. package/dist/{chunk-CMXTZKWW.js.map → chunk-CHZUOTVW.js.map} +1 -1
  19. package/dist/{chunk-WP5MRAYG.mjs → chunk-COEM6U4V.mjs} +3 -4
  20. package/dist/chunk-COEM6U4V.mjs.map +1 -0
  21. package/dist/chunk-CPXGTH2D.mjs +23395 -0
  22. package/dist/chunk-CPXGTH2D.mjs.map +1 -0
  23. package/dist/{chunk-3JMY4U4S.mjs → chunk-DBRPCQRR.mjs} +245 -211
  24. package/dist/chunk-DBRPCQRR.mjs.map +1 -0
  25. package/dist/{chunk-WRF3EORB.js → chunk-DCJYTCJZ.js} +16 -17
  26. package/dist/chunk-DCJYTCJZ.js.map +1 -0
  27. package/dist/{chunk-UO2RQQZO.mjs → chunk-DK2VS36Z.mjs} +2 -2
  28. package/dist/{chunk-HEZCZXQC.js → chunk-E353GPHE.js} +16 -16
  29. package/dist/{chunk-6LZOAU6E.js → chunk-GDJSVV46.js} +272 -241
  30. package/dist/chunk-GDJSVV46.js.map +1 -0
  31. package/dist/{chunk-Z3JZ5DZN.mjs → chunk-IZBM4CPN.mjs} +2 -2
  32. package/dist/{chunk-7OWGGDRF.js → chunk-JFRVH3TD.js} +2288 -80
  33. package/dist/chunk-JFRVH3TD.js.map +1 -0
  34. package/dist/chunk-MZBY6G5S.js +1182 -0
  35. package/dist/chunk-MZBY6G5S.js.map +1 -0
  36. package/dist/{chunk-7JWBIAUF.mjs → chunk-NS5AXNEW.mjs} +3 -3
  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 +34679 -11579
  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 +1652 -403
  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
@@ -1,237 +1,7 @@
1
- declare enum HeptadCycles {
2
- First = 1,
3
- Second = 2,
4
- Third = 3,
5
- Fourth = 4,
6
- Fifth = 5,
7
- Sixth = 6,
8
- Seventh = 7
9
- }
10
- type CycleMeaning = {
11
- title: string;
12
- shortDescription: string;
13
- personalDescription: string;
14
- businessDescription: string;
15
- };
16
- type Cycle = {
17
- number: number;
18
- description: CycleMeaning;
19
- isActive?: boolean;
20
- cycleStart?: Date;
21
- };
22
- type CycleInfo = {
23
- yearlyCycles: Cycle[];
24
- ageCycles: Cycle[];
25
- monthlyCycles: Cycle[];
26
- currentYearlyCycle: number | null;
27
- currentAgeCycle: number | null;
28
- currentMonthlyCycle: number | null;
29
- daysInMonthlyCycle: number;
30
- totalDays: number;
31
- };
32
- type KaabalisticLifePathResult = {
33
- parts: {
34
- day: string;
35
- month: string;
36
- year1: string;
37
- year2: string;
38
- };
39
- reducedParts: {
40
- reducedDay: number;
41
- reducedMonth: number;
42
- reducedYear1: number;
43
- reducedYear2: number;
44
- };
45
- syntheses: {
46
- dayMonthSynthesis: number;
47
- yearSynthesis: number;
48
- reducedDayMonthSynthesis: number;
49
- reducedYearSynthesis: number;
50
- finalSynthesis: number;
51
- };
52
- lifePath: ReducedValueWithSteps;
53
- /**
54
- * Last three syntheses
55
- */
56
- personalMythologyNumbers: number[];
57
- };
58
- type StraightAcrossReductionLifePathResult = {
59
- dayEnergy: ReducedValueWithSteps;
60
- monthEnergy: ReducedValueWithSteps;
61
- yearEnergy: ReducedValueWithSteps;
62
- lifePath: ReducedValueWithSteps;
63
- };
64
- type DateEnergies = {
65
- dayEnergy: ReducedValueWithSteps;
66
- monthEnergy: ReducedValueWithSteps;
67
- yearEnergy: ReducedValueWithSteps;
68
- };
69
- type Challenges = {
70
- day: number;
71
- month: number;
72
- year: number;
73
- mainChallenge: number;
74
- subChallenge1: number;
75
- subChallenge2: number;
76
- };
77
- type ReducedValueWithSteps = {
78
- reducedValue: number;
79
- reductionSteps: number[];
80
- };
81
- type FibonacciCycle = {
82
- currentAge: number;
83
- cycle1: ReducedValueWithSteps;
84
- cycle2: ReducedValueWithSteps;
85
- cycle3: ReducedValueWithSteps;
86
- cycle4: ReducedValueWithSteps;
87
- cycle5: ReducedValueWithSteps;
88
- cycle6: ReducedValueWithSteps;
89
- cycle7: ReducedValueWithSteps;
90
- };
91
- type PersonalPeriod = {
92
- startMonth: number;
93
- endMonth: number;
94
- value: ReducedValueWithSteps;
95
- };
96
- type PersonalMonth = {
97
- month: number;
98
- value: ReducedValueWithSteps;
99
- };
100
- type PersonalCycles = {
101
- personalYear: ReducedValueWithSteps;
102
- personalPeriods: [PersonalPeriod, PersonalPeriod, PersonalPeriod];
103
- personalMonths: [
104
- PersonalMonth,
105
- PersonalMonth,
106
- PersonalMonth,
107
- PersonalMonth,
108
- PersonalMonth,
109
- PersonalMonth,
110
- PersonalMonth,
111
- PersonalMonth,
112
- PersonalMonth,
113
- PersonalMonth,
114
- PersonalMonth,
115
- PersonalMonth,
116
- PersonalMonth
117
- ];
118
- currentPersonalPeriod: number;
119
- currentPersonalMonth: number;
120
- currentAge: number;
121
- lifePath: ReducedValueWithSteps;
122
- soulNumber?: ReducedValueWithSteps;
123
- yearUsedOnCalculations: number;
124
- };
125
- declare const CYCLE_MEANINGS: Record<HeptadCycles, CycleMeaning>;
126
- declare enum NumerologyValues {
127
- One = 1,
128
- Two = 2,
129
- Three = 3,
130
- Four = 4,
131
- Five = 5,
132
- Six = 6,
133
- Seven = 7,
134
- Eight = 8,
135
- Nine = 9,
136
- Eleven = 11,
137
- TwentyTwo = 22,
138
- ThirtyThree = 33,
139
- FortyFour = 44
140
- }
141
- declare const NUMEROLOGY_KEYWORDS: Record<NumerologyValues, string[]>;
142
- declare enum DayOfBirth {
143
- First = 1,
144
- Second = 2,
145
- Third = 3,
146
- Fourth = 4,
147
- Fifth = 5,
148
- Sixth = 6,
149
- Seventh = 7,
150
- Eighth = 8,
151
- Ninth = 9,
152
- Tenth = 10,
153
- Eleventh = 11,
154
- Twelfth = 12,
155
- Thirteenth = 13,
156
- Fourteenth = 14,
157
- Fifteenth = 15,
158
- Sixteenth = 16,
159
- Seventeenth = 17,
160
- Eighteenth = 18,
161
- Nineteenth = 19,
162
- Twentieth = 20,
163
- TwentyFirst = 21,
164
- TwentySecond = 22,
165
- TwentyThird = 23,
166
- TwentyFourth = 24,
167
- TwentyFifth = 25,
168
- TwentySixth = 26,
169
- TwentySeventh = 27,
170
- TwentyEighth = 28,
171
- TwentyNinth = 29,
172
- Thirtieth = 30,
173
- ThirtyFirst = 31
174
- }
175
- type DayOfBirthMeaning = {
176
- description: string;
177
- };
178
- declare const DAY_OF_BIRTH_MEANING: Record<DayOfBirth, DayOfBirthMeaning>;
179
- type LifePathMeaning = {
180
- description: string;
181
- goal: string;
182
- positiveTraits: string[];
183
- negativeTraits: string[];
184
- };
185
- declare const LIFEPATH_MEANING: Record<NumerologyValues, LifePathMeaning>;
186
- declare enum ChallengeNumbers {
187
- Zero = 0,
188
- One = 1,
189
- Two = 2,
190
- Three = 3,
191
- Four = 4,
192
- Five = 5,
193
- Six = 6,
194
- Seven = 7,
195
- Eight = 8
196
- }
197
- declare const CHALLENGE_MEANING: Record<ChallengeNumbers, string>;
198
- declare const CHALLENGE_HEALTH_MEANING: Record<ChallengeNumbers | NumerologyValues, string>;
199
- declare const PERSONAL_CYCLE_KEYWORDS: Record<NumerologyValues, string[]>;
200
- declare const PERSONAL_YEAR_DESCRIPTIONS: Record<NumerologyValues, string>;
201
-
202
- declare const data_CHALLENGE_HEALTH_MEANING: typeof CHALLENGE_HEALTH_MEANING;
203
- declare const data_CHALLENGE_MEANING: typeof CHALLENGE_MEANING;
204
- declare const data_CYCLE_MEANINGS: typeof CYCLE_MEANINGS;
205
- type data_ChallengeNumbers = ChallengeNumbers;
206
- declare const data_ChallengeNumbers: typeof ChallengeNumbers;
207
- type data_Challenges = Challenges;
208
- type data_Cycle = Cycle;
209
- type data_CycleInfo = CycleInfo;
210
- type data_CycleMeaning = CycleMeaning;
211
- declare const data_DAY_OF_BIRTH_MEANING: typeof DAY_OF_BIRTH_MEANING;
212
- type data_DateEnergies = DateEnergies;
213
- type data_DayOfBirth = DayOfBirth;
214
- declare const data_DayOfBirth: typeof DayOfBirth;
215
- type data_DayOfBirthMeaning = DayOfBirthMeaning;
216
- type data_FibonacciCycle = FibonacciCycle;
217
- type data_HeptadCycles = HeptadCycles;
218
- declare const data_HeptadCycles: typeof HeptadCycles;
219
- type data_KaabalisticLifePathResult = KaabalisticLifePathResult;
220
- declare const data_LIFEPATH_MEANING: typeof LIFEPATH_MEANING;
221
- type data_LifePathMeaning = LifePathMeaning;
222
- declare const data_NUMEROLOGY_KEYWORDS: typeof NUMEROLOGY_KEYWORDS;
223
- type data_NumerologyValues = NumerologyValues;
224
- declare const data_NumerologyValues: typeof NumerologyValues;
225
- declare const data_PERSONAL_CYCLE_KEYWORDS: typeof PERSONAL_CYCLE_KEYWORDS;
226
- declare const data_PERSONAL_YEAR_DESCRIPTIONS: typeof PERSONAL_YEAR_DESCRIPTIONS;
227
- type data_PersonalCycles = PersonalCycles;
228
- type data_PersonalMonth = PersonalMonth;
229
- type data_PersonalPeriod = PersonalPeriod;
230
- type data_ReducedValueWithSteps = ReducedValueWithSteps;
231
- type data_StraightAcrossReductionLifePathResult = StraightAcrossReductionLifePathResult;
232
- declare namespace data {
233
- export { data_CHALLENGE_HEALTH_MEANING as CHALLENGE_HEALTH_MEANING, data_CHALLENGE_MEANING as CHALLENGE_MEANING, data_CYCLE_MEANINGS as CYCLE_MEANINGS, data_ChallengeNumbers as ChallengeNumbers, type data_Challenges as Challenges, type data_Cycle as Cycle, type data_CycleInfo as CycleInfo, type data_CycleMeaning as CycleMeaning, data_DAY_OF_BIRTH_MEANING as DAY_OF_BIRTH_MEANING, type data_DateEnergies as DateEnergies, data_DayOfBirth as DayOfBirth, type data_DayOfBirthMeaning as DayOfBirthMeaning, type data_FibonacciCycle as FibonacciCycle, data_HeptadCycles as HeptadCycles, type data_KaabalisticLifePathResult as KaabalisticLifePathResult, data_LIFEPATH_MEANING as LIFEPATH_MEANING, type data_LifePathMeaning as LifePathMeaning, data_NUMEROLOGY_KEYWORDS as NUMEROLOGY_KEYWORDS, data_NumerologyValues as NumerologyValues, data_PERSONAL_CYCLE_KEYWORDS as PERSONAL_CYCLE_KEYWORDS, data_PERSONAL_YEAR_DESCRIPTIONS as PERSONAL_YEAR_DESCRIPTIONS, type data_PersonalCycles as PersonalCycles, type data_PersonalMonth as PersonalMonth, type data_PersonalPeriod as PersonalPeriod, type data_ReducedValueWithSteps as ReducedValueWithSteps, type data_StraightAcrossReductionLifePathResult as StraightAcrossReductionLifePathResult };
234
- }
1
+ import { H as HeptadCycles, C as CycleMeaning, N as NumerologyValues, D as DayOfBirth, e as DayOfBirthMeaning, L as LifePathMeaning, f as ChallengeNumbers, g as DateEnergies, h as Challenges, j as CycleInfo, F as FibonacciCycle, R as ReducedValueWithSteps, U as UnavailableValue, P as PersonalPeriod, k as PersonalCycles } from '../core-B3_-9yli.mjs';
2
+ export { M as MASTER_NUMBERS, d as NumerologyData, d as NumerologyModuleTypes, c as calculateKaabalisticLifePath, a as calculateStraightAcrossReductionLifePath, i as isMasterNumber, r as reduceToSingle, b as reduceToSingleWithSteps } from '../core-B3_-9yli.mjs';
3
+ import { R as ReducedNumber, e as ShortMonthPolicy, n as Unavailable, s as NormalizedBirth, p as NumerologyMethodMetadata, L as LifePathMethod, m as ScheduleInput, C as CivilDateInput, P as PartialBirthDate, l as ScheduleOptions, v as CivilDate, f as MasterPolicy, j as LifeStageOptions } from '../schedule-types-DsR1_guG.mjs';
4
+ export { B as BirthInput, D as DEFAULT_MAX_TIMELINE_INTERVALS, i as LifePeriodRule, c as MAX_CANDIDATE_DATES, M as MAX_SCHEDULE_YEAR, b as MAX_TIMELINE_INTERVALS_HARD_CAP, a as MAX_TIMELINE_RANGE_DAYS, o as MethodDescriptor, g as NameInputKind, N as NumerologyErrorCode, d as NumerologyScheduleError, h as PinnacleTransitionRule, S as SCHEDULE_METHOD_VERSION, k as ScheduleLimits, U as UnavailableReason, q as fmt, t as normalizeBirth, r as resolveCivilDate, u as unavailable } from '../schedule-types-DsR1_guG.mjs';
235
5
 
236
6
  declare const en: {
237
7
  CYCLE_MEANINGS: Record<HeptadCycles, CycleMeaning>;
@@ -1105,26 +875,430 @@ declare function getNumerologyData(language?: string): {
1105
875
  };
1106
876
 
1107
877
  /**
1108
- * Numerology calculations
878
+ * Dated numerology schedule facade.
879
+ *
880
+ * Pure, civil-date based (no timezone, no `Date`, no local-noon trick for
881
+ * callers). Provides:
882
+ * - `getNumerologySnapshot`: everything active on one civil day;
883
+ * - `generateNumerologyTimeline`: bounded, half-open intervals for chosen layers;
884
+ * - `getNumerologyMethodMetadata`: the explicit method identity.
885
+ *
886
+ * Layers: birthday frame (`personal-year`, `personal-month`, `personal-period`,
887
+ * `heptad`, `age-cycle`, `fibonacci`), life stages (`pinnacle`, `challenge`,
888
+ * `life-period`) and the distinct calendar frame (`calendar-year`,
889
+ * `calendar-month`, `calendar-day`).
890
+ *
891
+ * Every interval is `[start, endExclusive)` in "YYYY-MM-DD". When limits
892
+ * (birth, death, horizon) cut an interval, `nominalStart/nominalEndExclusive`
893
+ * keep the unclipped bounds and `clipped` is true. A missing death date means
894
+ * nothing about survival: no end is inferred.
1109
895
  */
1110
896
 
1111
- declare const MASTER_NUMBERS: number[];
1112
- declare function isMasterNumber(n: number): boolean;
1113
- declare function reduceToSingle(n: number, options?: {
1114
- preserveMasters?: boolean;
1115
- }): number;
1116
- declare function reduceToSingleWithSteps(n: number, options?: {
1117
- preserveMasters?: boolean;
1118
- }): ReducedValueWithSteps;
897
+ interface ScheduleIntervalBase {
898
+ /** Inclusive start, "YYYY-MM-DD" (possibly clipped to the birth date). */
899
+ start: string;
900
+ /** Exclusive end, "YYYY-MM-DD" (possibly clipped by death/horizon). `null` only for open-ended life stages with no horizon. */
901
+ endExclusive: string | null;
902
+ nominalStart: string;
903
+ /** `null` for open-ended spans and when the real end is past year 9999 (then `nominalEndBeyondCalendar` is true). */
904
+ nominalEndExclusive: string | null;
905
+ /** True only when the nominal end falls after the last supported calendar year (9999) and so cannot be dated. */
906
+ nominalEndBeyondCalendar?: true;
907
+ startClipped: boolean;
908
+ endClipped: boolean;
909
+ /** True when the start or the end was clipped by birth/death/horizon limits. */
910
+ clipped: boolean;
911
+ lengthDays: number | null;
912
+ nominalLengthDays: number | null;
913
+ }
914
+ interface AgeCycleRef {
915
+ /** Repeating 1-7 label of the seven-year block. */
916
+ label: number;
917
+ /** Absolute 0-based seven-year block index from birth (`floor(completedAge / 7)`). */
918
+ absoluteIndex: number;
919
+ /** Year within the block, 1-7 (`completedAge % 7 + 1`). */
920
+ yearPosition: number;
921
+ }
922
+ interface PersonalYearInterval extends ScheduleIntervalBase {
923
+ layer: "personal-year";
924
+ birthdayYear: number;
925
+ completedAge: number | null;
926
+ personalYear: ReducedNumber;
927
+ ageCycle: AgeCycleRef | null;
928
+ }
929
+ interface PersonalMonthInterval extends ScheduleIntervalBase {
930
+ layer: "personal-month";
931
+ birthdayYear: number;
932
+ /** Phase number 1-12 (position in the birthday year). */
933
+ phase: number;
934
+ /** Nominal calendar-month label 1-12 used in the value (kept even when the phase starts in another month). */
935
+ calendarMonth: number;
936
+ intendedBirthDay: number;
937
+ /** Reduced value, kept separate from `phase`. */
938
+ value: ReducedNumber;
939
+ /** True when the phase start differs from the nominal `YYYY-MM-<birthDay>` date. */
940
+ startAdjusted: boolean;
941
+ /** Nominal start as text; may be an impossible date such as "2025-02-31". */
942
+ nominalStartText: string;
943
+ shortMonthPolicy: ShortMonthPolicy;
944
+ }
945
+ type PersonalPeriodValue = (ReducedNumber & {
946
+ available: true;
947
+ addend: number;
948
+ addendSource: "completed-age" | "life-path" | "first-name-soul-number";
949
+ }) | Unavailable;
950
+ interface PersonalPeriodInterval extends ScheduleIntervalBase {
951
+ layer: "personal-period";
952
+ birthdayYear: number;
953
+ /** Phase number 1-3 (four months each). */
954
+ phase: number;
955
+ /** First/last personal-month phase covered, 1-12. */
956
+ monthPhases: [number, number];
957
+ startCalendarMonth: number;
958
+ endCalendarMonth: number;
959
+ value: PersonalPeriodValue;
960
+ }
961
+ interface HeptadInterval extends ScheduleIntervalBase {
962
+ layer: "heptad";
963
+ birthdayYear: number;
964
+ /** Phase number 1-7. */
965
+ phase: number;
966
+ /** True for the seventh segment, which spans the actual remainder to the next birthday (53/54 days). */
967
+ isRemainder: boolean;
968
+ }
969
+ interface AgeCycleInterval extends ScheduleIntervalBase {
970
+ layer: "age-cycle";
971
+ label: number;
972
+ absoluteIndex: number;
973
+ startAge: number;
974
+ endAgeExclusive: number;
975
+ }
976
+ interface FibonacciInterval extends ScheduleIntervalBase {
977
+ layer: "fibonacci";
978
+ birthdayYear: number;
979
+ completedAge: number;
980
+ /** Seven cycles; single-digit reductions (masters NOT preserved). */
981
+ cycles: {
982
+ phase: number;
983
+ value: number;
984
+ reductionSteps: number[];
985
+ }[];
986
+ }
987
+ interface CalendarYearInterval extends ScheduleIntervalBase {
988
+ layer: "calendar-year";
989
+ year: number;
990
+ personalYear: ReducedNumber;
991
+ }
992
+ interface CalendarMonthInterval extends ScheduleIntervalBase {
993
+ layer: "calendar-month";
994
+ year: number;
995
+ month: number;
996
+ personalYear: ReducedNumber;
997
+ personalMonth: ReducedNumber;
998
+ }
999
+ interface CalendarDayInterval extends ScheduleIntervalBase {
1000
+ layer: "calendar-day";
1001
+ date: string;
1002
+ personalYear: ReducedNumber;
1003
+ personalMonth: ReducedNumber;
1004
+ personalDay: ReducedNumber;
1005
+ }
1006
+ interface PinnacleInterval extends ScheduleIntervalBase {
1007
+ layer: "pinnacle";
1008
+ index: number;
1009
+ startAge: number;
1010
+ endAgeExclusive: number | null;
1011
+ value: ReducedNumber;
1012
+ }
1013
+ interface ChallengeInterval extends ScheduleIntervalBase {
1014
+ layer: "challenge";
1015
+ index: number;
1016
+ isMain: boolean;
1017
+ startAge: number;
1018
+ endAgeExclusive: number | null;
1019
+ value: number;
1020
+ }
1021
+ interface LifePeriodInterval extends ScheduleIntervalBase {
1022
+ layer: "life-period";
1023
+ index: number;
1024
+ basis: "month" | "day" | "year";
1025
+ startAge: number;
1026
+ endAgeExclusive: number | null;
1027
+ value: ReducedNumber;
1028
+ }
1029
+ type ScheduleInterval = PersonalYearInterval | PersonalMonthInterval | PersonalPeriodInterval | HeptadInterval | AgeCycleInterval | FibonacciInterval | CalendarYearInterval | CalendarMonthInterval | CalendarDayInterval | PinnacleInterval | ChallengeInterval | LifePeriodInterval;
1030
+ type TimelineLayer = ScheduleInterval["layer"];
1031
+ declare const TIMELINE_LAYERS: readonly TimelineLayer[];
1032
+ type SnapshotStatus = "ok" | "partial" | "before-birth" | "after-death" | "after-horizon";
1033
+ interface NumerologySnapshot {
1034
+ asOf: string;
1035
+ status: SnapshotStatus;
1036
+ birth: {
1037
+ kind: NormalizedBirth["kind"];
1038
+ date?: string;
1039
+ month?: number;
1040
+ day?: number;
1041
+ year?: number;
1042
+ approximate?: boolean;
1043
+ };
1044
+ meta: NumerologyMethodMetadata;
1045
+ /** Completed (birthday) age; `null` unless the full birth date is known. */
1046
+ completedAge: number | null;
1047
+ /** Possible completed ages when only a year (or year and month) is known. */
1048
+ completedAgeRange: {
1049
+ min: number;
1050
+ max: number;
1051
+ } | null;
1052
+ lastBirthdayYear: number | null;
1053
+ /** 1-based day within the birthday year. */
1054
+ dayInBirthdayYear: number | null;
1055
+ fixedNumbers: {
1056
+ lifePath: (ReducedNumber & {
1057
+ available: true;
1058
+ method: LifePathMethod;
1059
+ }) | Unavailable;
1060
+ firstNameSoulNumber: (ReducedNumber & {
1061
+ available: true;
1062
+ }) | Unavailable;
1063
+ };
1064
+ birthdayYear: PersonalYearInterval | null;
1065
+ personalMonth: PersonalMonthInterval | null;
1066
+ personalPeriod: PersonalPeriodInterval | null;
1067
+ heptad: (HeptadInterval & {
1068
+ dayInHeptad: number;
1069
+ }) | null;
1070
+ ageCycle: (AgeCycleInterval & {
1071
+ yearPosition: number;
1072
+ }) | null;
1073
+ fibonacci: FibonacciInterval | null;
1074
+ calendar: {
1075
+ personalYear: ReducedNumber;
1076
+ personalMonth: ReducedNumber;
1077
+ personalDay: ReducedNumber;
1078
+ } | null;
1079
+ lifeStages: {
1080
+ pinnacle: PinnacleInterval | null;
1081
+ challenge: ChallengeInterval | null;
1082
+ lifePeriod: LifePeriodInterval | null;
1083
+ mainChallenge: number;
1084
+ transition: {
1085
+ rule: string;
1086
+ lifePathForTransition: number;
1087
+ firstPinnacleEndAge: number;
1088
+ };
1089
+ } | null;
1090
+ unavailable: {
1091
+ field: string;
1092
+ reason: Unavailable["reason"];
1093
+ detail: string;
1094
+ }[];
1095
+ }
1096
+ interface NumerologyTimeline {
1097
+ from: string;
1098
+ toExclusive: string;
1099
+ layers: TimelineLayer[];
1100
+ meta: NumerologyMethodMetadata;
1101
+ /** Intervals overlapping `[from, toExclusive)`, with their real (not window-clipped) bounds, sorted by start then layer. */
1102
+ intervals: ScheduleInterval[];
1103
+ caps: {
1104
+ maxIntervals: number;
1105
+ maxRangeDays: number;
1106
+ };
1107
+ unavailable: {
1108
+ field: string;
1109
+ reason: Unavailable["reason"];
1110
+ detail: string;
1111
+ }[];
1112
+ }
1113
+ /** Method identity for a set of options, without computing anything dated. */
1114
+ declare function getNumerologyMethodMetadata(options?: Omit<ScheduleInput, "birth"> & {
1115
+ birth?: ScheduleInput["birth"];
1116
+ }): NumerologyMethodMetadata;
1117
+ /**
1118
+ * Everything active on one civil day.
1119
+ *
1120
+ * `input.birth` may be a full date (`"YYYY-MM-DD"` / `CivilDate`) or a
1121
+ * `PartialBirthDate`. Partial dates return `status: "partial"`: month/day
1122
+ * knowledge still yields the birthday-year frame, personal months, heptads and
1123
+ * calendar frame (age-dependent values are marked unavailable); year-only or
1124
+ * year/month knowledge yields `completedAgeRange` and structured reasons, and
1125
+ * never a guessed date.
1126
+ */
1127
+ declare function getNumerologySnapshot(input: ScheduleInput & {
1128
+ asOf: CivilDateInput;
1129
+ }): NumerologySnapshot;
1130
+ interface TimelineInput extends ScheduleInput {
1131
+ /** Inclusive start of the requested window. */
1132
+ from: CivilDateInput;
1133
+ /** Exclusive end of the requested window. */
1134
+ toExclusive: CivilDateInput;
1135
+ /** Layers to generate. Default `["personal-year"]`. */
1136
+ layers?: TimelineLayer[];
1137
+ /** Interval budget (default 2000, at most 10000). Exceeding it throws `TOO_MANY_INTERVALS`; nothing is silently truncated. */
1138
+ maxIntervals?: number;
1139
+ }
1140
+ /**
1141
+ * Bounded, sorted, half-open intervals overlapping `[from, toExclusive)`.
1142
+ * Intervals keep their real bounds (they are not cut at the window edges).
1143
+ */
1144
+ declare function generateNumerologyTimeline(input: TimelineInput): NumerologyTimeline;
1145
+
1146
+ /**
1147
+ * Partial birth dates.
1148
+ *
1149
+ * `describePartialBirthDate` reports what is computable for each kind of
1150
+ * knowledge and why the rest is unavailable. `summarizeBirthDateCandidates`
1151
+ * enumerates the valid days of a known year/month (or year) INTERNALLY and
1152
+ * reports only aggregates (invariants, possible value sets, interval boundary
1153
+ * ranges). It never returns, selects or guesses a birth date.
1154
+ */
1155
+
1156
+ interface PartialDateCapability {
1157
+ kind: NormalizedBirth["kind"];
1158
+ /** Fields that can be computed from this much knowledge. */
1159
+ computable: string[];
1160
+ /** Fields that cannot, each with a structured reason. */
1161
+ unavailable: {
1162
+ field: string;
1163
+ reason: Unavailable["reason"];
1164
+ detail: string;
1165
+ }[];
1166
+ }
1167
+ declare function describePartialBirthDate(birth: PartialBirthDate | CivilDateInput): PartialDateCapability;
1168
+ interface FieldSummary {
1169
+ /** True when every candidate gives the same value (including all `null`). */
1170
+ invariant: boolean;
1171
+ /** The shared value when invariant, else `null`. */
1172
+ value: number | null;
1173
+ /** Sorted distinct values across candidates; `null` means "unavailable for some candidate". */
1174
+ possibleValues: (number | null)[];
1175
+ }
1176
+ interface BoundaryRange {
1177
+ start: {
1178
+ min: string;
1179
+ max: string;
1180
+ invariant: boolean;
1181
+ };
1182
+ endExclusive: {
1183
+ min: string;
1184
+ max: string;
1185
+ invariant: boolean;
1186
+ };
1187
+ }
1188
+ interface BirthDateCandidateSummary {
1189
+ asOf: string;
1190
+ birth: {
1191
+ kind: "year-month" | "year";
1192
+ year: number;
1193
+ month?: number;
1194
+ };
1195
+ /** Number of valid calendar days enumerated internally (they are never returned). */
1196
+ candidateCount: number;
1197
+ /** Candidates born after `asOf`, excluded from the aggregates. */
1198
+ candidatesBornAfterAsOf: number;
1199
+ /** Always false: no birth date is selected or emitted. */
1200
+ selectedDate: null;
1201
+ fields: Record<string, FieldSummary>;
1202
+ intervalBoundaryRanges: Record<string, BoundaryRange>;
1203
+ note: string;
1204
+ }
1205
+ interface CandidateSummaryInput extends ScheduleOptions {
1206
+ birth: {
1207
+ kind: "year-month";
1208
+ year: number;
1209
+ month: number;
1210
+ } | {
1211
+ kind: "year";
1212
+ year: number;
1213
+ approximate?: boolean;
1214
+ };
1215
+ asOf: CivilDateInput;
1216
+ }
1119
1217
  /**
1120
- * Calculate the Kaabalistic life path number based on a birth date.
1121
- * Note: This method produces more master numbers and never produces life path 2s (or any life path that ends with 0 like 10, 20, 30, etc.)
1218
+ * Aggregates over every valid day of the known year/month (or year).
1219
+ * The person's actual birth day stays unknown; only invariants, possible value
1220
+ * sets and boundary ranges are reported.
1122
1221
  */
1123
- declare function calculateKaabalisticLifePath(birthDate: Date): KaabalisticLifePathResult;
1222
+ declare function summarizeBirthDateCandidates(input: CandidateSummaryInput): BirthDateCandidateSummary;
1223
+
1224
+ /**
1225
+ * Pinnacles, challenges and life periods as NAMED, DOCUMENTED CONVENTIONS.
1226
+ *
1227
+ * These conventions are not universal: sources differ on the age at which the
1228
+ * first pinnacle ends, on whether master numbers survive in components, and on
1229
+ * what "three life periods" means. Every choice below is exposed through
1230
+ * `LifeStageOptions` / returned metadata. They are distinct from the three
1231
+ * four-month personal periods of the birthday year.
1232
+ *
1233
+ * Convention `kaabalah-life-stages/1`:
1234
+ * - components: month, day and year (digit sum of the full year) reduced to a
1235
+ * single digit, masters not preserved (the same components as
1236
+ * `calculateChallenges`).
1237
+ * - pinnacle 1 = month + day; 2 = day + year; 3 = P1 + P2 (reduced values);
1238
+ * 4 = month + year. Results reduced with the master policy.
1239
+ * - challenges: 1 = |month - day|; 2 = |day - year|; 3 (main) = |C1 - C2|;
1240
+ * 4 = |month - year| (single digits, 0-8).
1241
+ * - age transition: the first pinnacle/challenge ends at completed age
1242
+ * `36 - L`, L = life path reduced to a single digit (11 -> 2, 22 -> 4,
1243
+ * 33 -> 6, 44 -> 8); each following one lasts 9 years; the fourth is open.
1244
+ * `firstPinnacleEndAge` overrides this.
1245
+ * - life periods: three periods valued by month, day and year reductions
1246
+ * (master policy applied). `pinnacle-aligned-27`: [0, 36-L), 27 years, rest.
1247
+ * `fixed-28-56`: [0, 28), [28, 56), [56, open).
1248
+ */
1249
+
1250
+ declare const LIFE_STAGE_METHOD_ID = "kaabalah-life-stages/1";
1251
+ interface LifeStageSpan {
1252
+ /** 1-based position within its family. */
1253
+ index: number;
1254
+ startAge: number;
1255
+ /** `null` for the open-ended last span. */
1256
+ endAgeExclusive: number | null;
1257
+ /** `null` when the start anniversary falls after the last supported year (9999); see `startBeyondCalendar`. */
1258
+ start: CivilDate | null;
1259
+ /** `null` for the open-ended last span, or when the end falls after year 9999 (then `nominalEndBeyondCalendar` is true). */
1260
+ nominalEndExclusive: CivilDate | null;
1261
+ /** True only when the span's start is past the supported calendar (the span cannot be dated). */
1262
+ startBeyondCalendar?: true;
1263
+ /** True only when the span has an age end but its date is past the supported calendar (year > 9999). */
1264
+ nominalEndBeyondCalendar?: true;
1265
+ }
1266
+ interface Pinnacle extends LifeStageSpan {
1267
+ value: ReducedNumber;
1268
+ }
1269
+ interface Challenge extends LifeStageSpan {
1270
+ value: number;
1271
+ /** True for the third (main) challenge. */
1272
+ isMain: boolean;
1273
+ }
1274
+ interface LifePeriod extends LifeStageSpan {
1275
+ /** Which date part this period is valued by. */
1276
+ basis: "month" | "day" | "year";
1277
+ value: ReducedNumber;
1278
+ }
1279
+ interface LifeStages {
1280
+ convention: string;
1281
+ lifePathMethod: LifePathMethod;
1282
+ lifePathForTransition: number;
1283
+ transitionRule: "36-minus-life-path" | "fixed-first-end-age";
1284
+ firstPinnacleEndAge: number;
1285
+ lifePeriodRule: "pinnacle-aligned-27" | "fixed-28-56";
1286
+ masterPolicy: MasterPolicy;
1287
+ components: {
1288
+ month: number;
1289
+ day: number;
1290
+ year: number;
1291
+ };
1292
+ pinnacles: Pinnacle[];
1293
+ challenges: Challenge[];
1294
+ lifePeriods: LifePeriod[];
1295
+ }
1296
+ declare function computeLifeStages(birth: CivilDate, masters: MasterPolicy, options?: LifeStageOptions): LifeStages;
1297
+
1124
1298
  /**
1125
- * Calculate the traditional straight across reduction life path number based on a birth date.
1299
+ * Numerology calculations
1126
1300
  */
1127
- declare function calculateStraightAcrossReductionLifePath(birthDate: Date): StraightAcrossReductionLifePathResult;
1301
+
1128
1302
  /**
1129
1303
  * Dates are read with local calendar getters; construct them at local noon
1130
1304
  * (e.g. `new Date(1990, 0, 15, 12)`) to avoid day-shift at timezone extremes.
@@ -1137,25 +1311,36 @@ declare function getDateEnergies(birthDate: Date): DateEnergies;
1137
1311
  declare function calculateChallenges(birthDate: Date): Challenges;
1138
1312
  /**
1139
1313
  * Calculate cycles (annual and monthly).
1314
+ *
1315
+ * - Ages are completed (birthday) ages.
1316
+ * - `ageCycles` lists the seven blocks of the 49-year window that contains the
1317
+ * active block, labelled 1-7 with their real absolute indices; the active
1318
+ * entry carries the real start of the current block.
1319
+ * - Day counters are civil-day based (independent of DST and time of day).
1320
+ * - The seventh 52-day segment runs to the actual next birthday (53/54 days).
1321
+ *
1140
1322
  * Dates are read with local calendar getters; construct them at local noon
1141
1323
  * (e.g. `new Date(1990, 0, 15, 12)`) to avoid day-shift at timezone extremes.
1142
1324
  */
1143
1325
  declare function calculateCycles(startDate: Date, today: Date): CycleInfo;
1144
1326
  /**
1327
+ * Fibonacci cycles from the completed (birthday) age.
1145
1328
  * Dates are read with local calendar getters; construct them at local noon
1146
1329
  * (e.g. `new Date(1990, 0, 15, 12)`) to avoid day-shift at timezone extremes.
1147
1330
  */
1148
1331
  declare function calculateFibonacciCycle(birthDate: Date, today: Date): FibonacciCycle;
1332
+ /** Fibonacci recurrence on an explicit age (single-digit reductions; masters are not preserved). */
1333
+ declare function fibonacciFromAge(currentAge: number): FibonacciCycle;
1149
1334
  /**
1150
1335
  * Dates are read with local calendar getters; construct them at local noon
1151
- * (e.g. `new Date(1990, 0, 15, 12)`) to avoid day-shift at timezone extremes.
1336
+ * (e.g. `new Date(1990, 0, 15, 12)` ) to avoid day-shift at timezone extremes.
1152
1337
  */
1153
1338
  declare function calculatePersonalYear(birthDate: Date, today?: Date): ReducedValueWithSteps;
1154
- declare function calculatePersonalPeriods(birthDate: Date, yearToUse: number, lifePath: number, soulNumber: number, currentAge: number): [PersonalPeriod, PersonalPeriod, PersonalPeriod];
1339
+ declare function calculatePersonalPeriods(birthDate: Date, yearToUse: number, lifePath: number, soulNumber: number | UnavailableValue, currentAge: number): [PersonalPeriod, PersonalPeriod, PersonalPeriod];
1155
1340
  declare function calculatePersonalMonths(birthDate: Date, personalYear: ReducedValueWithSteps, today: Date): {
1156
1341
  personalMonths: PersonalCycles["personalMonths"];
1157
1342
  currentPersonalMonthIndex: number;
1158
1343
  };
1159
- declare function calculatePersonalCycles(birthDate: Date, today: Date | undefined, firstName: string): PersonalCycles;
1344
+ declare function calculatePersonalCycles(birthDate: Date, today?: Date, firstName?: string | null): PersonalCycles;
1160
1345
 
1161
- export { MASTER_NUMBERS, NUMEROLOGY_TEXT_DATA, data as NumerologyData, data as NumerologyModuleTypes, type NumerologyTextData, calculateChallenges, calculateCycles, calculateFibonacciCycle, calculateKaabalisticLifePath, calculatePersonalCycles, calculatePersonalMonths, calculatePersonalPeriods, calculatePersonalYear, calculateStraightAcrossReductionLifePath, getDateEnergies, getNumerologyData, isMasterNumber, reduceToSingle, reduceToSingleWithSteps };
1346
+ export { type AgeCycleInterval, type AgeCycleRef, type BirthDateCandidateSummary, type BoundaryRange, type CalendarDayInterval, type CalendarMonthInterval, type CalendarYearInterval, type CandidateSummaryInput, type Challenge, type ChallengeInterval, CivilDateInput, type FibonacciInterval, type FieldSummary, type HeptadInterval, LIFE_STAGE_METHOD_ID, LifePathMethod, type LifePeriod, type LifePeriodInterval, LifeStageOptions, type LifeStageSpan, type LifeStages, MasterPolicy, NUMEROLOGY_TEXT_DATA, NormalizedBirth, NumerologyMethodMetadata, type NumerologySnapshot, type NumerologyTextData, type NumerologyTimeline, PartialBirthDate, type PartialDateCapability, type PersonalMonthInterval, type PersonalPeriodInterval, type PersonalPeriodValue, type PersonalYearInterval, type Pinnacle, type PinnacleInterval, ReducedNumber, ScheduleInput, type ScheduleInterval, type ScheduleIntervalBase, ScheduleOptions, ShortMonthPolicy, type SnapshotStatus, TIMELINE_LAYERS, type TimelineInput, type TimelineLayer, Unavailable, calculateChallenges, calculateCycles, calculateFibonacciCycle, calculatePersonalCycles, calculatePersonalMonths, calculatePersonalPeriods, calculatePersonalYear, computeLifeStages, describePartialBirthDate, fibonacciFromAge, generateNumerologyTimeline, getDateEnergies, getNumerologyData, getNumerologyMethodMetadata, getNumerologySnapshot, summarizeBirthDateCandidates };