@roxyapi/ui 1.6.2 → 1.8.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 (193) hide show
  1. package/components-catalog.json +1 -1
  2. package/dist/cdn/components/almanac-day.js +2 -2
  3. package/dist/cdn/components/angel-number-card.js +3 -3
  4. package/dist/cdn/components/angel-number-lookup.js +2 -2
  5. package/dist/cdn/components/arudha-padas.js +2 -2
  6. package/dist/cdn/components/ashtakavarga-grid.js +1 -1
  7. package/dist/cdn/components/aspects-table.js +2 -2
  8. package/dist/cdn/components/astrocartography-map.js +1 -1
  9. package/dist/cdn/components/bazi-chart.js +2 -2
  10. package/dist/cdn/components/bhav-chalit-table.js +2 -2
  11. package/dist/cdn/components/bhava-bala-table.js +3 -3
  12. package/dist/cdn/components/biorhythm-chart.js +2 -2
  13. package/dist/cdn/components/bodygraph.js +3 -3
  14. package/dist/cdn/components/chara-karakas.js +2 -2
  15. package/dist/cdn/components/choghadiya-grid.js +1 -1
  16. package/dist/cdn/components/compatibility-card.js +2 -2
  17. package/dist/cdn/components/compound-number.js +2 -2
  18. package/dist/cdn/components/crystal-card.js +1 -1
  19. package/dist/cdn/components/crystal-grid.js +1 -1
  20. package/dist/cdn/components/dasha-timeline.js +2 -2
  21. package/dist/cdn/components/data.js +1 -1
  22. package/dist/cdn/components/divisional-chart.js +1 -1
  23. package/dist/cdn/components/dosha-card.js +2 -2
  24. package/dist/cdn/components/dosha-constitution.js +2 -2
  25. package/dist/cdn/components/dream-card.js +1 -1
  26. package/dist/cdn/components/dream-search.js +2 -2
  27. package/dist/cdn/components/endpoint-form.js +2 -2
  28. package/dist/cdn/components/ephemeris-table.js +1 -1
  29. package/dist/cdn/components/fixed-stars.js +1 -1
  30. package/dist/cdn/components/flying-star-chart.js +2 -2
  31. package/dist/cdn/components/forecast-digest.js +1 -1
  32. package/dist/cdn/components/forecast-timeline.js +1 -1
  33. package/dist/cdn/components/gematria.js +1 -1
  34. package/dist/cdn/components/gochara-table.js +2 -2
  35. package/dist/cdn/components/guna-milan.js +3 -3
  36. package/dist/cdn/components/hd-connection.js +1 -1
  37. package/dist/cdn/components/hd-penta.js +15 -15
  38. package/dist/cdn/components/hd-type-card.js +1 -1
  39. package/dist/cdn/components/hd-variables.js +1 -1
  40. package/dist/cdn/components/heliacal-table.js +2 -2
  41. package/dist/cdn/components/hexagram.js +1 -1
  42. package/dist/cdn/components/hora-table.js +1 -1
  43. package/dist/cdn/components/horoscope-card.js +3 -3
  44. package/dist/cdn/components/kp-chart.js +3 -3
  45. package/dist/cdn/components/kp-finance-card.js +2 -2
  46. package/dist/cdn/components/kp-planets-table.js +3 -3
  47. package/dist/cdn/components/kp-ruling-planets.js +1 -1
  48. package/dist/cdn/components/kua-card.js +3 -3
  49. package/dist/cdn/components/local-space-compass.js +1 -1
  50. package/dist/cdn/components/location-search.js +1 -1
  51. package/dist/cdn/components/luck-pillars.js +3 -3
  52. package/dist/cdn/components/mayan-day-sign.js +1 -1
  53. package/dist/cdn/components/moon-phase.js +2 -2
  54. package/dist/cdn/components/nakshatra-card.js +1 -1
  55. package/dist/cdn/components/natal-chart.js +17 -17
  56. package/dist/cdn/components/numerology-card.js +2 -2
  57. package/dist/cdn/components/panchang-table.js +2 -2
  58. package/dist/cdn/components/positions-table.js +1 -1
  59. package/dist/cdn/components/profection-card.js +2 -2
  60. package/dist/cdn/components/reference-card.js +1 -1
  61. package/dist/cdn/components/relocation-wheel.js +17 -17
  62. package/dist/cdn/components/report.js +1 -1
  63. package/dist/cdn/components/shadbala-table.js +1 -1
  64. package/dist/cdn/components/synastry-chart.js +1 -1
  65. package/dist/cdn/components/tarot-card.js +2 -2
  66. package/dist/cdn/components/tarot-catalog.js +2 -2
  67. package/dist/cdn/components/tarot-spread.js +3 -3
  68. package/dist/cdn/components/transit-wheel.js +1 -1
  69. package/dist/cdn/components/transits-table.js +2 -2
  70. package/dist/cdn/components/upagraha-table.js +3 -3
  71. package/dist/cdn/components/vastu-mandala.js +2 -2
  72. package/dist/cdn/components/vedic-aspects.js +2 -2
  73. package/dist/cdn/components/vedic-daily.js +2 -2
  74. package/dist/cdn/components/vedic-kundli.js +1 -1
  75. package/dist/cdn/components/vedic-planets-table.js +1 -1
  76. package/dist/cdn/components/western-planets-table.js +1 -1
  77. package/dist/cdn/components/yoga-list.js +2 -2
  78. package/dist/cdn/components/zodiac-card.js +2 -2
  79. package/dist/cdn/locales/de.js +1 -1
  80. package/dist/cdn/locales/es.js +1 -1
  81. package/dist/cdn/locales/fr.js +1 -1
  82. package/dist/cdn/locales/hi.js +1 -1
  83. package/dist/cdn/locales/pt.js +1 -1
  84. package/dist/cdn/locales/ru.js +1 -1
  85. package/dist/cdn/locales/tr.js +1 -1
  86. package/dist/cdn/roxy-ui.js +85 -85
  87. package/dist/charts.cjs +13 -13
  88. package/dist/charts.js +10 -10
  89. package/dist/components/almanac-day.js +1 -1
  90. package/dist/components/angel-number-card.js +1 -1
  91. package/dist/components/angel-number-lookup.js +1 -1
  92. package/dist/components/arudha-padas.js +1 -1
  93. package/dist/components/ashtakavarga-grid.js +1 -1
  94. package/dist/components/aspects-table.js +1 -1
  95. package/dist/components/astrocartography-map.js +2 -2
  96. package/dist/components/bazi-chart.js +1 -1
  97. package/dist/components/bhav-chalit-table.js +1 -1
  98. package/dist/components/bhava-bala-table.js +1 -1
  99. package/dist/components/biorhythm-chart.js +1 -1
  100. package/dist/components/bodygraph.js +1 -1
  101. package/dist/components/chara-karakas.js +1 -1
  102. package/dist/components/choghadiya-grid.js +1 -1
  103. package/dist/components/compatibility-card.js +1 -1
  104. package/dist/components/compound-number.js +1 -1
  105. package/dist/components/crystal-card.js +1 -1
  106. package/dist/components/crystal-grid.js +1 -1
  107. package/dist/components/dasha-timeline.js +1 -1
  108. package/dist/components/data.js +1 -1
  109. package/dist/components/divisional-chart.js +1 -1
  110. package/dist/components/dosha-card.js +1 -1
  111. package/dist/components/dosha-constitution.js +1 -1
  112. package/dist/components/dream-card.js +1 -1
  113. package/dist/components/dream-search.js +1 -1
  114. package/dist/components/endpoint-form.js +1 -1
  115. package/dist/components/ephemeris-table.js +1 -1
  116. package/dist/components/fixed-stars.js +1 -1
  117. package/dist/components/flying-star-chart.js +1 -1
  118. package/dist/components/forecast-digest.js +1 -1
  119. package/dist/components/forecast-timeline.js +1 -1
  120. package/dist/components/gematria.js +1 -1
  121. package/dist/components/gochara-table.js +1 -1
  122. package/dist/components/guna-milan.js +1 -1
  123. package/dist/components/hd-connection.js +1 -1
  124. package/dist/components/hd-penta.js +1 -1
  125. package/dist/components/hd-type-card.js +1 -1
  126. package/dist/components/hd-variables.js +1 -1
  127. package/dist/components/heliacal-table.js +1 -1
  128. package/dist/components/hexagram.js +1 -1
  129. package/dist/components/hora-table.js +1 -1
  130. package/dist/components/horoscope-card.d.ts +24 -8
  131. package/dist/components/horoscope-card.js +1 -1
  132. package/dist/components/kp-chart.js +1 -1
  133. package/dist/components/kp-finance-card.js +1 -1
  134. package/dist/components/kp-planets-table.js +1 -1
  135. package/dist/components/kp-ruling-planets.js +1 -1
  136. package/dist/components/kua-card.js +1 -1
  137. package/dist/components/local-space-compass.js +2 -2
  138. package/dist/components/location-search.js +1 -1
  139. package/dist/components/luck-pillars.js +1 -1
  140. package/dist/components/mayan-day-sign.js +1 -1
  141. package/dist/components/moon-phase.js +1 -1
  142. package/dist/components/nakshatra-card.js +1 -1
  143. package/dist/components/natal-chart.d.ts +5 -0
  144. package/dist/components/natal-chart.js +14 -14
  145. package/dist/components/numerology-card.js +1 -1
  146. package/dist/components/panchang-table.js +1 -1
  147. package/dist/components/positions-table.js +1 -1
  148. package/dist/components/profection-card.js +1 -1
  149. package/dist/components/reference-card.js +1 -1
  150. package/dist/components/relocation-wheel.js +15 -15
  151. package/dist/components/report.js +1 -1
  152. package/dist/components/shadbala-table.js +1 -1
  153. package/dist/components/synastry-chart.js +1 -1
  154. package/dist/components/tarot-card.js +1 -1
  155. package/dist/components/tarot-catalog.js +1 -1
  156. package/dist/components/tarot-spread.d.ts +2 -0
  157. package/dist/components/tarot-spread.js +1 -1
  158. package/dist/components/transit-wheel.js +8 -8
  159. package/dist/components/transits-table.js +1 -1
  160. package/dist/components/upagraha-table.js +1 -1
  161. package/dist/components/vastu-mandala.js +2 -2
  162. package/dist/components/vedic-aspects.js +1 -1
  163. package/dist/components/vedic-daily.js +1 -1
  164. package/dist/components/vedic-kundli.js +2 -2
  165. package/dist/components/vedic-planets-table.js +1 -1
  166. package/dist/components/western-planets-table.d.ts +1 -0
  167. package/dist/components/western-planets-table.js +1 -1
  168. package/dist/components/yoga-list.js +1 -1
  169. package/dist/components/zodiac-card.js +1 -1
  170. package/dist/forms.json +1 -1
  171. package/dist/i18n/chrome-strings.d.ts +1 -1
  172. package/dist/index.cjs +111 -111
  173. package/dist/index.js +95 -95
  174. package/dist/locales/de.js +1 -1
  175. package/dist/locales/es.js +1 -1
  176. package/dist/locales/fr.js +1 -1
  177. package/dist/locales/hi.js +1 -1
  178. package/dist/locales/pt.js +1 -1
  179. package/dist/locales/ru.js +1 -1
  180. package/dist/locales/tr.js +1 -1
  181. package/dist/manifest.json +1 -1
  182. package/dist/schemas/get--astrology-horoscope-sign-daily.json +1 -1
  183. package/dist/schemas/get--astrology-horoscope-sign-monthly.json +1 -1
  184. package/dist/schemas/get--astrology-horoscope-sign-weekly.json +1 -1
  185. package/dist/schemas/post--astrology-aspect-patterns.json +1 -1
  186. package/dist/types/types.gen.d.ts +407 -63
  187. package/dist/utils/base-element.d.ts +2 -1
  188. package/dist/utils/format.d.ts +2 -0
  189. package/dist/utils/interp-accordion.d.ts +2 -2
  190. package/dist/utils/string.d.ts +2 -0
  191. package/dist/utils/tarot.d.ts +2 -0
  192. package/dist/version.d.ts +1 -1
  193. package/package.json +1 -1
@@ -2,6 +2,31 @@ export type ClientOptions = {
2
2
  baseUrl: 'https://roxyapi.com/api/v2' | (string & {});
3
3
  };
4
4
  export type NatalChartResponse = {
5
+ /**
6
+ * Whole-chart natal interpretation. Present when lang is one the natal engine writes (English, German, Spanish, French, Hindi, Portuguese, Russian, Turkish); absent otherwise.
7
+ */
8
+ interpretation?: {
9
+ /**
10
+ * Whole-chart natal reading connecting the Sun, Moon, Ascendant, central signature and the tension that shapes their expression.
11
+ */
12
+ opening: string;
13
+ /**
14
+ * Relationships chapter connecting the seventh-house ruler and occupants with the Venus-Mars relationship.
15
+ */
16
+ love: string;
17
+ /**
18
+ * Career chapter connecting the tenth-house ruler and occupants with the Midheaven sign.
19
+ */
20
+ career: string;
21
+ /**
22
+ * Home chapter connecting the fourth-house ruler and occupants with the IC sign and private foundations.
23
+ */
24
+ home: string;
25
+ /**
26
+ * Closing synthesis returning to the central drives, their integration and the chart signature.
27
+ */
28
+ closing: string;
29
+ };
5
30
  /**
6
31
  * Birth details echoed back from the request. Confirms the input used for this chart calculation.
7
32
  */
@@ -76,15 +101,15 @@ export type NatalChartResponse = {
76
101
  */
77
102
  dignity?: 'domicile' | 'exaltation' | 'detriment' | 'fall' | 'peregrine';
78
103
  /**
79
- * Planet-in-sign-in-house interpretation. Narrative analysis of what this placement means in the natal chart.
104
+ * Reading of this body in its sign and house for this chart, in the requested language.
80
105
  */
81
106
  interpretation?: {
82
107
  /**
83
- * One-sentence interpretation of this planet in its sign and house placement.
108
+ * The placement in brief: what this body does in its sign and in its house, written for this chart.
84
109
  */
85
110
  summary: string;
86
111
  /**
87
- * Multi-sentence detailed interpretation with personality insights.
112
+ * The full reading of this placement: its sign and house, and where they apply its dignity, retrograde motion, the Moon phase at birth, a nearby angle and its tightest aspect.
88
113
  */
89
114
  detailed: string;
90
115
  /**
@@ -175,7 +200,7 @@ export type NatalChartResponse = {
175
200
  */
176
201
  aspectInterpretation: {
177
202
  /**
178
- * One-sentence read of THIS pair: which two bodies, how tight the aspect is, whether it is applying or separating, and how it is classified. Translated in place, so it arrives in the requested language.
203
+ * Short read of THIS pair of bodies as the aspect joins them in this chart. Type, orb, strength and motion stay in the fields beside it. Translated in place, so it arrives in the requested language.
179
204
  */
180
205
  summary: string;
181
206
  /**
@@ -189,7 +214,7 @@ export type NatalChartResponse = {
189
214
  */
190
215
  patterns?: Array<{
191
216
  /**
192
- * Pattern kind identifier. GRAND_TRINE (3 trines, harmonious flow), KITE (Grand Trine with a focal outlet planet), T_SQUARE (opposition with squared apex, growth engine), GRAND_CROSS (4 planets in 2 oppositions and 4 squares, peak tension), YOD (Finger of Fate, fated adjustment), MYSTIC_RECTANGLE (oppositions softened by trines and sextiles), STELLIUM (3+ planets clustered in a sign or 10-degree arc).
217
+ * Pattern kind identifier. GRAND_TRINE (3 trines, harmonious flow), KITE (Grand Trine with a focal outlet planet), T_SQUARE (opposition with squared apex, growth engine), GRAND_CROSS (4 planets in 2 oppositions and 4 squares, peak tension), YOD (a planet at the apex of two quincunxes, a call to adjust), MYSTIC_RECTANGLE (oppositions softened by trines and sextiles), STELLIUM (3+ planets clustered in a sign or 10-degree arc).
193
218
  */
194
219
  kind: 'GRAND_TRINE' | 'KITE' | 'T_SQUARE' | 'GRAND_CROSS' | 'YOD' | 'MYSTIC_RECTANGLE' | 'STELLIUM';
195
220
  /**
@@ -244,7 +269,7 @@ export type NatalChartResponse = {
244
269
  */
245
270
  summary: string;
246
271
  /**
247
- * Whether the chart is predominantly harmonious, challenging, or balanced.
272
+ * Which way this chart leans, read from the harmonious and challenging counts beside it against how many of each a typical chart holds: harmonious, challenging or balanced. Always English, whatever the lang parameter says; the summary states the same lean in the requested language.
248
273
  */
249
274
  dominant: string;
250
275
  /**
@@ -252,7 +277,7 @@ export type NatalChartResponse = {
252
277
  */
253
278
  harmonious: number;
254
279
  /**
255
- * Count of challenging aspects (square, opposition).
280
+ * Count of challenging aspects (square, opposition, quincunx).
256
281
  */
257
282
  challenging: number;
258
283
  /**
@@ -280,6 +305,19 @@ export type NatalChartResponse = {
280
305
  * Absolute ecliptic longitude of the Ascendant (0-360).
281
306
  */
282
307
  longitude: number;
308
+ /**
309
+ * Interpretation of the rising sign: how you meet the world and how others first meet you. Present when lang is one the natal engine writes (English, German, Spanish, French, Hindi, Portuguese, Russian, Turkish); absent otherwise.
310
+ */
311
+ interpretation?: {
312
+ /**
313
+ * One-sentence read of the rising sign: how you meet the world and how others first meet you.
314
+ */
315
+ summary: string;
316
+ /**
317
+ * A paragraph on the rising sign: how you meet the world and how others first meet you: the strengths it brings, the habit to watch and how it shows in daily life.
318
+ */
319
+ detailed: string;
320
+ };
283
321
  };
284
322
  /**
285
323
  * Midheaven (MC). The highest point of the ecliptic at birth, representing career direction and public image.
@@ -301,6 +339,19 @@ export type NatalChartResponse = {
301
339
  * Absolute ecliptic longitude of the Midheaven (0-360).
302
340
  */
303
341
  longitude: number;
342
+ /**
343
+ * Interpretation of the Midheaven sign: your public direction and the work you want to be known for. Present when lang is one the natal engine writes (English, German, Spanish, French, Hindi, Portuguese, Russian, Turkish); absent otherwise.
344
+ */
345
+ interpretation?: {
346
+ /**
347
+ * One-sentence read of the Midheaven sign: your public direction and the work you want to be known for.
348
+ */
349
+ summary: string;
350
+ /**
351
+ * A paragraph on the Midheaven sign: your public direction and the work you want to be known for: the strengths it brings, the habit to watch and how it shows in daily life.
352
+ */
353
+ detailed: string;
354
+ };
304
355
  };
305
356
  /**
306
357
  * Part of Fortune (Lot of Fortune). A point derived from the Ascendant and the two luminaries that marks an area of ease, vitality, and material wellbeing in the chart.
@@ -638,7 +689,7 @@ export type AspectsResponse = {
638
689
  */
639
690
  patterns?: Array<{
640
691
  /**
641
- * Pattern kind identifier. GRAND_TRINE (3 trines, harmonious flow), KITE (Grand Trine with a focal outlet planet), T_SQUARE (opposition with squared apex, growth engine), GRAND_CROSS (4 planets in 2 oppositions and 4 squares, peak tension), YOD (Finger of Fate, fated adjustment), MYSTIC_RECTANGLE (oppositions softened by trines and sextiles), STELLIUM (3+ planets clustered in a sign or 10-degree arc).
692
+ * Pattern kind identifier. GRAND_TRINE (3 trines, harmonious flow), KITE (Grand Trine with a focal outlet planet), T_SQUARE (opposition with squared apex, growth engine), GRAND_CROSS (4 planets in 2 oppositions and 4 squares, peak tension), YOD (a planet at the apex of two quincunxes, a call to adjust), MYSTIC_RECTANGLE (oppositions softened by trines and sextiles), STELLIUM (3+ planets clustered in a sign or 10-degree arc).
642
693
  */
643
694
  kind: 'GRAND_TRINE' | 'KITE' | 'T_SQUARE' | 'GRAND_CROSS' | 'YOD' | 'MYSTIC_RECTANGLE' | 'STELLIUM';
644
695
  /**
@@ -740,7 +791,7 @@ export type AspectPatternsResponse = {
740
791
  */
741
792
  patterns: Array<{
742
793
  /**
743
- * Pattern kind identifier. GRAND_TRINE (3 trines, harmonious flow), KITE (Grand Trine with a focal outlet planet), T_SQUARE (opposition with squared apex, growth engine), GRAND_CROSS (4 planets in 2 oppositions and 4 squares, peak tension), YOD (Finger of Fate, fated adjustment), MYSTIC_RECTANGLE (oppositions softened by trines and sextiles), STELLIUM (3+ planets clustered in a sign or 10-degree arc).
794
+ * Pattern kind identifier. GRAND_TRINE (3 trines, harmonious flow), KITE (Grand Trine with a focal outlet planet), T_SQUARE (opposition with squared apex, growth engine), GRAND_CROSS (4 planets in 2 oppositions and 4 squares, peak tension), YOD (a planet at the apex of two quincunxes, a call to adjust), MYSTIC_RECTANGLE (oppositions softened by trines and sextiles), STELLIUM (3+ planets clustered in a sign or 10-degree arc).
744
795
  */
745
796
  kind: 'GRAND_TRINE' | 'KITE' | 'T_SQUARE' | 'GRAND_CROSS' | 'YOD' | 'MYSTIC_RECTANGLE' | 'STELLIUM';
746
797
  /**
@@ -795,7 +846,7 @@ export type AspectPatternsResponse = {
795
846
  */
796
847
  options: {
797
848
  /**
798
- * Whether the tight orb budget was used. False uses the standard pattern-detection orbs (8 degrees for major aspects, 9 for square, 6 for sextile, 3 for quincunx).
849
+ * Whether the tight orb budget was used. False uses the chart aspect table orbs; true narrows them further.
799
850
  */
800
851
  strictOrbs: boolean;
801
852
  /**
@@ -1398,7 +1449,7 @@ export type RelocationPlanet = {
1398
1449
  */
1399
1450
  interpretation?: {
1400
1451
  /**
1401
- * One-sentence interpretation of this planet in its sign and relocated house.
1452
+ * The placement in brief: what this body does in its natal sign and in its relocated house.
1402
1453
  */
1403
1454
  summary: string;
1404
1455
  /**
@@ -12258,7 +12309,7 @@ export type DetectAspectPatternsData = {
12258
12309
  */
12259
12310
  lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru' | 'zh-Hans' | 'zh-Hant';
12260
12311
  /**
12261
- * Use tighter orbs, so only closely formed patterns are reported. Truthy values (true, 1, yes, on; case-insensitive) narrow trine to 5 degrees, square to 5, sextile to 4, quincunx to 2. Defaults to false, the standard pattern-detection orbs.
12312
+ * Use tighter orbs, so only closely formed patterns are reported. Truthy values (true, 1, yes, on; case-insensitive) narrow trine to 5 degrees, square to 5, sextile to 4, quincunx to 2. Every leg must occur in the chart aspect table. Defaults to false.
12262
12313
  */
12263
12314
  strictOrbs?: string;
12264
12315
  /**
@@ -15519,7 +15570,7 @@ export type GetDailyHoroscopeData = {
15519
15570
  */
15520
15571
  date?: string;
15521
15572
  /**
15522
- * Selects which period counts as current when date is omitted. Defaults to UTC, so the forecast rolls over at 00:00 UTC on each day. Pass the timezone of the end user to roll over on their local clock instead. Ignored when date is set. Accepts an IANA name (e.g. "America/New_York"), decimal hours (e.g. 5.5 for IST), or a fixed UTC offset (e.g. "-05:00").
15573
+ * The clock the day is read on: it decides which events fall on the date, so a transit the evening before in the timezone of the end user is never called today, and which date is current when date is omitted. Defaults to UTC. Accepts an IANA name (e.g. "America/New_York"), decimal hours (e.g. 5.5 for IST), or a fixed UTC offset (e.g. "-05:00").
15523
15574
  */
15524
15575
  timezone?: string;
15525
15576
  };
@@ -15661,33 +15712,37 @@ export type GetDailyHoroscopeResponses = {
15661
15712
  */
15662
15713
  date: string;
15663
15714
  /**
15664
- * The single most relevant event of the period, whichever life area it touches, read into the whole-sign houses of this sign. The same event that leads column, at lede length rather than developed into a full movement, and checkable against the events array. Typically 30 to 60 words. Join it with love, career, health and finance for a general reading built from the six sections. Deterministic: the same sign and period always returns the same text.
15715
+ * The event of the day that most reaches home, roots and the self, or on a quiet day a standing planet, written as the five topic fields are and opening on the lead of column whenever focus is overview. Typically 80 to 120 words. Join it with love, career, health and finance for a general reading built from the six sections. Deterministic: the same sign and period always returns the same text.
15665
15716
  */
15666
15717
  overview: string;
15667
15718
  /**
15668
- * Love and relationship forecast, read into the whole-sign houses of this sign. The same ranked events that drive column, filtered to romance and partnership, plus the standing placements that reach it. Every event named here is in the events array, so a piece can be fact-checked before it runs; this section reads an event through whichever of its houses carries romance and partnership, which for an aspect between two houses can be the other one from the house the events array leads with, and both are whole-sign houses of the bodies involved counted from this sign. Typically 50 to 90 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is the same material woven into one piece instead of split by topic. Deterministic: the same sign and period always returns the same text.
15719
+ * Love and relationship forecast, read into the whole-sign houses of this sign. It opens on the event of the day that most reaches romance and partnership, or on a quiet day a standing planet, naming the bodies, the aspect and the life area and what it stirs, then a human situation of this topic with a way through it, a conditional with a few options, and a close; the topic named in focus opens on the same event as column. Every named event is in events, with each participant sign and whole-sign house in placements at the event time. This section reads whichever participant house carries romance and partnership; the aggregate event house remains the leading body house. Typically 80 to 120 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is a separate piece of its own. Deterministic: the same sign and period always returns the same text.
15669
15720
  */
15670
15721
  love: string;
15671
15722
  /**
15672
- * Career and professional outlook, read into the whole-sign houses of this sign. The same ranked events that drive column, filtered to career, work and reputation, plus the standing placements that reach it. Every event named here is in the events array, so a piece can be fact-checked before it runs; this section reads an event through whichever of its houses carries career, work and reputation, which for an aspect between two houses can be the other one from the house the events array leads with, and both are whole-sign houses of the bodies involved counted from this sign. Typically 50 to 90 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is the same material woven into one piece instead of split by topic. Deterministic: the same sign and period always returns the same text.
15723
+ * Career and professional outlook, read into the whole-sign houses of this sign. It opens on the event of the day that most reaches career, work and reputation, or on a quiet day a standing planet, naming the bodies, the aspect and the life area and what it stirs, then a human situation of this topic with a way through it, a conditional with a few options, and a close; the topic named in focus opens on the same event as column. Every named event is in events, with each participant sign and whole-sign house in placements at the event time. This section reads whichever participant house carries career, work and reputation; the aggregate event house remains the leading body house. Typically 80 to 120 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is a separate piece of its own. Deterministic: the same sign and period always returns the same text.
15673
15724
  */
15674
15725
  career: string;
15675
15726
  /**
15676
- * Health, energy, and wellness guidance, read into the whole-sign houses of this sign. The same ranked events that drive column, filtered to health, plus the standing placements that reach it. Every event named here is in the events array, so a piece can be fact-checked before it runs; this section reads an event through whichever of its houses carries health, which for an aspect between two houses can be the other one from the house the events array leads with, and both are whole-sign houses of the bodies involved counted from this sign. Typically 50 to 90 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is the same material woven into one piece instead of split by topic. Deterministic: the same sign and period always returns the same text.
15727
+ * Health, energy, and wellness guidance, read into the whole-sign houses of this sign. It opens on the event of the day that most reaches health, or on a quiet day a standing planet, naming the bodies, the aspect and the life area and what it stirs, then a human situation of this topic with a way through it, a conditional with a few options, and a close; the topic named in focus opens on the same event as column. Every named event is in events, with each participant sign and whole-sign house in placements at the event time. This section reads whichever participant house carries health; the aggregate event house remains the leading body house. Typically 80 to 120 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is a separate piece of its own. Deterministic: the same sign and period always returns the same text.
15677
15728
  */
15678
15729
  health: string;
15679
15730
  /**
15680
- * Financial outlook and money-related guidance, read into the whole-sign houses of this sign. The same ranked events that drive column, filtered to finance, plus the standing placements that reach it. Every event named here is in the events array, so a piece can be fact-checked before it runs; this section reads an event through whichever of its houses carries finance, which for an aspect between two houses can be the other one from the house the events array leads with, and both are whole-sign houses of the bodies involved counted from this sign. Typically 50 to 90 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is the same material woven into one piece instead of split by topic. Deterministic: the same sign and period always returns the same text.
15731
+ * Financial outlook and money-related guidance, read into the whole-sign houses of this sign. It opens on the event of the day that most reaches finance, or on a quiet day a standing planet, naming the bodies, the aspect and the life area and what it stirs, then a human situation of this topic with a way through it, a conditional with a few options, and a close; the topic named in focus opens on the same event as column. Every named event is in events, with each participant sign and whole-sign house in placements at the event time. This section reads whichever participant house carries finance; the aggregate event house remains the leading body house. Typically 80 to 120 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is a separate piece of its own. Deterministic: the same sign and period always returns the same text.
15681
15732
  */
15682
15733
  finance: string;
15683
15734
  /**
15684
- * The single actionable takeaway from the leading event of the period, read into the whole-sign houses of this sign and checkable against the events array. Drawn from the same event as overview, kept to a short, actionable pair of sentences rather than grown to match the other sections. Deterministic: the same sign and period always returns the same text.
15735
+ * The single actionable takeaway of the period. It opens on the event of the day that most reaches travel, belief, conversation and daily learning, or on a quiet day a standing planet, naming the bodies, the aspect and the life area, then a situation with a way through it, a conditional with a few options, and a close, in the shape of the five fields beside it. Deterministic: the same sign and period always returns the same text.
15685
15736
  */
15686
15737
  advice: string;
15687
15738
  /**
15688
- * The full column for this period, ready to run as one piece, with paragraphs separated by a blank line. Names the events driving it and the dates they fall on, read into the whole-sign houses of this sign. Typically 120 to 180 words. The six section fields read the same ranked events filtered to their own life area, each composed as a column of its own rather than an excerpt of this one, so render either shape and never both. Deterministic: the same sign and period always returns the same column.
15739
+ * The full column for this period, ready to run as one piece, its paragraphs, where it has more than one, separated by a blank line. Names the events driving it and the dates they fall on, read into the whole-sign houses of this sign. Typically 80 to 120 words. The six section fields each open on an event or standing planet of their own read through their life area, the one named in focus on the lead of this column, so render either shape and never both. Deterministic: the same sign and period always returns the same column.
15689
15740
  */
15690
15741
  column: string;
15742
+ /**
15743
+ * The topic this reading is mainly about: love, career, finance or health when the lead event falls in that life area, overview for a bigger-picture period. A machine value, canonical English in every language, so a client can route its own content on it (a related article, a product, a call to action) without parsing the prose; the topic field it names reads the same lead the column opens on.
15744
+ */
15745
+ focus: 'love' | 'career' | 'finance' | 'health' | 'overview';
15691
15746
  /**
15692
15747
  * The dated astronomical events this reading is built on, earliest first. Every field in every row can be checked against an independent authority, so a column can be fact-checked before it is published. Empty on a period in which nothing exact happens, where the reading falls back to the standing positions instead.
15693
15748
  */
@@ -15697,17 +15752,46 @@ export type GetDailyHoroscopeResponses = {
15697
15752
  */
15698
15753
  type: 'aspect' | 'sign-ingress' | 'retrograde-station' | 'lunar-phase' | 'eclipse' | 'solar-season';
15699
15754
  /**
15700
- * Exact instant the event perfects, UTC, to the second. Verifiable against NASA JPL Horizons for a position event and against the US Naval Observatory for a lunar phase or eclipse.
15755
+ * Exact instant the event perfects, ISO 8601 to the second, on the clock the reading is read on: UTC with Z by default, the offset of timezone when one is passed on a daily, weekly or monthly reading (2026-11-13T19:27:27-05:00 in New York), the same instant either way; a yearly reading is written in UTC. Verifiable against NASA JPL Horizons for a position event and against the US Naval Observatory for a lunar phase or eclipse.
15701
15756
  */
15702
15757
  at: string;
15703
15758
  /**
15704
15759
  * Bodies involved, canonical English regardless of the requested language so the value stays safe to switch on. Two entries for an aspect, faster body first. One entry for an ingress, a station, a lunar phase, or an eclipse.
15705
15760
  */
15706
15761
  bodies: Array<string>;
15762
+ /**
15763
+ * Each participant at the enclosing event timestamp, in bodies order: two entries for an aspect and one for every other event. Names and signs stay canonical English in every language. Each entry carries its own whole-sign house, including the second body of an aspect. Event placements can differ from positions, which reports noon on the first day of the period.
15764
+ */
15765
+ placements: Array<{
15766
+ /**
15767
+ * Body name, canonical English in every language. Matches the entry at the same index in bodies.
15768
+ */
15769
+ name: string;
15770
+ /**
15771
+ * Sign this body occupies at the event timestamp, lowercase and never translated. For a sign change, the sign entered.
15772
+ */
15773
+ sign: string;
15774
+ /**
15775
+ * Whole-sign house this body occupies at the event instant, counted from the queried sign, 1 to 12.
15776
+ */
15777
+ house: number;
15778
+ }>;
15707
15779
  /**
15708
15780
  * Angle formed, on aspect events only: conjunction, sextile, square, trine, opposition, semi-sextile, quincunx, semi-square, or sesquiquadrate.
15709
15781
  */
15710
15782
  aspect?: string;
15783
+ /**
15784
+ * Exact quarter phase, on lunar-phase events only: new-moon, first-quarter, full-moon, or last-quarter. Canonical English in every language. Use to identify the phase at the event instant.
15785
+ */
15786
+ phase?: 'new-moon' | 'first-quarter' | 'full-moon' | 'last-quarter';
15787
+ /**
15788
+ * Eclipse classification at peak, on eclipse events only: penumbral, partial, annular, or total. Canonical English in every language. Sun in bodies identifies a solar eclipse and Moon a lunar eclipse.
15789
+ */
15790
+ kind?: 'penumbral' | 'partial' | 'annular' | 'total';
15791
+ /**
15792
+ * Direction the body turns at the event instant, on retrograde-station events only: retrograde starts backward motion and direct ends it. Canonical English in every language. Present even when the other end of the retrograde span cannot be dated.
15793
+ */
15794
+ direction?: 'retrograde' | 'direct';
15711
15795
  /**
15712
15796
  * Sign the event falls in, lowercase, where it has exactly one. Absent for an aspect whose two bodies stand in different signs.
15713
15797
  */
@@ -15717,24 +15801,74 @@ export type GetDailyHoroscopeResponses = {
15717
15801
  */
15718
15802
  house: number;
15719
15803
  /**
15720
- * End of the window this event holds open, UTC, given only where a bounded window is a real fact about it: the orb span of an aspect, the sign span of an ingress or a season, the retrograde span of a station. Absent for a lunar phase or an eclipse, which are instants and not spans.
15804
+ * End of the window this event holds open, on the same clock as at, given only where a bounded window is a real fact about it: the orb span of an aspect, the sign span of an ingress or a season, the retrograde span of a station. Absent for a lunar phase or an eclipse, which are instants and not spans.
15721
15805
  */
15722
15806
  through?: string;
15723
15807
  }>;
15808
+ /**
15809
+ * Where each of the ten bodies stands for this reading, one row per body, so every standing claim in the prose (a body in a house, until a date, retrograde until it turns direct, exalted or at home) can be checked against the response itself. It carries state only: every aspect, lunation, eclipse, ingress or station of the period is a row of events[]. Against events[], it adds the bodies that do nothing exact in the period (events[] names only what happens), the entry and exit of the sign each stands in (events[].through carries an exit only for an ingress inside the period), the instant a retrograde body turns direct, and dignity. Against activeTransits, which the daily prints as translated strings for the seven visible bodies, it adds Uranus, Neptune and Pluto, the lowercase sign and numeric house as values, the retrograde flag as a boolean, and the three instants. Where an instant appears in both keys it is the same string. Never translated.
15810
+ */
15811
+ positions: Array<{
15812
+ /**
15813
+ * Body, canonical English regardless of the requested language: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune or Pluto, in that order, one row each. Same key and values as planets[].name on the natal chart.
15814
+ */
15815
+ name: string;
15816
+ /**
15817
+ * Sign the body stands in at noon on the first day of the period on the reader clock, lowercase like events[].sign, never translated.
15818
+ */
15819
+ sign: string;
15820
+ /**
15821
+ * Whole-sign house that sign is for the queried sign, 1 to 12, counted as events[].house is.
15822
+ */
15823
+ house: number;
15824
+ /**
15825
+ * Whether the body moves retrograde at that noon. Same key as planets[].isRetrograde on the natal chart; the daily activeTransits prints the same flag as a translated string.
15826
+ */
15827
+ isRetrograde: boolean;
15828
+ /**
15829
+ * Essential dignity of the body in that sign, the same value planets[].dignity reports on the natal chart: domicile, exaltation, detriment, fall, or peregrine. Always English. A column or card that calls a body at home or exalted is backed by this value.
15830
+ */
15831
+ dignity: 'domicile' | 'exaltation' | 'detriment' | 'fall' | 'peregrine';
15832
+ /**
15833
+ * Instant the body entered this sign, to the second, on the same clock as events[].at. Where the entry is also a row of events[] in this response it is that row at, byte for byte. Absent only where the entry lies too far back to date.
15834
+ */
15835
+ enteredAt?: string;
15836
+ /**
15837
+ * Instant the body next leaves this sign, to the second, on the same clock as events[].at: the date a column prints in until April 15. Where it is also in events[] (the ingress that ends the stay, or the through of the ingress that began it) it is that string, byte for byte. Absent only where the exit lies too far ahead to date.
15838
+ */
15839
+ leavesAt?: string;
15840
+ /**
15841
+ * Instant the body next turns direct, to the second, on the same clock as events[].at, present only while isRetrograde is true: the date a retrograde is dated by in the prose. Where the station is also in events[] it is that row at or through, byte for byte. Absent only where the turn lies too far ahead to date.
15842
+ */
15843
+ turnsDirectAt?: string;
15844
+ }>;
15724
15845
  /**
15725
15846
  * Lucky number for the day, 1 to 9, from the traditional planetary number correspondence applied to the planet that governs this sign today. Not a random draw and not a function of the date.
15726
15847
  */
15727
15848
  luckyNumber: number;
15728
15849
  /**
15729
- * Lucky color for the day, drawn from the three colors of the sign element and selected by the planet governing the reading.
15850
+ * Lucky color for the day, the color traditionally ruled by the planet that governs this sign today: Sun gold, Moon silver, Mercury light blue, Venus green, Mars red, Jupiter purple, Saturn brown. When Uranus, Neptune or Pluto governs, the next most governing of the seven classical planets gives the color. Translated with the lang parameter.
15730
15851
  */
15731
15852
  luckyColor: string;
15732
15853
  /**
15733
- * Most compatible zodiac signs for this sign. Trine partners (same element) followed by a sextile partner (complementary element). Use for compatibility widgets, dating app onboarding, and horoscope cards.
15854
+ * Three zodiac signs most in tune with this sign today, best first. Read from the real sky of the period, so the list moves with the transits instead of repeating a fixed table, and every pick can be traced in positions[]. On a quiet sky it settles on the classic element partners. For the fixed sign-to-sign pairing, read compatibleSigns from the signs endpoint.
15734
15855
  */
15735
15856
  compatibleSigns: Array<string>;
15736
15857
  /**
15737
- * Active planetary transits affecting this sign today, with house activations. Each transit shows the planet, its current sign, and which house it activates for the queried sign. The sign and the house phrase translate with the lang parameter; the planet name stays canonical English so a caller can match on it whatever the language.
15858
+ * Crystal of the day for this sign: a stone traditionally linked to this sign and to the planet that governs it today, stepping down to the next governing planet when none is, and to any stone of the sign after that. Rotates by date among equally fitting stones, so the same sign meets a new stone on consecutive days. Use for daily crystal cards beside the horoscope.
15859
+ */
15860
+ crystal: {
15861
+ /**
15862
+ * Crystal identifier, stable in every language. Pass it to the crystal lookup endpoint, GET /crystals/{id}, for the full healing properties, chakras and affirmation.
15863
+ */
15864
+ id: string;
15865
+ /**
15866
+ * Display name of the crystal, translated with the lang parameter.
15867
+ */
15868
+ name: string;
15869
+ };
15870
+ /**
15871
+ * Active planetary transits affecting this sign today, with house activations. Each transit shows the planet, its current sign, and the house it activates for the queried sign, named by its life area as the prose names it (your house of partnership). The sign and the house phrase translate with the lang parameter; the planet name stays canonical English so a caller can match on it whatever the language.
15738
15872
  */
15739
15873
  activeTransits: Array<string>;
15740
15874
  /**
@@ -15770,7 +15904,7 @@ export type GetWeeklyHoroscopeData = {
15770
15904
  */
15771
15905
  date?: string;
15772
15906
  /**
15773
- * Selects which period counts as current when date is omitted. Defaults to UTC, so the forecast rolls over at 00:00 UTC on each Monday. Pass the timezone of the end user to roll over on their local clock instead. Ignored when date is set. Accepts an IANA name (e.g. "America/New_York"), decimal hours (e.g. 5.5 for IST), or a fixed UTC offset (e.g. "-05:00").
15907
+ * The clock the week is read on: it decides which events fall inside the Monday to Sunday week, the day each is dated by, and which week is current when date is omitted. Defaults to UTC. Accepts an IANA name (e.g. "America/New_York"), decimal hours (e.g. 5.5 for IST), or a fixed UTC offset (e.g. "-05:00").
15774
15908
  */
15775
15909
  timezone?: string;
15776
15910
  };
@@ -15912,33 +16046,37 @@ export type GetWeeklyHoroscopeResponses = {
15912
16046
  */
15913
16047
  week: string;
15914
16048
  /**
15915
- * The single most relevant event of the period, whichever life area it touches, read into the whole-sign houses of this sign. The same event that leads column, at lede length rather than developed into a full movement, and checkable against the events array. Typically 40 to 80 words. Join it with love, career, health and finance for a general reading built from the six sections. Deterministic: the same sign and period always returns the same text.
16049
+ * The event of the week that most reaches home, roots and the self, or on a quiet week a standing planet, written as the five topic fields are and opening on the lead of column whenever focus is overview. Typically 120 to 160 words. Join it with love, career, health and finance for a general reading built from the six sections. Deterministic: the same sign and period always returns the same text.
15916
16050
  */
15917
16051
  overview: string;
15918
16052
  /**
15919
- * Weekly love and relationship forecast, read into the whole-sign houses of this sign. The same ranked events that drive column, filtered to romance and partnership, plus the standing placements that reach it. Every event named here is in the events array, so a piece can be fact-checked before it runs; this section reads an event through whichever of its houses carries romance and partnership, which for an aspect between two houses can be the other one from the house the events array leads with, and both are whole-sign houses of the bodies involved counted from this sign. Typically 80 to 120 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is the same material woven into one piece instead of split by topic. Deterministic: the same sign and period always returns the same text.
16053
+ * Weekly love and relationship forecast, read into the whole-sign houses of this sign. It opens on the event of the week that most reaches romance and partnership, dated by its day, or on a quiet week a standing planet, naming the bodies, the aspect and the life area and what it stirs, then a human situation of this topic with a way through it, a conditional with a few options, and a close; the topic named in focus opens on the same event as column. Every named event is in events, with each participant sign and whole-sign house in placements at the event time. This section reads whichever participant house carries romance and partnership; the aggregate event house remains the leading body house. Typically 120 to 160 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is a separate piece of its own. Deterministic: the same sign and period always returns the same text.
15920
16054
  */
15921
16055
  love: string;
15922
16056
  /**
15923
- * Weekly career and professional outlook, read into the whole-sign houses of this sign. The same ranked events that drive column, filtered to career, work and reputation, plus the standing placements that reach it. Every event named here is in the events array, so a piece can be fact-checked before it runs; this section reads an event through whichever of its houses carries career, work and reputation, which for an aspect between two houses can be the other one from the house the events array leads with, and both are whole-sign houses of the bodies involved counted from this sign. Typically 80 to 120 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is the same material woven into one piece instead of split by topic. Deterministic: the same sign and period always returns the same text.
16057
+ * Weekly career and professional outlook, read into the whole-sign houses of this sign. It opens on the event of the week that most reaches career, work and reputation, dated by its day, or on a quiet week a standing planet, naming the bodies, the aspect and the life area and what it stirs, then a human situation of this topic with a way through it, a conditional with a few options, and a close; the topic named in focus opens on the same event as column. Every named event is in events, with each participant sign and whole-sign house in placements at the event time. This section reads whichever participant house carries career, work and reputation; the aggregate event house remains the leading body house. Typically 120 to 160 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is a separate piece of its own. Deterministic: the same sign and period always returns the same text.
15924
16058
  */
15925
16059
  career: string;
15926
16060
  /**
15927
- * Weekly health, energy, and wellness guidance, read into the whole-sign houses of this sign. The same ranked events that drive column, filtered to health, plus the standing placements that reach it. Every event named here is in the events array, so a piece can be fact-checked before it runs; this section reads an event through whichever of its houses carries health, which for an aspect between two houses can be the other one from the house the events array leads with, and both are whole-sign houses of the bodies involved counted from this sign. Typically 80 to 120 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is the same material woven into one piece instead of split by topic. Deterministic: the same sign and period always returns the same text.
16061
+ * Weekly health, energy, and wellness guidance, read into the whole-sign houses of this sign. It opens on the event of the week that most reaches health, dated by its day, or on a quiet week a standing planet, naming the bodies, the aspect and the life area and what it stirs, then a human situation of this topic with a way through it, a conditional with a few options, and a close; the topic named in focus opens on the same event as column. Every named event is in events, with each participant sign and whole-sign house in placements at the event time. This section reads whichever participant house carries health; the aggregate event house remains the leading body house. Typically 120 to 160 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is a separate piece of its own. Deterministic: the same sign and period always returns the same text.
15928
16062
  */
15929
16063
  health: string;
15930
16064
  /**
15931
- * Weekly financial outlook, read into the whole-sign houses of this sign. The same ranked events that drive column, filtered to finance, plus the standing placements that reach it. Every event named here is in the events array, so a piece can be fact-checked before it runs; this section reads an event through whichever of its houses carries finance, which for an aspect between two houses can be the other one from the house the events array leads with, and both are whole-sign houses of the bodies involved counted from this sign. Typically 80 to 120 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is the same material woven into one piece instead of split by topic. Deterministic: the same sign and period always returns the same text.
16065
+ * Weekly financial outlook, read into the whole-sign houses of this sign. It opens on the event of the week that most reaches finance, dated by its day, or on a quiet week a standing planet, naming the bodies, the aspect and the life area and what it stirs, then a human situation of this topic with a way through it, a conditional with a few options, and a close; the topic named in focus opens on the same event as column. Every named event is in events, with each participant sign and whole-sign house in placements at the event time. This section reads whichever participant house carries finance; the aggregate event house remains the leading body house. Typically 120 to 160 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is a separate piece of its own. Deterministic: the same sign and period always returns the same text.
15932
16066
  */
15933
16067
  finance: string;
15934
16068
  /**
15935
- * The single actionable takeaway from the leading event of the period, read into the whole-sign houses of this sign and checkable against the events array. Drawn from the same event as overview, kept to a short, actionable pair of sentences rather than grown to match the other sections. Deterministic: the same sign and period always returns the same text.
16069
+ * The single actionable takeaway of the period. It opens on the event of the week that most reaches travel, belief, conversation and daily learning, or on a quiet week a standing planet, naming the bodies, the aspect and the life area, then a situation with a way through it, a conditional with a few options, and a close, in the shape of the five fields beside it. Deterministic: the same sign and period always returns the same text.
15936
16070
  */
15937
16071
  advice: string;
15938
16072
  /**
15939
- * The full column for this period, ready to run as one piece, with paragraphs separated by a blank line. Names the events driving it and the dates they fall on, read into the whole-sign houses of this sign. Typically 250 to 450 words. The six section fields read the same ranked events filtered to their own life area, each composed as a column of its own rather than an excerpt of this one, so render either shape and never both. Deterministic: the same sign and period always returns the same column.
16073
+ * The full column for this period, ready to run as one piece, its paragraphs, where it has more than one, separated by a blank line. Names the events driving it and the dates they fall on, read into the whole-sign houses of this sign. Typically 120 to 160 words. The six section fields each open on an event or standing planet of their own read through their life area, the one named in focus on the lead of this column, so render either shape and never both. Deterministic: the same sign and period always returns the same column.
15940
16074
  */
15941
16075
  column: string;
16076
+ /**
16077
+ * The topic this reading is mainly about: love, career, finance or health when the lead event falls in that life area, overview for a bigger-picture period. A machine value, canonical English in every language, so a client can route its own content on it (a related article, a product, a call to action) without parsing the prose; the topic field it names reads the same lead the column opens on.
16078
+ */
16079
+ focus: 'love' | 'career' | 'finance' | 'health' | 'overview';
15942
16080
  /**
15943
16081
  * The dated astronomical events this reading is built on, earliest first. Every field in every row can be checked against an independent authority, so a column can be fact-checked before it is published. Empty on a period in which nothing exact happens, where the reading falls back to the standing positions instead.
15944
16082
  */
@@ -15948,17 +16086,46 @@ export type GetWeeklyHoroscopeResponses = {
15948
16086
  */
15949
16087
  type: 'aspect' | 'sign-ingress' | 'retrograde-station' | 'lunar-phase' | 'eclipse' | 'solar-season';
15950
16088
  /**
15951
- * Exact instant the event perfects, UTC, to the second. Verifiable against NASA JPL Horizons for a position event and against the US Naval Observatory for a lunar phase or eclipse.
16089
+ * Exact instant the event perfects, ISO 8601 to the second, on the clock the reading is read on: UTC with Z by default, the offset of timezone when one is passed on a daily, weekly or monthly reading (2026-11-13T19:27:27-05:00 in New York), the same instant either way; a yearly reading is written in UTC. Verifiable against NASA JPL Horizons for a position event and against the US Naval Observatory for a lunar phase or eclipse.
15952
16090
  */
15953
16091
  at: string;
15954
16092
  /**
15955
16093
  * Bodies involved, canonical English regardless of the requested language so the value stays safe to switch on. Two entries for an aspect, faster body first. One entry for an ingress, a station, a lunar phase, or an eclipse.
15956
16094
  */
15957
16095
  bodies: Array<string>;
16096
+ /**
16097
+ * Each participant at the enclosing event timestamp, in bodies order: two entries for an aspect and one for every other event. Names and signs stay canonical English in every language. Each entry carries its own whole-sign house, including the second body of an aspect. Event placements can differ from positions, which reports noon on the first day of the period.
16098
+ */
16099
+ placements: Array<{
16100
+ /**
16101
+ * Body name, canonical English in every language. Matches the entry at the same index in bodies.
16102
+ */
16103
+ name: string;
16104
+ /**
16105
+ * Sign this body occupies at the event timestamp, lowercase and never translated. For a sign change, the sign entered.
16106
+ */
16107
+ sign: string;
16108
+ /**
16109
+ * Whole-sign house this body occupies at the event instant, counted from the queried sign, 1 to 12.
16110
+ */
16111
+ house: number;
16112
+ }>;
15958
16113
  /**
15959
16114
  * Angle formed, on aspect events only: conjunction, sextile, square, trine, opposition, semi-sextile, quincunx, semi-square, or sesquiquadrate.
15960
16115
  */
15961
16116
  aspect?: string;
16117
+ /**
16118
+ * Exact quarter phase, on lunar-phase events only: new-moon, first-quarter, full-moon, or last-quarter. Canonical English in every language. Use to identify the phase at the event instant.
16119
+ */
16120
+ phase?: 'new-moon' | 'first-quarter' | 'full-moon' | 'last-quarter';
16121
+ /**
16122
+ * Eclipse classification at peak, on eclipse events only: penumbral, partial, annular, or total. Canonical English in every language. Sun in bodies identifies a solar eclipse and Moon a lunar eclipse.
16123
+ */
16124
+ kind?: 'penumbral' | 'partial' | 'annular' | 'total';
16125
+ /**
16126
+ * Direction the body turns at the event instant, on retrograde-station events only: retrograde starts backward motion and direct ends it. Canonical English in every language. Present even when the other end of the retrograde span cannot be dated.
16127
+ */
16128
+ direction?: 'retrograde' | 'direct';
15962
16129
  /**
15963
16130
  * Sign the event falls in, lowercase, where it has exactly one. Absent for an aspect whose two bodies stand in different signs.
15964
16131
  */
@@ -15968,10 +16135,47 @@ export type GetWeeklyHoroscopeResponses = {
15968
16135
  */
15969
16136
  house: number;
15970
16137
  /**
15971
- * End of the window this event holds open, UTC, given only where a bounded window is a real fact about it: the orb span of an aspect, the sign span of an ingress or a season, the retrograde span of a station. Absent for a lunar phase or an eclipse, which are instants and not spans.
16138
+ * End of the window this event holds open, on the same clock as at, given only where a bounded window is a real fact about it: the orb span of an aspect, the sign span of an ingress or a season, the retrograde span of a station. Absent for a lunar phase or an eclipse, which are instants and not spans.
15972
16139
  */
15973
16140
  through?: string;
15974
16141
  }>;
16142
+ /**
16143
+ * Where each of the ten bodies stands for this reading, one row per body, so every standing claim in the prose (a body in a house, until a date, retrograde until it turns direct, exalted or at home) can be checked against the response itself. It carries state only: every aspect, lunation, eclipse, ingress or station of the period is a row of events[]. Against events[], it adds the bodies that do nothing exact in the period (events[] names only what happens), the entry and exit of the sign each stands in (events[].through carries an exit only for an ingress inside the period), the instant a retrograde body turns direct, and dignity. Against activeTransits, which the daily prints as translated strings for the seven visible bodies, it adds Uranus, Neptune and Pluto, the lowercase sign and numeric house as values, the retrograde flag as a boolean, and the three instants. Where an instant appears in both keys it is the same string. Never translated.
16144
+ */
16145
+ positions: Array<{
16146
+ /**
16147
+ * Body, canonical English regardless of the requested language: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune or Pluto, in that order, one row each. Same key and values as planets[].name on the natal chart.
16148
+ */
16149
+ name: string;
16150
+ /**
16151
+ * Sign the body stands in at noon on the first day of the period on the reader clock, lowercase like events[].sign, never translated.
16152
+ */
16153
+ sign: string;
16154
+ /**
16155
+ * Whole-sign house that sign is for the queried sign, 1 to 12, counted as events[].house is.
16156
+ */
16157
+ house: number;
16158
+ /**
16159
+ * Whether the body moves retrograde at that noon. Same key as planets[].isRetrograde on the natal chart; the daily activeTransits prints the same flag as a translated string.
16160
+ */
16161
+ isRetrograde: boolean;
16162
+ /**
16163
+ * Essential dignity of the body in that sign, the same value planets[].dignity reports on the natal chart: domicile, exaltation, detriment, fall, or peregrine. Always English. A column or card that calls a body at home or exalted is backed by this value.
16164
+ */
16165
+ dignity: 'domicile' | 'exaltation' | 'detriment' | 'fall' | 'peregrine';
16166
+ /**
16167
+ * Instant the body entered this sign, to the second, on the same clock as events[].at. Where the entry is also a row of events[] in this response it is that row at, byte for byte. Absent only where the entry lies too far back to date.
16168
+ */
16169
+ enteredAt?: string;
16170
+ /**
16171
+ * Instant the body next leaves this sign, to the second, on the same clock as events[].at: the date a column prints in until April 15. Where it is also in events[] (the ingress that ends the stay, or the through of the ingress that began it) it is that string, byte for byte. Absent only where the exit lies too far ahead to date.
16172
+ */
16173
+ leavesAt?: string;
16174
+ /**
16175
+ * Instant the body next turns direct, to the second, on the same clock as events[].at, present only while isRetrograde is true: the date a retrograde is dated by in the prose. Where the station is also in events[] it is that row at or through, byte for byte. Absent only where the turn lies too far ahead to date.
16176
+ */
16177
+ turnsDirectAt?: string;
16178
+ }>;
15975
16179
  /**
15976
16180
  * The three most favorable days this week, from the planetary rulers of the seven weekdays, ranked by how strongly each of those planets stands for this sign.
15977
16181
  */
@@ -15981,7 +16185,7 @@ export type GetWeeklyHoroscopeResponses = {
15981
16185
  */
15982
16186
  luckyNumbers: Array<number>;
15983
16187
  /**
15984
- * Most compatible zodiac signs for this sign. Trine partners (same element) followed by a sextile partner (complementary element).
16188
+ * Three zodiac signs most in tune with this sign this week, best first. Read from the real sky of the period, so the list moves with the transits instead of repeating a fixed table, and every pick can be traced in positions[]. On a quiet sky it settles on the classic element partners. For the fixed sign-to-sign pairing, read compatibleSigns from the signs endpoint.
15985
16189
  */
15986
16190
  compatibleSigns: Array<string>;
15987
16191
  };
@@ -16005,7 +16209,7 @@ export type GetMonthlyHoroscopeData = {
16005
16209
  */
16006
16210
  date?: string;
16007
16211
  /**
16008
- * Selects which period counts as current when date is omitted. Defaults to UTC, so the forecast rolls over at 00:00 UTC on the 1st. Pass the timezone of the end user to roll over on their local clock instead. Ignored when date is set. Accepts an IANA name (e.g. "America/New_York"), decimal hours (e.g. 5.5 for IST), or a fixed UTC offset (e.g. "-05:00").
16212
+ * The clock the month is read on: it decides which events fall inside the calendar month, the date each is dated by, and which month is current when date is omitted. Defaults to UTC. Accepts an IANA name (e.g. "America/New_York"), decimal hours (e.g. 5.5 for IST), or a fixed UTC offset (e.g. "-05:00").
16009
16213
  */
16010
16214
  timezone?: string;
16011
16215
  };
@@ -16147,33 +16351,37 @@ export type GetMonthlyHoroscopeResponses = {
16147
16351
  */
16148
16352
  month: string;
16149
16353
  /**
16150
- * The single most relevant event of the period, whichever life area it touches, read into the whole-sign houses of this sign. The same event that leads column, at lede length rather than developed into a full movement, and checkable against the events array. Typically 55 to 100 words. Join it with love, career, health and finance for a general reading built from the six sections. Deterministic: the same sign and period always returns the same text.
16354
+ * The event of the month that most reaches home, roots and the self, or on a quiet month a standing planet, written as the five topic fields are and opening on the lead of column whenever focus is overview. Typically 35 to 90 words. Join it with love, career, health and finance for a general reading built from the six sections. Deterministic: the same sign and period always returns the same text.
16151
16355
  */
16152
16356
  overview: string;
16153
16357
  /**
16154
- * Monthly love and relationship forecast, read into the whole-sign houses of this sign. The same ranked events that drive column, filtered to romance and partnership, plus the standing placements that reach it. Every event named here is in the events array, so a piece can be fact-checked before it runs; this section reads an event through whichever of its houses carries romance and partnership, which for an aspect between two houses can be the other one from the house the events array leads with, and both are whole-sign houses of the bodies involved counted from this sign. Typically 120 to 200 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is the same material woven into one piece instead of split by topic. Deterministic: the same sign and period always returns the same text.
16358
+ * Monthly love and relationship forecast, read into the whole-sign houses of this sign. It is the love monthly, a full piece that reads every transit of the month that reaches romance and partnership through love, in date order, each dated, then a close. Every named event is in events, with each participant sign and whole-sign house in placements at the event time. This section reads whichever participant house carries romance and partnership; the aggregate event house remains the leading body house. Typically 180 to 250 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is a separate piece of its own. Deterministic: the same sign and period always returns the same text.
16155
16359
  */
16156
16360
  love: string;
16157
16361
  /**
16158
- * Monthly career and professional outlook, read into the whole-sign houses of this sign. The same ranked events that drive column, filtered to career, work and reputation, plus the standing placements that reach it. Every event named here is in the events array, so a piece can be fact-checked before it runs; this section reads an event through whichever of its houses carries career, work and reputation, which for an aspect between two houses can be the other one from the house the events array leads with, and both are whole-sign houses of the bodies involved counted from this sign. Typically 120 to 200 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is the same material woven into one piece instead of split by topic. Deterministic: the same sign and period always returns the same text.
16362
+ * Monthly career and professional outlook, read into the whole-sign houses of this sign. It opens on the event of the month that most reaches career, work and reputation, dated, or on a quiet month a standing planet, naming the bodies, the aspect and the life area and what it stirs, then a human situation of this topic with a way through it, a conditional with a few options, and a close; the topic named in focus opens on the same event as column. Every named event is in events, with each participant sign and whole-sign house in placements at the event time. This section reads whichever participant house carries career, work and reputation; the aggregate event house remains the leading body house. Typically 35 to 90 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is a separate piece of its own. Deterministic: the same sign and period always returns the same text.
16159
16363
  */
16160
16364
  career: string;
16161
16365
  /**
16162
- * Monthly health and wellness guidance, read into the whole-sign houses of this sign. The same ranked events that drive column, filtered to health, plus the standing placements that reach it. Every event named here is in the events array, so a piece can be fact-checked before it runs; this section reads an event through whichever of its houses carries health, which for an aspect between two houses can be the other one from the house the events array leads with, and both are whole-sign houses of the bodies involved counted from this sign. Typically 120 to 200 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is the same material woven into one piece instead of split by topic. Deterministic: the same sign and period always returns the same text.
16366
+ * Monthly health and wellness guidance, read into the whole-sign houses of this sign. It opens on the event of the month that most reaches health, dated, or on a quiet month a standing planet, naming the bodies, the aspect and the life area and what it stirs, then a human situation of this topic with a way through it, a conditional with a few options, and a close; the topic named in focus opens on the same event as column. Every named event is in events, with each participant sign and whole-sign house in placements at the event time. This section reads whichever participant house carries health; the aggregate event house remains the leading body house. Typically 35 to 90 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is a separate piece of its own. Deterministic: the same sign and period always returns the same text.
16163
16367
  */
16164
16368
  health: string;
16165
16369
  /**
16166
- * Monthly financial outlook and guidance, read into the whole-sign houses of this sign. The same ranked events that drive column, filtered to finance, plus the standing placements that reach it. Every event named here is in the events array, so a piece can be fact-checked before it runs; this section reads an event through whichever of its houses carries finance, which for an aspect between two houses can be the other one from the house the events array leads with, and both are whole-sign houses of the bodies involved counted from this sign. Typically 120 to 200 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is the same material woven into one piece instead of split by topic. Deterministic: the same sign and period always returns the same text.
16370
+ * Monthly financial outlook and guidance, read into the whole-sign houses of this sign. It opens on the event of the month that most reaches finance, dated, or on a quiet month a standing planet, naming the bodies, the aspect and the life area and what it stirs, then a human situation of this topic with a way through it, a conditional with a few options, and a close; the topic named in focus opens on the same event as column. Every named event is in events, with each participant sign and whole-sign house in placements at the event time. This section reads whichever participant house carries finance; the aggregate event house remains the leading body house. Typically 35 to 90 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is a separate piece of its own. Deterministic: the same sign and period always returns the same text.
16167
16371
  */
16168
16372
  finance: string;
16169
16373
  /**
16170
- * The single actionable takeaway from the leading event of the period, read into the whole-sign houses of this sign and checkable against the events array. Drawn from the same event as overview, kept to a short, actionable pair of sentences rather than grown to match the other sections. Deterministic: the same sign and period always returns the same text.
16374
+ * The single actionable takeaway of the period. It opens on the event of the month that most reaches travel, belief, conversation and daily learning, or on a quiet month a standing planet, naming the bodies, the aspect and the life area, then a situation with a way through it, a conditional with a few options, and a close, in the shape of the five fields beside it. Deterministic: the same sign and period always returns the same text.
16171
16375
  */
16172
16376
  advice: string;
16173
16377
  /**
16174
- * The full column for this period, ready to run as one piece, with paragraphs separated by a blank line. Names the events driving it and the dates they fall on, read into the whole-sign houses of this sign. Typically 400 to 700 words. The six section fields read the same ranked events filtered to their own life area, each composed as a column of its own rather than an excerpt of this one, so render either shape and never both. Deterministic: the same sign and period always returns the same column.
16378
+ * The full column for this period, ready to run as one piece, its paragraphs, where it has more than one, separated by a blank line. Names the events driving it and the dates they fall on, read into the whole-sign houses of this sign. Typically 180 to 250 words. The six section fields each open on an event or standing planet of their own read through their life area, the one named in focus on the lead of this column, so render either shape and never both. Deterministic: the same sign and period always returns the same column.
16175
16379
  */
16176
16380
  column: string;
16381
+ /**
16382
+ * The topic this reading is mainly about: love, career, finance or health when the lead event falls in that life area, overview for a bigger-picture period. A machine value, canonical English in every language, so a client can route its own content on it (a related article, a product, a call to action) without parsing the prose; the topic field it names reads the same lead the column opens on.
16383
+ */
16384
+ focus: 'love' | 'career' | 'finance' | 'health' | 'overview';
16177
16385
  /**
16178
16386
  * The dated astronomical events this reading is built on, earliest first. Every field in every row can be checked against an independent authority, so a column can be fact-checked before it is published. Empty on a period in which nothing exact happens, where the reading falls back to the standing positions instead.
16179
16387
  */
@@ -16183,17 +16391,46 @@ export type GetMonthlyHoroscopeResponses = {
16183
16391
  */
16184
16392
  type: 'aspect' | 'sign-ingress' | 'retrograde-station' | 'lunar-phase' | 'eclipse' | 'solar-season';
16185
16393
  /**
16186
- * Exact instant the event perfects, UTC, to the second. Verifiable against NASA JPL Horizons for a position event and against the US Naval Observatory for a lunar phase or eclipse.
16394
+ * Exact instant the event perfects, ISO 8601 to the second, on the clock the reading is read on: UTC with Z by default, the offset of timezone when one is passed on a daily, weekly or monthly reading (2026-11-13T19:27:27-05:00 in New York), the same instant either way; a yearly reading is written in UTC. Verifiable against NASA JPL Horizons for a position event and against the US Naval Observatory for a lunar phase or eclipse.
16187
16395
  */
16188
16396
  at: string;
16189
16397
  /**
16190
16398
  * Bodies involved, canonical English regardless of the requested language so the value stays safe to switch on. Two entries for an aspect, faster body first. One entry for an ingress, a station, a lunar phase, or an eclipse.
16191
16399
  */
16192
16400
  bodies: Array<string>;
16401
+ /**
16402
+ * Each participant at the enclosing event timestamp, in bodies order: two entries for an aspect and one for every other event. Names and signs stay canonical English in every language. Each entry carries its own whole-sign house, including the second body of an aspect. Event placements can differ from positions, which reports noon on the first day of the period.
16403
+ */
16404
+ placements: Array<{
16405
+ /**
16406
+ * Body name, canonical English in every language. Matches the entry at the same index in bodies.
16407
+ */
16408
+ name: string;
16409
+ /**
16410
+ * Sign this body occupies at the event timestamp, lowercase and never translated. For a sign change, the sign entered.
16411
+ */
16412
+ sign: string;
16413
+ /**
16414
+ * Whole-sign house this body occupies at the event instant, counted from the queried sign, 1 to 12.
16415
+ */
16416
+ house: number;
16417
+ }>;
16193
16418
  /**
16194
16419
  * Angle formed, on aspect events only: conjunction, sextile, square, trine, opposition, semi-sextile, quincunx, semi-square, or sesquiquadrate.
16195
16420
  */
16196
16421
  aspect?: string;
16422
+ /**
16423
+ * Exact quarter phase, on lunar-phase events only: new-moon, first-quarter, full-moon, or last-quarter. Canonical English in every language. Use to identify the phase at the event instant.
16424
+ */
16425
+ phase?: 'new-moon' | 'first-quarter' | 'full-moon' | 'last-quarter';
16426
+ /**
16427
+ * Eclipse classification at peak, on eclipse events only: penumbral, partial, annular, or total. Canonical English in every language. Sun in bodies identifies a solar eclipse and Moon a lunar eclipse.
16428
+ */
16429
+ kind?: 'penumbral' | 'partial' | 'annular' | 'total';
16430
+ /**
16431
+ * Direction the body turns at the event instant, on retrograde-station events only: retrograde starts backward motion and direct ends it. Canonical English in every language. Present even when the other end of the retrograde span cannot be dated.
16432
+ */
16433
+ direction?: 'retrograde' | 'direct';
16197
16434
  /**
16198
16435
  * Sign the event falls in, lowercase, where it has exactly one. Absent for an aspect whose two bodies stand in different signs.
16199
16436
  */
@@ -16203,10 +16440,47 @@ export type GetMonthlyHoroscopeResponses = {
16203
16440
  */
16204
16441
  house: number;
16205
16442
  /**
16206
- * End of the window this event holds open, UTC, given only where a bounded window is a real fact about it: the orb span of an aspect, the sign span of an ingress or a season, the retrograde span of a station. Absent for a lunar phase or an eclipse, which are instants and not spans.
16443
+ * End of the window this event holds open, on the same clock as at, given only where a bounded window is a real fact about it: the orb span of an aspect, the sign span of an ingress or a season, the retrograde span of a station. Absent for a lunar phase or an eclipse, which are instants and not spans.
16207
16444
  */
16208
16445
  through?: string;
16209
16446
  }>;
16447
+ /**
16448
+ * Where each of the ten bodies stands for this reading, one row per body, so every standing claim in the prose (a body in a house, until a date, retrograde until it turns direct, exalted or at home) can be checked against the response itself. It carries state only: every aspect, lunation, eclipse, ingress or station of the period is a row of events[]. Against events[], it adds the bodies that do nothing exact in the period (events[] names only what happens), the entry and exit of the sign each stands in (events[].through carries an exit only for an ingress inside the period), the instant a retrograde body turns direct, and dignity. Against activeTransits, which the daily prints as translated strings for the seven visible bodies, it adds Uranus, Neptune and Pluto, the lowercase sign and numeric house as values, the retrograde flag as a boolean, and the three instants. Where an instant appears in both keys it is the same string. Never translated.
16449
+ */
16450
+ positions: Array<{
16451
+ /**
16452
+ * Body, canonical English regardless of the requested language: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune or Pluto, in that order, one row each. Same key and values as planets[].name on the natal chart.
16453
+ */
16454
+ name: string;
16455
+ /**
16456
+ * Sign the body stands in at noon on the first day of the period on the reader clock, lowercase like events[].sign, never translated.
16457
+ */
16458
+ sign: string;
16459
+ /**
16460
+ * Whole-sign house that sign is for the queried sign, 1 to 12, counted as events[].house is.
16461
+ */
16462
+ house: number;
16463
+ /**
16464
+ * Whether the body moves retrograde at that noon. Same key as planets[].isRetrograde on the natal chart; the daily activeTransits prints the same flag as a translated string.
16465
+ */
16466
+ isRetrograde: boolean;
16467
+ /**
16468
+ * Essential dignity of the body in that sign, the same value planets[].dignity reports on the natal chart: domicile, exaltation, detriment, fall, or peregrine. Always English. A column or card that calls a body at home or exalted is backed by this value.
16469
+ */
16470
+ dignity: 'domicile' | 'exaltation' | 'detriment' | 'fall' | 'peregrine';
16471
+ /**
16472
+ * Instant the body entered this sign, to the second, on the same clock as events[].at. Where the entry is also a row of events[] in this response it is that row at, byte for byte. Absent only where the entry lies too far back to date.
16473
+ */
16474
+ enteredAt?: string;
16475
+ /**
16476
+ * Instant the body next leaves this sign, to the second, on the same clock as events[].at: the date a column prints in until April 15. Where it is also in events[] (the ingress that ends the stay, or the through of the ingress that began it) it is that string, byte for byte. Absent only where the exit lies too far ahead to date.
16477
+ */
16478
+ leavesAt?: string;
16479
+ /**
16480
+ * Instant the body next turns direct, to the second, on the same clock as events[].at, present only while isRetrograde is true: the date a retrograde is dated by in the prose. Where the station is also in events[] it is that row at or through, byte for byte. Absent only where the turn lies too far ahead to date.
16481
+ */
16482
+ turnsDirectAt?: string;
16483
+ }>;
16210
16484
  /**
16211
16485
  * The month read one calendar week at a time, off the same ranked events as column and events[]: the life area each week turns on, and the one thing that area asks for. Two weeks may land in the same area, because two events of a month often do; the sentence beside it is always different. Use it for the week strip of a monthly page.
16212
16486
  */
@@ -16220,20 +16494,20 @@ export type GetMonthlyHoroscopeResponses = {
16220
16494
  */
16221
16495
  focus: string;
16222
16496
  /**
16223
- * What that house asks for, as one sentence in the requested language. No two weeks of one month repeat a sentence.
16497
+ * One practical sentence for that life area, in the requested language. No two weeks of one month repeat a sentence.
16224
16498
  */
16225
16499
  advice: string;
16226
16500
  }>;
16227
16501
  /**
16228
- * The dates to circle this month, earliest first: every lunation and eclipse of the month, plus the headline movements the reading is built on, which are the sign changes of the slower planets and every station with the direction it turns. Each is placed in the whole-sign house it reaches for this sign. Every row is an instant the ephemeris gives, checkable against NASA JPL Horizons or the US Naval Observatory, and every row that is not a lunation or an eclipse is also a row of events[], so the list cannot contradict the reading beside it.
16502
+ * The dates to circle this month, earliest first: every lunation and eclipse of the month, plus the headline movements the reading is built on, which are the sign changes of the slower planets and every station with the direction it turns. Each is placed in the whole-sign house it reaches for this sign. Every row is an instant the ephemeris gives, checkable against NASA JPL Horizons or the US Naval Observatory, and every row is also a row of events[], so the list cannot contradict the reading beside it.
16229
16503
  */
16230
16504
  keyDates: Array<{
16231
16505
  /**
16232
- * UTC date of the event (YYYY-MM-DD). The exact instant, to the second, is on the matching row of events[].
16506
+ * Date of the event (YYYY-MM-DD) on the clock the month is read on, the day the column names it: a station at 00:27 UTC is the previous day in New York. The exact instant, to the second, is on the matching row of events[].
16233
16507
  */
16234
16508
  date: string;
16235
16509
  /**
16236
- * The event as one sentence in the requested language, placed in the whole-sign house it reaches for this sign.
16510
+ * The event in the requested language, with the sign it falls in and the life area of the whole-sign house that sign is for this zodiac sign, as a dated calendar list prints it.
16237
16511
  */
16238
16512
  event: string;
16239
16513
  }>;
@@ -16242,11 +16516,11 @@ export type GetMonthlyHoroscopeResponses = {
16242
16516
  */
16243
16517
  luckyNumbers: Array<number>;
16244
16518
  /**
16245
- * Lucky color for the month, drawn from the three colors of the sign element and selected by the planet governing the reading.
16519
+ * Lucky color for the month, the color traditionally ruled by the planet that governs this sign this month: Sun gold, Moon silver, Mercury light blue, Venus green, Mars red, Jupiter purple, Saturn brown. When Uranus, Neptune or Pluto governs, the next most governing of the seven classical planets gives the color. Translated with the lang parameter.
16246
16520
  */
16247
16521
  luckyColor: string;
16248
16522
  /**
16249
- * Most compatible zodiac signs for this sign. Trine partners (same element) followed by a sextile partner (complementary element).
16523
+ * Three zodiac signs most in tune with this sign this month, best first. Read from the real sky of the period, so the list moves with the transits instead of repeating a fixed table, and every pick can be traced in positions[]. On a quiet sky it settles on the classic element partners. For the fixed sign-to-sign pairing, read compatibleSigns from the signs endpoint.
16250
16524
  */
16251
16525
  compatibleSigns: Array<string>;
16252
16526
  };
@@ -16412,33 +16686,37 @@ export type GetYearlyHoroscopeResponses = {
16412
16686
  */
16413
16687
  year: number;
16414
16688
  /**
16415
- * The single most relevant event of the period, whichever life area it touches, read into the whole-sign houses of this sign. The same event that leads column, at lede length rather than developed into a full movement, and checkable against the events array. Typically 70 to 120 words. Join it with love, career, health and finance for a general reading built from the six sections. Deterministic: the same sign and period always returns the same text.
16689
+ * The event of the year that most reaches home, roots and the self, or on a quiet year a standing planet, written as the five topic fields are and opening on the lead of column whenever focus is overview. Typically 35 to 90 words. Join it with love, career, health and finance for a general reading built from the six sections. Deterministic: the same sign and period always returns the same text.
16416
16690
  */
16417
16691
  overview: string;
16418
16692
  /**
16419
- * Yearly love and relationship outlook, read into the whole-sign houses of this sign. The same ranked events that drive column, filtered to romance and partnership, plus the standing placements that reach it. Every event named here is in the events array, so a piece can be fact-checked before it runs; this section reads an event through whichever of its houses carries romance and partnership, which for an aspect between two houses can be the other one from the house the events array leads with, and both are whole-sign houses of the bodies involved counted from this sign. Typically 150 to 260 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is the same material woven into one piece instead of split by topic. Deterministic: the same sign and period always returns the same text.
16693
+ * Yearly love and relationship outlook, read into the whole-sign houses of this sign. It opens on the event of the year that most reaches romance and partnership, dated, or on a quiet year a standing planet, naming the bodies, the aspect and the life area and what it stirs, then a human situation of this topic with a way through it, a conditional with a few options, and a close; the topic named in focus opens on the same event as column. Every named event is in events, with each participant sign and whole-sign house in placements at the event time. This section reads whichever participant house carries romance and partnership; the aggregate event house remains the leading body house. Typically 35 to 90 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is a separate piece of its own. Deterministic: the same sign and period always returns the same text.
16420
16694
  */
16421
16695
  love: string;
16422
16696
  /**
16423
- * Yearly career and professional outlook, read into the whole-sign houses of this sign. The same ranked events that drive column, filtered to career, work and reputation, plus the standing placements that reach it. Every event named here is in the events array, so a piece can be fact-checked before it runs; this section reads an event through whichever of its houses carries career, work and reputation, which for an aspect between two houses can be the other one from the house the events array leads with, and both are whole-sign houses of the bodies involved counted from this sign. Typically 150 to 260 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is the same material woven into one piece instead of split by topic. Deterministic: the same sign and period always returns the same text.
16697
+ * Yearly career and professional outlook, read into the whole-sign houses of this sign. It opens on the event of the year that most reaches career, work and reputation, dated, or on a quiet year a standing planet, naming the bodies, the aspect and the life area and what it stirs, then a human situation of this topic with a way through it, a conditional with a few options, and a close; the topic named in focus opens on the same event as column. Every named event is in events, with each participant sign and whole-sign house in placements at the event time. This section reads whichever participant house carries career, work and reputation; the aggregate event house remains the leading body house. Typically 35 to 90 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is a separate piece of its own. Deterministic: the same sign and period always returns the same text.
16424
16698
  */
16425
16699
  career: string;
16426
16700
  /**
16427
- * Yearly health, energy, and wellness outlook, read into the whole-sign houses of this sign. The same ranked events that drive column, filtered to health, plus the standing placements that reach it. Every event named here is in the events array, so a piece can be fact-checked before it runs; this section reads an event through whichever of its houses carries health, which for an aspect between two houses can be the other one from the house the events array leads with, and both are whole-sign houses of the bodies involved counted from this sign. Typically 150 to 260 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is the same material woven into one piece instead of split by topic. Deterministic: the same sign and period always returns the same text.
16701
+ * Yearly health, energy, and wellness outlook, read into the whole-sign houses of this sign. It opens on the event of the year that most reaches health, dated, or on a quiet year a standing planet, naming the bodies, the aspect and the life area and what it stirs, then a human situation of this topic with a way through it, a conditional with a few options, and a close; the topic named in focus opens on the same event as column. Every named event is in events, with each participant sign and whole-sign house in placements at the event time. This section reads whichever participant house carries health; the aggregate event house remains the leading body house. Typically 35 to 90 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is a separate piece of its own. Deterministic: the same sign and period always returns the same text.
16428
16702
  */
16429
16703
  health: string;
16430
16704
  /**
16431
- * Yearly financial outlook, read into the whole-sign houses of this sign. The same ranked events that drive column, filtered to finance, plus the standing placements that reach it. Every event named here is in the events array, so a piece can be fact-checked before it runs; this section reads an event through whichever of its houses carries finance, which for an aspect between two houses can be the other one from the house the events array leads with, and both are whole-sign houses of the bodies involved counted from this sign. Typically 150 to 260 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is the same material woven into one piece instead of split by topic. Deterministic: the same sign and period always returns the same text.
16705
+ * Yearly financial outlook, read into the whole-sign houses of this sign. It opens on the event of the year that most reaches finance, dated, or on a quiet year a standing planet, naming the bodies, the aspect and the life area and what it stirs, then a human situation of this topic with a way through it, a conditional with a few options, and a close; the topic named in focus opens on the same event as column. Every named event is in events, with each participant sign and whole-sign house in placements at the event time. This section reads whichever participant house carries finance; the aggregate event house remains the leading body house. Typically 35 to 90 words. Render it alone for a single-topic page, or alongside the other five sections for a general reading; column is a separate piece of its own. Deterministic: the same sign and period always returns the same text.
16432
16706
  */
16433
16707
  finance: string;
16434
16708
  /**
16435
- * The single actionable takeaway from the leading event of the period, read into the whole-sign houses of this sign and checkable against the events array. Drawn from the same event as overview, kept to a short, actionable pair of sentences rather than grown to match the other sections. Deterministic: the same sign and period always returns the same text.
16709
+ * The single actionable takeaway of the period. It opens on the event of the year that most reaches travel, belief, conversation and daily learning, or on a quiet year a standing planet, naming the bodies, the aspect and the life area, then a situation with a way through it, a conditional with a few options, and a close, in the shape of the five fields beside it. Deterministic: the same sign and period always returns the same text.
16436
16710
  */
16437
16711
  advice: string;
16438
16712
  /**
16439
- * The full column for this period, ready to run as one piece, with paragraphs separated by a blank line. Names the events driving it and the dates they fall on, read into the whole-sign houses of this sign. Typically 600 to 900 words. The six section fields read the same ranked events filtered to their own life area, each composed as a column of its own rather than an excerpt of this one, so render either shape and never both. Deterministic: the same sign and period always returns the same column.
16713
+ * The full column for this period, ready to run as one piece, its paragraphs, where it has more than one, separated by a blank line. Names the events driving it and the dates they fall on, read into the whole-sign houses of this sign. Typically 190 to 320 words. The six section fields each open on an event or standing planet of their own read through their life area, the one named in focus on the lead of this column, so render either shape and never both. Deterministic: the same sign and period always returns the same column.
16440
16714
  */
16441
16715
  column: string;
16716
+ /**
16717
+ * The topic this reading is mainly about: love, career, finance or health when the lead event falls in that life area, overview for a bigger-picture period. A machine value, canonical English in every language, so a client can route its own content on it (a related article, a product, a call to action) without parsing the prose; the topic field it names reads the same lead the column opens on.
16718
+ */
16719
+ focus: 'love' | 'career' | 'finance' | 'health' | 'overview';
16442
16720
  /**
16443
16721
  * The dated astronomical events this reading is built on, earliest first. Every field in every row can be checked against an independent authority, so a column can be fact-checked before it is published. Empty on a period in which nothing exact happens, where the reading falls back to the standing positions instead.
16444
16722
  */
@@ -16448,17 +16726,46 @@ export type GetYearlyHoroscopeResponses = {
16448
16726
  */
16449
16727
  type: 'aspect' | 'sign-ingress' | 'retrograde-station' | 'lunar-phase' | 'eclipse' | 'solar-season';
16450
16728
  /**
16451
- * Exact instant the event perfects, UTC, to the second. Verifiable against NASA JPL Horizons for a position event and against the US Naval Observatory for a lunar phase or eclipse.
16729
+ * Exact instant the event perfects, ISO 8601 to the second, on the clock the reading is read on: UTC with Z by default, the offset of timezone when one is passed on a daily, weekly or monthly reading (2026-11-13T19:27:27-05:00 in New York), the same instant either way; a yearly reading is written in UTC. Verifiable against NASA JPL Horizons for a position event and against the US Naval Observatory for a lunar phase or eclipse.
16452
16730
  */
16453
16731
  at: string;
16454
16732
  /**
16455
16733
  * Bodies involved, canonical English regardless of the requested language so the value stays safe to switch on. Two entries for an aspect, faster body first. One entry for an ingress, a station, a lunar phase, or an eclipse.
16456
16734
  */
16457
16735
  bodies: Array<string>;
16736
+ /**
16737
+ * Each participant at the enclosing event timestamp, in bodies order: two entries for an aspect and one for every other event. Names and signs stay canonical English in every language. Each entry carries its own whole-sign house, including the second body of an aspect. Event placements can differ from positions, which reports noon on the first day of the period.
16738
+ */
16739
+ placements: Array<{
16740
+ /**
16741
+ * Body name, canonical English in every language. Matches the entry at the same index in bodies.
16742
+ */
16743
+ name: string;
16744
+ /**
16745
+ * Sign this body occupies at the event timestamp, lowercase and never translated. For a sign change, the sign entered.
16746
+ */
16747
+ sign: string;
16748
+ /**
16749
+ * Whole-sign house this body occupies at the event instant, counted from the queried sign, 1 to 12.
16750
+ */
16751
+ house: number;
16752
+ }>;
16458
16753
  /**
16459
16754
  * Angle formed, on aspect events only: conjunction, sextile, square, trine, opposition, semi-sextile, quincunx, semi-square, or sesquiquadrate.
16460
16755
  */
16461
16756
  aspect?: string;
16757
+ /**
16758
+ * Exact quarter phase, on lunar-phase events only: new-moon, first-quarter, full-moon, or last-quarter. Canonical English in every language. Use to identify the phase at the event instant.
16759
+ */
16760
+ phase?: 'new-moon' | 'first-quarter' | 'full-moon' | 'last-quarter';
16761
+ /**
16762
+ * Eclipse classification at peak, on eclipse events only: penumbral, partial, annular, or total. Canonical English in every language. Sun in bodies identifies a solar eclipse and Moon a lunar eclipse.
16763
+ */
16764
+ kind?: 'penumbral' | 'partial' | 'annular' | 'total';
16765
+ /**
16766
+ * Direction the body turns at the event instant, on retrograde-station events only: retrograde starts backward motion and direct ends it. Canonical English in every language. Present even when the other end of the retrograde span cannot be dated.
16767
+ */
16768
+ direction?: 'retrograde' | 'direct';
16462
16769
  /**
16463
16770
  * Sign the event falls in, lowercase, where it has exactly one. Absent for an aspect whose two bodies stand in different signs.
16464
16771
  */
@@ -16468,10 +16775,47 @@ export type GetYearlyHoroscopeResponses = {
16468
16775
  */
16469
16776
  house: number;
16470
16777
  /**
16471
- * End of the window this event holds open, UTC, given only where a bounded window is a real fact about it: the orb span of an aspect, the sign span of an ingress or a season, the retrograde span of a station. Absent for a lunar phase or an eclipse, which are instants and not spans.
16778
+ * End of the window this event holds open, on the same clock as at, given only where a bounded window is a real fact about it: the orb span of an aspect, the sign span of an ingress or a season, the retrograde span of a station. Absent for a lunar phase or an eclipse, which are instants and not spans.
16472
16779
  */
16473
16780
  through?: string;
16474
16781
  }>;
16782
+ /**
16783
+ * Where each of the ten bodies stands for this reading, one row per body, so every standing claim in the prose (a body in a house, until a date, retrograde until it turns direct, exalted or at home) can be checked against the response itself. It carries state only: every aspect, lunation, eclipse, ingress or station of the period is a row of events[]. Against events[], it adds the bodies that do nothing exact in the period (events[] names only what happens), the entry and exit of the sign each stands in (events[].through carries an exit only for an ingress inside the period), the instant a retrograde body turns direct, and dignity. Against activeTransits, which the daily prints as translated strings for the seven visible bodies, it adds Uranus, Neptune and Pluto, the lowercase sign and numeric house as values, the retrograde flag as a boolean, and the three instants. Where an instant appears in both keys it is the same string. Never translated.
16784
+ */
16785
+ positions: Array<{
16786
+ /**
16787
+ * Body, canonical English regardless of the requested language: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune or Pluto, in that order, one row each. Same key and values as planets[].name on the natal chart.
16788
+ */
16789
+ name: string;
16790
+ /**
16791
+ * Sign the body stands in at noon on the first day of the period on the reader clock, lowercase like events[].sign, never translated.
16792
+ */
16793
+ sign: string;
16794
+ /**
16795
+ * Whole-sign house that sign is for the queried sign, 1 to 12, counted as events[].house is.
16796
+ */
16797
+ house: number;
16798
+ /**
16799
+ * Whether the body moves retrograde at that noon. Same key as planets[].isRetrograde on the natal chart; the daily activeTransits prints the same flag as a translated string.
16800
+ */
16801
+ isRetrograde: boolean;
16802
+ /**
16803
+ * Essential dignity of the body in that sign, the same value planets[].dignity reports on the natal chart: domicile, exaltation, detriment, fall, or peregrine. Always English. A column or card that calls a body at home or exalted is backed by this value.
16804
+ */
16805
+ dignity: 'domicile' | 'exaltation' | 'detriment' | 'fall' | 'peregrine';
16806
+ /**
16807
+ * Instant the body entered this sign, to the second, on the same clock as events[].at. Where the entry is also a row of events[] in this response it is that row at, byte for byte. Absent only where the entry lies too far back to date.
16808
+ */
16809
+ enteredAt?: string;
16810
+ /**
16811
+ * Instant the body next leaves this sign, to the second, on the same clock as events[].at: the date a column prints in until April 15. Where it is also in events[] (the ingress that ends the stay, or the through of the ingress that began it) it is that string, byte for byte. Absent only where the exit lies too far ahead to date.
16812
+ */
16813
+ leavesAt?: string;
16814
+ /**
16815
+ * Instant the body next turns direct, to the second, on the same clock as events[].at, present only while isRetrograde is true: the date a retrograde is dated by in the prose. Where the station is also in events[] it is that row at or through, byte for byte. Absent only where the turn lies too far ahead to date.
16816
+ */
16817
+ turnsDirectAt?: string;
16818
+ }>;
16475
16819
  /**
16476
16820
  * The backdrop of the year: which whole-sign house each slow-moving body occupies for this sign, Jupiter first and Pluto last. One row per unbroken stretch, so a body that stays put is a single row spanning the year and a body that changes sign is two rows with the exact date between them. Dates are the part of the stretch that falls inside this year; the full span of a change that happens inside the year is in the events array. Use it for the year-at-a-glance panel a year-ahead page opens with.
16477
16821
  */
@@ -16650,11 +16994,11 @@ export type GetYearlyHoroscopeResponses = {
16650
16994
  */
16651
16995
  luckyNumbers: Array<number>;
16652
16996
  /**
16653
- * Lucky color for the year, drawn from the three colors of the sign element and selected by the planet governing the reading.
16997
+ * Lucky color for the year, the color traditionally ruled by the planet that governs this sign this year: Sun gold, Moon silver, Mercury light blue, Venus green, Mars red, Jupiter purple, Saturn brown. When Uranus, Neptune or Pluto governs, the next most governing of the seven classical planets gives the color. Translated with the lang parameter.
16654
16998
  */
16655
16999
  luckyColor: string;
16656
17000
  /**
16657
- * Most compatible zodiac signs for this sign. Trine partners (same element) followed by a sextile partner (complementary element).
17001
+ * Three zodiac signs most in tune with this sign this year, best first. Read from the real sky of the period, so the list moves with the transits instead of repeating a fixed table, and every pick can be traced in positions[]. On a quiet sky it settles on the classic element partners. For the fixed sign-to-sign pairing, read compatibleSigns from the signs endpoint.
16658
17002
  */
16659
17003
  compatibleSigns: Array<string>;
16660
17004
  };