@roxyapi/ui-react 0.47.0 → 0.49.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 (315) hide show
  1. package/AGENTS.md +4 -4
  2. package/README.md +5 -5
  3. package/dist/components/almanac-day.d.ts +2 -0
  4. package/dist/components/almanac-day.d.ts.map +1 -1
  5. package/dist/components/almanac-day.js +1 -1
  6. package/dist/components/almanac-day.js.map +3 -3
  7. package/dist/components/angel-number-card.d.ts +2 -0
  8. package/dist/components/angel-number-card.d.ts.map +1 -1
  9. package/dist/components/angel-number-card.js +1 -1
  10. package/dist/components/angel-number-card.js.map +3 -3
  11. package/dist/components/angel-number-lookup.d.ts +2 -0
  12. package/dist/components/angel-number-lookup.d.ts.map +1 -1
  13. package/dist/components/angel-number-lookup.js +1 -1
  14. package/dist/components/angel-number-lookup.js.map +3 -3
  15. package/dist/components/arudha-padas.d.ts +2 -0
  16. package/dist/components/arudha-padas.d.ts.map +1 -1
  17. package/dist/components/arudha-padas.js +1 -1
  18. package/dist/components/arudha-padas.js.map +3 -3
  19. package/dist/components/ashtakavarga-grid.d.ts +2 -0
  20. package/dist/components/ashtakavarga-grid.d.ts.map +1 -1
  21. package/dist/components/ashtakavarga-grid.js +1 -1
  22. package/dist/components/ashtakavarga-grid.js.map +3 -3
  23. package/dist/components/aspects-table.d.ts +2 -0
  24. package/dist/components/aspects-table.d.ts.map +1 -1
  25. package/dist/components/aspects-table.js +1 -1
  26. package/dist/components/aspects-table.js.map +3 -3
  27. package/dist/components/astrocartography-map.d.ts +2 -0
  28. package/dist/components/astrocartography-map.d.ts.map +1 -1
  29. package/dist/components/astrocartography-map.js +1 -1
  30. package/dist/components/astrocartography-map.js.map +3 -3
  31. package/dist/components/bazi-chart.d.ts +2 -0
  32. package/dist/components/bazi-chart.d.ts.map +1 -1
  33. package/dist/components/bazi-chart.js +1 -1
  34. package/dist/components/bazi-chart.js.map +3 -3
  35. package/dist/components/bhav-chalit-table.d.ts +2 -0
  36. package/dist/components/bhav-chalit-table.d.ts.map +1 -1
  37. package/dist/components/bhav-chalit-table.js +1 -1
  38. package/dist/components/bhav-chalit-table.js.map +3 -3
  39. package/dist/components/bhava-bala-table.d.ts +2 -0
  40. package/dist/components/bhava-bala-table.d.ts.map +1 -1
  41. package/dist/components/bhava-bala-table.js +1 -1
  42. package/dist/components/bhava-bala-table.js.map +3 -3
  43. package/dist/components/biorhythm-chart.d.ts +2 -0
  44. package/dist/components/biorhythm-chart.d.ts.map +1 -1
  45. package/dist/components/biorhythm-chart.js +1 -1
  46. package/dist/components/biorhythm-chart.js.map +3 -3
  47. package/dist/components/bodygraph.d.ts +2 -0
  48. package/dist/components/bodygraph.d.ts.map +1 -1
  49. package/dist/components/bodygraph.js +1 -1
  50. package/dist/components/bodygraph.js.map +3 -3
  51. package/dist/components/chara-karakas.d.ts +2 -0
  52. package/dist/components/chara-karakas.d.ts.map +1 -1
  53. package/dist/components/chara-karakas.js +1 -1
  54. package/dist/components/chara-karakas.js.map +3 -3
  55. package/dist/components/choghadiya-grid.d.ts +2 -0
  56. package/dist/components/choghadiya-grid.d.ts.map +1 -1
  57. package/dist/components/choghadiya-grid.js +1 -1
  58. package/dist/components/choghadiya-grid.js.map +3 -3
  59. package/dist/components/compatibility-card.d.ts +2 -0
  60. package/dist/components/compatibility-card.d.ts.map +1 -1
  61. package/dist/components/compatibility-card.js +1 -1
  62. package/dist/components/compatibility-card.js.map +3 -3
  63. package/dist/components/crystal-card.d.ts +2 -0
  64. package/dist/components/crystal-card.d.ts.map +1 -1
  65. package/dist/components/crystal-card.js +1 -1
  66. package/dist/components/crystal-card.js.map +3 -3
  67. package/dist/components/crystal-grid.d.ts +7 -0
  68. package/dist/components/crystal-grid.d.ts.map +1 -1
  69. package/dist/components/crystal-grid.js +1 -1
  70. package/dist/components/crystal-grid.js.map +3 -3
  71. package/dist/components/dasha-timeline.d.ts +2 -0
  72. package/dist/components/dasha-timeline.d.ts.map +1 -1
  73. package/dist/components/dasha-timeline.js +1 -1
  74. package/dist/components/dasha-timeline.js.map +3 -3
  75. package/dist/components/data.d.ts +2 -0
  76. package/dist/components/data.d.ts.map +1 -1
  77. package/dist/components/data.js +1 -1
  78. package/dist/components/data.js.map +3 -3
  79. package/dist/components/divisional-chart.d.ts +2 -0
  80. package/dist/components/divisional-chart.d.ts.map +1 -1
  81. package/dist/components/divisional-chart.js +1 -1
  82. package/dist/components/divisional-chart.js.map +3 -3
  83. package/dist/components/dosha-card.d.ts +2 -0
  84. package/dist/components/dosha-card.d.ts.map +1 -1
  85. package/dist/components/dosha-card.js +1 -1
  86. package/dist/components/dosha-card.js.map +3 -3
  87. package/dist/components/dosha-constitution.d.ts +2 -0
  88. package/dist/components/dosha-constitution.d.ts.map +1 -1
  89. package/dist/components/dosha-constitution.js +1 -1
  90. package/dist/components/dosha-constitution.js.map +3 -3
  91. package/dist/components/dream-card.d.ts +2 -0
  92. package/dist/components/dream-card.d.ts.map +1 -1
  93. package/dist/components/dream-card.js +1 -1
  94. package/dist/components/dream-card.js.map +3 -3
  95. package/dist/components/dream-search.d.ts +8 -0
  96. package/dist/components/dream-search.d.ts.map +1 -1
  97. package/dist/components/dream-search.js +1 -1
  98. package/dist/components/dream-search.js.map +3 -3
  99. package/dist/components/endpoint-form.js +1 -1
  100. package/dist/components/endpoint-form.js.map +1 -1
  101. package/dist/components/ephemeris-table.d.ts +2 -0
  102. package/dist/components/ephemeris-table.d.ts.map +1 -1
  103. package/dist/components/ephemeris-table.js +1 -1
  104. package/dist/components/ephemeris-table.js.map +3 -3
  105. package/dist/components/fixed-stars.d.ts +2 -0
  106. package/dist/components/fixed-stars.d.ts.map +1 -1
  107. package/dist/components/fixed-stars.js +1 -1
  108. package/dist/components/fixed-stars.js.map +3 -3
  109. package/dist/components/flying-star-chart.d.ts +2 -0
  110. package/dist/components/flying-star-chart.d.ts.map +1 -1
  111. package/dist/components/flying-star-chart.js +1 -1
  112. package/dist/components/flying-star-chart.js.map +3 -3
  113. package/dist/components/forecast-digest.d.ts +2 -0
  114. package/dist/components/forecast-digest.d.ts.map +1 -1
  115. package/dist/components/forecast-digest.js +1 -1
  116. package/dist/components/forecast-digest.js.map +3 -3
  117. package/dist/components/forecast-timeline.d.ts +2 -0
  118. package/dist/components/forecast-timeline.d.ts.map +1 -1
  119. package/dist/components/forecast-timeline.js +1 -1
  120. package/dist/components/forecast-timeline.js.map +3 -3
  121. package/dist/components/gematria.d.ts +2 -0
  122. package/dist/components/gematria.d.ts.map +1 -1
  123. package/dist/components/gematria.js +1 -1
  124. package/dist/components/gematria.js.map +3 -3
  125. package/dist/components/gochara-table.d.ts +2 -0
  126. package/dist/components/gochara-table.d.ts.map +1 -1
  127. package/dist/components/gochara-table.js +1 -1
  128. package/dist/components/gochara-table.js.map +3 -3
  129. package/dist/components/guna-milan.d.ts +2 -0
  130. package/dist/components/guna-milan.d.ts.map +1 -1
  131. package/dist/components/guna-milan.js +1 -1
  132. package/dist/components/guna-milan.js.map +3 -3
  133. package/dist/components/hd-connection.d.ts +2 -0
  134. package/dist/components/hd-connection.d.ts.map +1 -1
  135. package/dist/components/hd-connection.js +1 -1
  136. package/dist/components/hd-connection.js.map +3 -3
  137. package/dist/components/hd-penta.d.ts +2 -0
  138. package/dist/components/hd-penta.d.ts.map +1 -1
  139. package/dist/components/hd-penta.js +1 -1
  140. package/dist/components/hd-penta.js.map +3 -3
  141. package/dist/components/hd-type-card.d.ts +2 -0
  142. package/dist/components/hd-type-card.d.ts.map +1 -1
  143. package/dist/components/hd-type-card.js +1 -1
  144. package/dist/components/hd-type-card.js.map +3 -3
  145. package/dist/components/hd-variables.d.ts +2 -0
  146. package/dist/components/hd-variables.d.ts.map +1 -1
  147. package/dist/components/hd-variables.js +1 -1
  148. package/dist/components/hd-variables.js.map +3 -3
  149. package/dist/components/heliacal-table.d.ts +2 -0
  150. package/dist/components/heliacal-table.d.ts.map +1 -1
  151. package/dist/components/heliacal-table.js +1 -1
  152. package/dist/components/heliacal-table.js.map +3 -3
  153. package/dist/components/hexagram.d.ts +2 -0
  154. package/dist/components/hexagram.d.ts.map +1 -1
  155. package/dist/components/hexagram.js +1 -1
  156. package/dist/components/hexagram.js.map +3 -3
  157. package/dist/components/hora-table.d.ts +2 -0
  158. package/dist/components/hora-table.d.ts.map +1 -1
  159. package/dist/components/hora-table.js +1 -1
  160. package/dist/components/hora-table.js.map +3 -3
  161. package/dist/components/horoscope-card.d.ts +2 -0
  162. package/dist/components/horoscope-card.d.ts.map +1 -1
  163. package/dist/components/horoscope-card.js +1 -1
  164. package/dist/components/horoscope-card.js.map +3 -3
  165. package/dist/components/kp-chart.d.ts +2 -0
  166. package/dist/components/kp-chart.d.ts.map +1 -1
  167. package/dist/components/kp-chart.js +1 -1
  168. package/dist/components/kp-chart.js.map +3 -3
  169. package/dist/components/kp-finance-card.d.ts +2 -0
  170. package/dist/components/kp-finance-card.d.ts.map +1 -1
  171. package/dist/components/kp-finance-card.js +1 -1
  172. package/dist/components/kp-finance-card.js.map +3 -3
  173. package/dist/components/kp-planets-table.d.ts +2 -0
  174. package/dist/components/kp-planets-table.d.ts.map +1 -1
  175. package/dist/components/kp-planets-table.js +1 -1
  176. package/dist/components/kp-planets-table.js.map +3 -3
  177. package/dist/components/kp-ruling-planets.d.ts +2 -0
  178. package/dist/components/kp-ruling-planets.d.ts.map +1 -1
  179. package/dist/components/kp-ruling-planets.js +1 -1
  180. package/dist/components/kp-ruling-planets.js.map +3 -3
  181. package/dist/components/kua-card.d.ts +2 -0
  182. package/dist/components/kua-card.d.ts.map +1 -1
  183. package/dist/components/kua-card.js +1 -1
  184. package/dist/components/kua-card.js.map +3 -3
  185. package/dist/components/local-space-compass.d.ts +2 -0
  186. package/dist/components/local-space-compass.d.ts.map +1 -1
  187. package/dist/components/local-space-compass.js +1 -1
  188. package/dist/components/local-space-compass.js.map +3 -3
  189. package/dist/components/location-search.js +1 -1
  190. package/dist/components/location-search.js.map +1 -1
  191. package/dist/components/luck-pillars.d.ts +2 -0
  192. package/dist/components/luck-pillars.d.ts.map +1 -1
  193. package/dist/components/luck-pillars.js +1 -1
  194. package/dist/components/luck-pillars.js.map +3 -3
  195. package/dist/components/mayan-day-sign.d.ts +2 -0
  196. package/dist/components/mayan-day-sign.d.ts.map +1 -1
  197. package/dist/components/mayan-day-sign.js +1 -1
  198. package/dist/components/mayan-day-sign.js.map +3 -3
  199. package/dist/components/moon-phase.d.ts +2 -0
  200. package/dist/components/moon-phase.d.ts.map +1 -1
  201. package/dist/components/moon-phase.js +1 -1
  202. package/dist/components/moon-phase.js.map +3 -3
  203. package/dist/components/nakshatra-card.d.ts +2 -0
  204. package/dist/components/nakshatra-card.d.ts.map +1 -1
  205. package/dist/components/nakshatra-card.js +1 -1
  206. package/dist/components/nakshatra-card.js.map +3 -3
  207. package/dist/components/natal-chart.d.ts +2 -0
  208. package/dist/components/natal-chart.d.ts.map +1 -1
  209. package/dist/components/natal-chart.js +1 -1
  210. package/dist/components/natal-chart.js.map +3 -3
  211. package/dist/components/numerology-card.d.ts +2 -0
  212. package/dist/components/numerology-card.d.ts.map +1 -1
  213. package/dist/components/numerology-card.js +1 -1
  214. package/dist/components/numerology-card.js.map +3 -3
  215. package/dist/components/panchang-table.d.ts +2 -0
  216. package/dist/components/panchang-table.d.ts.map +1 -1
  217. package/dist/components/panchang-table.js +1 -1
  218. package/dist/components/panchang-table.js.map +3 -3
  219. package/dist/components/positions-table.d.ts +2 -0
  220. package/dist/components/positions-table.d.ts.map +1 -1
  221. package/dist/components/positions-table.js +1 -1
  222. package/dist/components/positions-table.js.map +3 -3
  223. package/dist/components/profection-card.d.ts +2 -0
  224. package/dist/components/profection-card.d.ts.map +1 -1
  225. package/dist/components/profection-card.js +1 -1
  226. package/dist/components/profection-card.js.map +3 -3
  227. package/dist/components/reference-card.d.ts +2 -0
  228. package/dist/components/reference-card.d.ts.map +1 -1
  229. package/dist/components/reference-card.js +1 -1
  230. package/dist/components/reference-card.js.map +3 -3
  231. package/dist/components/relocation-wheel.d.ts +2 -0
  232. package/dist/components/relocation-wheel.d.ts.map +1 -1
  233. package/dist/components/relocation-wheel.js +1 -1
  234. package/dist/components/relocation-wheel.js.map +3 -3
  235. package/dist/components/shadbala-table.d.ts +2 -0
  236. package/dist/components/shadbala-table.d.ts.map +1 -1
  237. package/dist/components/shadbala-table.js +1 -1
  238. package/dist/components/shadbala-table.js.map +3 -3
  239. package/dist/components/synastry-chart.d.ts +2 -0
  240. package/dist/components/synastry-chart.d.ts.map +1 -1
  241. package/dist/components/synastry-chart.js +1 -1
  242. package/dist/components/synastry-chart.js.map +3 -3
  243. package/dist/components/tarot-card.d.ts +2 -0
  244. package/dist/components/tarot-card.d.ts.map +1 -1
  245. package/dist/components/tarot-card.js +1 -1
  246. package/dist/components/tarot-card.js.map +3 -3
  247. package/dist/components/tarot-catalog.d.ts +7 -0
  248. package/dist/components/tarot-catalog.d.ts.map +1 -1
  249. package/dist/components/tarot-catalog.js +1 -1
  250. package/dist/components/tarot-catalog.js.map +3 -3
  251. package/dist/components/tarot-spread.d.ts +2 -0
  252. package/dist/components/tarot-spread.d.ts.map +1 -1
  253. package/dist/components/tarot-spread.js +1 -1
  254. package/dist/components/tarot-spread.js.map +3 -3
  255. package/dist/components/transit-wheel.d.ts +2 -0
  256. package/dist/components/transit-wheel.d.ts.map +1 -1
  257. package/dist/components/transit-wheel.js +1 -1
  258. package/dist/components/transit-wheel.js.map +3 -3
  259. package/dist/components/transits-table.d.ts +2 -0
  260. package/dist/components/transits-table.d.ts.map +1 -1
  261. package/dist/components/transits-table.js +1 -1
  262. package/dist/components/transits-table.js.map +3 -3
  263. package/dist/components/upagraha-table.d.ts +2 -0
  264. package/dist/components/upagraha-table.d.ts.map +1 -1
  265. package/dist/components/upagraha-table.js +1 -1
  266. package/dist/components/upagraha-table.js.map +3 -3
  267. package/dist/components/vastu-mandala.d.ts +2 -0
  268. package/dist/components/vastu-mandala.d.ts.map +1 -1
  269. package/dist/components/vastu-mandala.js +1 -1
  270. package/dist/components/vastu-mandala.js.map +3 -3
  271. package/dist/components/vedic-aspects.d.ts +2 -0
  272. package/dist/components/vedic-aspects.d.ts.map +1 -1
  273. package/dist/components/vedic-aspects.js +1 -1
  274. package/dist/components/vedic-aspects.js.map +3 -3
  275. package/dist/components/vedic-daily.d.ts +2 -0
  276. package/dist/components/vedic-daily.d.ts.map +1 -1
  277. package/dist/components/vedic-daily.js +1 -1
  278. package/dist/components/vedic-daily.js.map +3 -3
  279. package/dist/components/vedic-kundli.d.ts +2 -0
  280. package/dist/components/vedic-kundli.d.ts.map +1 -1
  281. package/dist/components/vedic-kundli.js +1 -1
  282. package/dist/components/vedic-kundli.js.map +3 -3
  283. package/dist/components/vedic-planets-table.d.ts +2 -0
  284. package/dist/components/vedic-planets-table.d.ts.map +1 -1
  285. package/dist/components/vedic-planets-table.js +1 -1
  286. package/dist/components/vedic-planets-table.js.map +3 -3
  287. package/dist/components/western-planets-table.d.ts +2 -0
  288. package/dist/components/western-planets-table.d.ts.map +1 -1
  289. package/dist/components/western-planets-table.js +1 -1
  290. package/dist/components/western-planets-table.js.map +3 -3
  291. package/dist/components/yoga-list.d.ts +2 -0
  292. package/dist/components/yoga-list.d.ts.map +1 -1
  293. package/dist/components/yoga-list.js +1 -1
  294. package/dist/components/yoga-list.js.map +3 -3
  295. package/dist/components/zodiac-card.d.ts +2 -0
  296. package/dist/components/zodiac-card.d.ts.map +1 -1
  297. package/dist/components/zodiac-card.js +1 -1
  298. package/dist/components/zodiac-card.js.map +3 -3
  299. package/dist/generated/tool-components.d.ts.map +1 -1
  300. package/dist/index.cjs +1 -1
  301. package/dist/index.cjs.map +3 -3
  302. package/dist/index.js +1 -1
  303. package/dist/index.js.map +3 -3
  304. package/dist/jsx.d.ts +2 -0
  305. package/dist/jsx.d.ts.map +1 -1
  306. package/dist/load-ui.d.ts +1 -1
  307. package/dist/load-ui.js +1 -1
  308. package/dist/load-ui.js.map +1 -1
  309. package/dist/tool-component.cjs +1 -1
  310. package/dist/tool-component.cjs.map +2 -2
  311. package/dist/tool-component.js +1 -1
  312. package/dist/tool-component.js.map +2 -2
  313. package/dist/types/types.gen.d.ts +179 -138
  314. package/dist/types/types.gen.d.ts.map +1 -1
  315. package/package.json +1 -1
@@ -509,7 +509,7 @@ export type HousesResponse = {
509
509
  degree: number;
510
510
  }>;
511
511
  /**
512
- * Side-by-side house cusp comparison keyed by house system id: placidus, whole-sign, equal, koch. Only included when houseSystem is set to "all". Useful for educational tools and system comparison.
512
+ * Side-by-side house cusp comparison keyed by house system id: placidus, whole-sign, equal, koch. Only included when houseSystem is set to "all". A system that cannot be computed at the latitude (Placidus and Koch beyond 66 degrees 33 minutes north or south) is omitted, so every key present carries its own cusps, and the top level houses array is the first system present in that order. Useful for educational tools and system comparison.
513
513
  */
514
514
  comparison?: {
515
515
  [key: string]: {
@@ -1002,7 +1002,7 @@ export type TransitsRequest = {
1002
1002
  */
1003
1003
  natalChart?: {
1004
1004
  /**
1005
- * Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected.
1005
+ * Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected. Calculations that read planetary positions support 1550-01-02 to 2650-01-22; outside that span they answer 400 with code date_out_of_range, and a calculation that reads a window around the date (a sunrise search, a run of days) may answer the same 400 for a date within a few days of either end.
1006
1006
  */
1007
1007
  date: string;
1008
1008
  /**
@@ -1045,7 +1045,7 @@ export type AstrocartographyResponse = {
1045
1045
  */
1046
1046
  longitude: number;
1047
1047
  /**
1048
- * Timezone offset from UTC in decimal hours. Examples: New York = -5, London = 0, India = 5.5, Tokyo = 9.
1048
+ * Timezone offset from UTC in decimal hours, resolved for the birth date. Examples: New York = -5 in winter and -4 in summer, London = 0, India = 5.5, Tokyo = 9.
1049
1049
  */
1050
1050
  timezone: number;
1051
1051
  };
@@ -1553,7 +1553,7 @@ export type FixedStarsResponse = {
1553
1553
  */
1554
1554
  longitude: number;
1555
1555
  /**
1556
- * Timezone offset from UTC in decimal hours. Examples: New York = -5, London = 0, India = 5.5, Tokyo = 9.
1556
+ * Timezone offset from UTC in decimal hours, resolved for the birth date. Examples: New York = -5 in winter and -4 in summer, London = 0, India = 5.5, Tokyo = 9.
1557
1557
  */
1558
1558
  timezone: number;
1559
1559
  };
@@ -1671,7 +1671,7 @@ export type ArabicLotsResponse = {
1671
1671
  */
1672
1672
  longitude: number;
1673
1673
  /**
1674
- * Timezone offset from UTC in decimal hours. Examples: New York = -5, London = 0, India = 5.5, Tokyo = 9.
1674
+ * Timezone offset from UTC in decimal hours, resolved for the birth date. Examples: New York = -5 in winter and -4 in summer, London = 0, India = 5.5, Tokyo = 9.
1675
1675
  */
1676
1676
  timezone: number;
1677
1677
  };
@@ -1773,7 +1773,7 @@ export type AsteroidsResponse = {
1773
1773
  */
1774
1774
  longitude: number;
1775
1775
  /**
1776
- * Timezone offset from UTC in decimal hours. Examples: New York = -5, London = 0, India = 5.5, Tokyo = 9.
1776
+ * Timezone offset from UTC in decimal hours, resolved for the birth date. Examples: New York = -5 in winter and -4 in summer, London = 0, India = 5.5, Tokyo = 9.
1777
1777
  */
1778
1778
  timezone: number;
1779
1779
  };
@@ -1883,7 +1883,7 @@ export type LilithResponse = {
1883
1883
  */
1884
1884
  longitude: number;
1885
1885
  /**
1886
- * Timezone offset from UTC in decimal hours. Examples: New York = -5, London = 0, India = 5.5, Tokyo = 9.
1886
+ * Timezone offset from UTC in decimal hours, resolved for the birth date. Examples: New York = -5 in winter and -4 in summer, London = 0, India = 5.5, Tokyo = 9.
1887
1887
  */
1888
1888
  timezone: number;
1889
1889
  };
@@ -1997,7 +1997,7 @@ export type ProgressionsResponse = {
1997
1997
  */
1998
1998
  longitude: number;
1999
1999
  /**
2000
- * Timezone offset from UTC in decimal hours. Examples: New York = -5, London = 0, India = 5.5, Tokyo = 9.
2000
+ * Timezone offset from UTC in decimal hours, resolved for the birth date. Examples: New York = -5 in winter and -4 in summer, London = 0, India = 5.5, Tokyo = 9.
2001
2001
  */
2002
2002
  timezone: number;
2003
2003
  };
@@ -2157,7 +2157,7 @@ export type SolarArcResponse = {
2157
2157
  */
2158
2158
  longitude: number;
2159
2159
  /**
2160
- * Timezone offset from UTC in decimal hours. Examples: New York = -5, London = 0, India = 5.5, Tokyo = 9.
2160
+ * Timezone offset from UTC in decimal hours, resolved for the birth date. Examples: New York = -5 in winter and -4 in summer, London = 0, India = 5.5, Tokyo = 9.
2161
2161
  */
2162
2162
  timezone: number;
2163
2163
  };
@@ -2259,7 +2259,7 @@ export type ProfectionsResponse = {
2259
2259
  */
2260
2260
  longitude: number;
2261
2261
  /**
2262
- * Timezone offset from UTC in decimal hours. Examples: New York = -5, London = 0, India = 5.5, Tokyo = 9.
2262
+ * Timezone offset from UTC in decimal hours, resolved for the birth date. Examples: New York = -5 in winter and -4 in summer, London = 0, India = 5.5, Tokyo = 9.
2263
2263
  */
2264
2264
  timezone: number;
2265
2265
  };
@@ -7915,7 +7915,7 @@ export type AyurvedaDinacharyaRequest = {
7915
7915
  */
7916
7916
  longitude: number;
7917
7917
  /**
7918
- * Timezone as an IANA name such as "Europe/London", or as decimal hours from UTC such as 5.5. An IANA name is resolved to the offset in force on the requested date. It decides which local day is meant and, on the clock-hour grid, where the blocks fall. Defaults to 0.
7918
+ * Timezone as an IANA name such as "Europe/London", or as decimal hours from UTC such as 5.5. An IANA name is resolved to the offset in force on the requested date, and on the clock-hour grid at the local hour each block opens, so on a daylight-saving change every block keeps its printed hour and one that falls in the skipped hour moves forward past it. It decides which local day is meant and, on the clock-hour grid, where the blocks fall. Defaults to 0.
7919
7919
  */
7920
7920
  timezone?: number | string;
7921
7921
  /**
@@ -7925,7 +7925,7 @@ export type AyurvedaDinacharyaRequest = {
7925
7925
  };
7926
7926
  export type AyurvedaRitucharyaRequest = {
7927
7927
  /**
7928
- * The date to resolve, in YYYY-MM-DD format. The season is read at midday UTC on this date, because a season boundary is an instant and a calendar day has to be reduced to one; on a day that carries a boundary, the half the midday falls in is the answer.
7928
+ * The date to resolve, in YYYY-MM-DD format. The season is read at midday UTC on this date, because a season boundary is an instant and a calendar day has to be reduced to one; on a day that carries a boundary, the half the midday falls in is the answer. Within about two months of either end of the supported span, a date whose season opens or closes outside that span answers 400.
7929
7929
  */
7930
7930
  date: string;
7931
7931
  /**
@@ -9563,7 +9563,7 @@ export type GetPlanetaryPositionsResponse = GetPlanetaryPositionsResponses[keyof
9563
9563
  export type GetMonthlyTropicalEphemerisData = {
9564
9564
  body?: {
9565
9565
  /**
9566
- * Year for the monthly ephemeris (1900-2100). Defaults to the current year (UTC).
9566
+ * Year for the monthly ephemeris (1551 to 2649). Defaults to the current year (UTC).
9567
9567
  */
9568
9568
  year?: number;
9569
9569
  /**
@@ -10136,7 +10136,7 @@ export type GetMoonCalendarData = {
10136
10136
  body?: never;
10137
10137
  path: {
10138
10138
  /**
10139
- * Calendar year (1900-2100).
10139
+ * Calendar year, 1551 to 2649.
10140
10140
  */
10141
10141
  year: number;
10142
10142
  /**
@@ -11118,7 +11118,7 @@ export type CalculateAspectsResponse = CalculateAspectsResponses[keyof Calculate
11118
11118
  export type GetMonthlyTropicalAspectsData = {
11119
11119
  body?: {
11120
11120
  /**
11121
- * Year for the aspect calendar (1900-2100). Defaults to the current year (UTC).
11121
+ * Year for the aspect calendar (1551 to 2649). Defaults to the current year (UTC).
11122
11122
  */
11123
11123
  year?: number;
11124
11124
  /**
@@ -11641,7 +11641,7 @@ export type CalculateTransitsResponse = CalculateTransitsResponses[keyof Calcula
11641
11641
  export type GetMonthlyTropicalTransitsData = {
11642
11642
  body?: {
11643
11643
  /**
11644
- * Year for the monthly transit table (1900-2100). Defaults to the current year (UTC).
11644
+ * Year for the monthly transit table (1551 to 2649). Defaults to the current year (UTC).
11645
11645
  */
11646
11646
  year?: number;
11647
11647
  /**
@@ -11914,7 +11914,7 @@ export type CalculateTransitAspectsData = {
11914
11914
  */
11915
11915
  transitDate?: string;
11916
11916
  /**
11917
- * Transit time in HH:MM:SS format. Defaults to 12:00:00 (noon) if omitted.
11917
+ * Transit time in HH:MM:SS format, read on the clock of the natal chart timezone at the transit date (an IANA zone takes the offset in force on that date, daylight saving included). Defaults to 12:00:00 (noon) if omitted.
11918
11918
  */
11919
11919
  transitTime?: string;
11920
11920
  /**
@@ -12395,7 +12395,7 @@ export type CalculateTransitAspectsResponse = CalculateTransitAspectsResponses[k
12395
12395
  export type GetMonthlyDeclinationParallelsData = {
12396
12396
  body?: {
12397
12397
  /**
12398
- * Year for the declination calendar (1900-2100). Defaults to the current year (UTC).
12398
+ * Year for the declination calendar (1551 to 2649). Defaults to the current year (UTC).
12399
12399
  */
12400
12400
  year?: number;
12401
12401
  /**
@@ -12622,7 +12622,7 @@ export type GetMonthlyDeclinationParallelsResponse = GetMonthlyDeclinationParall
12622
12622
  export type GetPlanetaryNodePassagesData = {
12623
12623
  body?: {
12624
12624
  /**
12625
- * Year to scan for node passages (1900-2100).
12625
+ * Year to scan for node passages (1551 to 2649).
12626
12626
  */
12627
12627
  year: number;
12628
12628
  /**
@@ -13039,12 +13039,12 @@ export type GenerateSolarReturnResponses = {
13039
13039
  */
13040
13040
  longitude: number;
13041
13041
  /**
13042
- * Timezone offset from UTC in decimal hours. Examples: New York = -5, London = 0, India = 5.5, Tokyo = 9.
13042
+ * Timezone offset from UTC in decimal hours, resolved for the birth date. Examples: New York = -5 in winter and -4 in summer, London = 0, India = 5.5, Tokyo = 9.
13043
13043
  */
13044
13044
  timezone: number;
13045
13045
  };
13046
13046
  /**
13047
- * All 14 celestial bodies in the tropical zodiac with house placements: the 10 classical planets (Sun through Pluto), the lunar nodes (North Node, South Node, in the requested `nodeType` convention), Chiron, and Black Moon Lilith.
13047
+ * All 14 celestial bodies in the tropical zodiac with house placements: the 10 classical planets (Sun through Pluto), the lunar nodes (North Node, South Node, in the requested `nodeType` convention), Chiron, and Black Moon Lilith. Chiron is included for charts from 1600 to 2500 and omitted outside that range.
13048
13048
  */
13049
13049
  planets: Array<{
13050
13050
  /**
@@ -13443,12 +13443,12 @@ export type GenerateLunarReturnResponses = {
13443
13443
  */
13444
13444
  longitude: number;
13445
13445
  /**
13446
- * Timezone offset from UTC in decimal hours. Examples: New York = -5, London = 0, India = 5.5, Tokyo = 9.
13446
+ * Timezone offset from UTC in decimal hours, resolved for the birth date. Examples: New York = -5 in winter and -4 in summer, London = 0, India = 5.5, Tokyo = 9.
13447
13447
  */
13448
13448
  timezone: number;
13449
13449
  };
13450
13450
  /**
13451
- * All 14 celestial bodies in the tropical zodiac with house placements: the 10 classical planets (Sun through Pluto), the lunar nodes (North Node, South Node, in the requested `nodeType` convention), Chiron, and Black Moon Lilith.
13451
+ * All 14 celestial bodies in the tropical zodiac with house placements: the 10 classical planets (Sun through Pluto), the lunar nodes (North Node, South Node, in the requested `nodeType` convention), Chiron, and Black Moon Lilith. Chiron is included for charts from 1600 to 2500 and omitted outside that range.
13452
13452
  */
13453
13453
  planets: Array<{
13454
13454
  /**
@@ -13852,7 +13852,7 @@ export type GenerateCompositeChartResponses = {
13852
13852
  */
13853
13853
  longitude: number;
13854
13854
  /**
13855
- * Timezone offset from UTC in decimal hours. Examples: New York = -5, London = 0, India = 5.5, Tokyo = 9.
13855
+ * Timezone offset from UTC in decimal hours, resolved for the birth date. Examples: New York = -5 in winter and -4 in summer, London = 0, India = 5.5, Tokyo = 9.
13856
13856
  */
13857
13857
  timezone: number;
13858
13858
  };
@@ -13877,7 +13877,7 @@ export type GenerateCompositeChartResponses = {
13877
13877
  */
13878
13878
  longitude: number;
13879
13879
  /**
13880
- * Timezone offset from UTC in decimal hours. Examples: New York = -5, London = 0, India = 5.5, Tokyo = 9.
13880
+ * Timezone offset from UTC in decimal hours, resolved for the birth date. Examples: New York = -5 in winter and -4 in summer, London = 0, India = 5.5, Tokyo = 9.
13881
13881
  */
13882
13882
  timezone: number;
13883
13883
  };
@@ -15776,7 +15776,7 @@ export type GeneratePlanetaryReturnData = {
15776
15776
  */
15777
15777
  planet: 'Mercury' | 'Venus' | 'Mars' | 'Jupiter' | 'Saturn';
15778
15778
  /**
15779
- * Approximate date near the expected planetary return (YYYY-MM-DD). Provide a date within the expected return window. The algorithm searches from this starting point.
15779
+ * Approximate date near the expected planetary return (YYYY-MM-DD). The return nearest this date is returned, so a date off by months still lands on a genuine return; during a retrograde loop the planet crosses its natal degree up to three times and the crossing nearest the date is the one returned.
15780
15780
  */
15781
15781
  approximateDate: string;
15782
15782
  /**
@@ -15990,12 +15990,12 @@ export type GeneratePlanetaryReturnResponses = {
15990
15990
  */
15991
15991
  longitude: number;
15992
15992
  /**
15993
- * Timezone offset from UTC in decimal hours. Examples: New York = -5, London = 0, India = 5.5, Tokyo = 9.
15993
+ * Timezone offset from UTC in decimal hours, resolved for the birth date. Examples: New York = -5 in winter and -4 in summer, London = 0, India = 5.5, Tokyo = 9.
15994
15994
  */
15995
15995
  timezone: number;
15996
15996
  };
15997
15997
  /**
15998
- * All 14 celestial bodies in the tropical zodiac with house placements: the 10 classical planets (Sun through Pluto), the lunar nodes (North Node, South Node, in the requested `nodeType` convention), Chiron, and Black Moon Lilith.
15998
+ * All 14 celestial bodies in the tropical zodiac with house placements: the 10 classical planets (Sun through Pluto), the lunar nodes (North Node, South Node, in the requested `nodeType` convention), Chiron, and Black Moon Lilith. Chiron is included for charts from 1600 to 2500 and omitted outside that range.
15999
15999
  */
16000
16000
  planets: Array<{
16001
16001
  /**
@@ -18643,7 +18643,7 @@ export type GetPlanetPositionsResponse = GetPlanetPositionsResponses[keyof GetPl
18643
18643
  export type GetMonthlyEphemerisData = {
18644
18644
  body?: {
18645
18645
  /**
18646
- * Year for monthly ephemeris (1900-2100). Defaults to the current year (UTC).
18646
+ * Year for monthly ephemeris (1551 to 2649). Defaults to the current year (UTC).
18647
18647
  */
18648
18648
  year?: number;
18649
18649
  /**
@@ -22760,7 +22760,7 @@ export type GetBasicPanchangResponse = GetBasicPanchangResponses[keyof GetBasicP
22760
22760
  export type GetDetailedPanchangData = {
22761
22761
  body?: {
22762
22762
  /**
22763
- * Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected.
22763
+ * Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected. Calculations that read planetary positions support 1550-01-02 to 2650-01-22; outside that span they answer 400 with code date_out_of_range, and a calculation that reads a window around the date (a sunrise search, a run of days) may answer the same 400 for a date within a few days of either end.
22764
22764
  */
22765
22765
  date: string;
22766
22766
  /**
@@ -23455,7 +23455,7 @@ export type GetDetailedPanchangResponse = GetDetailedPanchangResponses[keyof Get
23455
23455
  export type GetChoghadiyaData = {
23456
23456
  body?: {
23457
23457
  /**
23458
- * Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected.
23458
+ * Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected. Calculations that read planetary positions support 1550-01-02 to 2650-01-22; outside that span they answer 400 with code date_out_of_range, and a calculation that reads a window around the date (a sunrise search, a run of days) may answer the same 400 for a date within a few days of either end.
23459
23459
  */
23460
23460
  date: string;
23461
23461
  /**
@@ -23662,7 +23662,7 @@ export type GetChoghadiyaResponse = GetChoghadiyaResponses[keyof GetChoghadiyaRe
23662
23662
  export type GetHoraData = {
23663
23663
  body?: {
23664
23664
  /**
23665
- * Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected.
23665
+ * Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected. Calculations that read planetary positions support 1550-01-02 to 2650-01-22; outside that span they answer 400 with code date_out_of_range, and a calculation that reads a window around the date (a sunrise search, a run of days) may answer the same 400 for a date within a few days of either end.
23666
23666
  */
23667
23667
  date: string;
23668
23668
  /**
@@ -26587,7 +26587,7 @@ export type CalculateDrishtiResponse = CalculateDrishtiResponses[keyof Calculate
26587
26587
  export type GetMonthlyAspectsData = {
26588
26588
  body?: {
26589
26589
  /**
26590
- * Year for monthly analysis (1900-2100). Defaults to the current year (UTC).
26590
+ * Year for monthly analysis (1551 to 2649). Defaults to the current year (UTC).
26591
26591
  */
26592
26592
  year?: number;
26593
26593
  /**
@@ -26810,7 +26810,7 @@ export type GetMonthlyAspectsResponse = GetMonthlyAspectsResponses[keyof GetMont
26810
26810
  export type GetLunarAspectsData = {
26811
26811
  body?: {
26812
26812
  /**
26813
- * Year for monthly analysis (1900-2100). Defaults to the current year (UTC).
26813
+ * Year for monthly analysis (1551 to 2649). Defaults to the current year (UTC).
26814
26814
  */
26815
26815
  year?: number;
26816
26816
  /**
@@ -27357,7 +27357,7 @@ export type CalculateTransitResponse = CalculateTransitResponses[keyof Calculate
27357
27357
  export type GetMonthlyTransitsData = {
27358
27358
  body?: {
27359
27359
  /**
27360
- * Year for monthly transit analysis (1900-2100). Defaults to the current year (UTC).
27360
+ * Year for monthly transit analysis (1551 to 2649). Defaults to the current year (UTC).
27361
27361
  */
27362
27362
  year?: number;
27363
27363
  /**
@@ -27605,11 +27605,11 @@ export type CalculateParallelsData = {
27605
27605
  */
27606
27606
  time: string;
27607
27607
  /**
27608
- * Observer latitude in decimal degrees. Used for topocentric declination corrections.
27608
+ * Birth latitude in decimal degrees, part of the birth record. Declinations are geocentric, as every published ephemeris prints them, so it does not move them.
27609
27609
  */
27610
27610
  latitude: number;
27611
27611
  /**
27612
- * Observer longitude in decimal degrees. Affects local time context for declination calculations.
27612
+ * Birth longitude in decimal degrees, part of the birth record. Declinations are geocentric, so it does not move them; the instant comes from date, time and timezone.
27613
27613
  */
27614
27614
  longitude: number;
27615
27615
  /**
@@ -27808,7 +27808,7 @@ export type CalculateParallelsResponse = CalculateParallelsResponses[keyof Calcu
27808
27808
  export type GetMonthlyParallelsData = {
27809
27809
  body?: {
27810
27810
  /**
27811
- * Year for monthly parallel analysis (1900-2100). Defaults to the current year (UTC).
27811
+ * Year for monthly parallel analysis (1551 to 2649). Defaults to the current year (UTC).
27812
27812
  */
27813
27813
  year?: number;
27814
27814
  /**
@@ -28019,7 +28019,7 @@ export type GetMonthlyParallelsResponse = GetMonthlyParallelsResponses[keyof Get
28019
28019
  export type GetEclipticCrossingsData = {
28020
28020
  body?: {
28021
28021
  /**
28022
- * Year to scan for ecliptic crossings (1900-2100).
28022
+ * Year to scan for ecliptic crossings (1551 to 2649).
28023
28023
  */
28024
28024
  year: number;
28025
28025
  /**
@@ -30476,7 +30476,7 @@ export type GenerateTimelineResponses = {
30476
30476
  */
30477
30477
  date: string;
30478
30478
  /**
30479
- * Exact instant of the event as an ISO-8601 UTC datetime. Astronomical events are refined to this instant by search, not reported at a daily sample point.
30479
+ * Exact instant of the event as an ISO-8601 UTC datetime, to the nearest second. Astronomical events are refined to this instant by search, not reported at a daily sample point; a dasha-change is the period boundary itself, counted from the birth instant.
30480
30480
  */
30481
30481
  datetime: string;
30482
30482
  /**
@@ -30488,7 +30488,7 @@ export type GenerateTimelineResponses = {
30488
30488
  */
30489
30489
  type: 'transit-aspect' | 'sign-ingress' | 'retrograde-station' | 'eclipse' | 'lunar-phase' | 'dasha-change' | 'critical-day';
30490
30490
  /**
30491
- * Primary subject of the event. A transiting planet for western events, Sun for a solar eclipse, Moon for a lunar eclipse or a new or full moon, a mahadasha, antardasha, or pratyantardasha label for dasha changes, or the critical cycle for biorhythm days.
30491
+ * Primary subject of the event. A transiting planet for western events, Sun for a solar eclipse, Moon for a lunar eclipse or a new or full moon, or the critical cycle for biorhythm days. For a dasha-change, the Vimshottari lords outermost first, joined by a hyphen, then one space and the level: Saturn Mahadasha, Saturn-Mercury Antardasha, Saturn-Mercury-Ketu Pratyantardasha. Lords are always one of Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury. Never localized.
30492
30492
  */
30493
30493
  body: string;
30494
30494
  /**
@@ -30500,7 +30500,7 @@ export type GenerateTimelineResponses = {
30500
30500
  */
30501
30501
  aspect?: string;
30502
30502
  /**
30503
- * For a transit-aspect, the separation in degrees from the exact aspect at the reported instant. Tighter orb means a more exact and significant aspect.
30503
+ * For a transit-aspect, the separation in degrees from the exact aspect at the reported instant, rounded to three decimals. The instant is the moment the aspect perfects, so this reads 0. Absent for other event types.
30504
30504
  */
30505
30505
  orb?: number;
30506
30506
  /**
@@ -30753,7 +30753,7 @@ export type ForecastTransitsResponses = {
30753
30753
  */
30754
30754
  date: string;
30755
30755
  /**
30756
- * Exact instant of the event as an ISO-8601 UTC datetime. Astronomical events are refined to this instant by search, not reported at a daily sample point.
30756
+ * Exact instant of the event as an ISO-8601 UTC datetime, to the nearest second. Astronomical events are refined to this instant by search, not reported at a daily sample point; a dasha-change is the period boundary itself, counted from the birth instant.
30757
30757
  */
30758
30758
  datetime: string;
30759
30759
  /**
@@ -30765,7 +30765,7 @@ export type ForecastTransitsResponses = {
30765
30765
  */
30766
30766
  type: 'transit-aspect' | 'sign-ingress' | 'retrograde-station' | 'eclipse' | 'lunar-phase' | 'dasha-change' | 'critical-day';
30767
30767
  /**
30768
- * Primary subject of the event. A transiting planet for western events, Sun for a solar eclipse, Moon for a lunar eclipse or a new or full moon, a mahadasha, antardasha, or pratyantardasha label for dasha changes, or the critical cycle for biorhythm days.
30768
+ * Primary subject of the event. A transiting planet for western events, Sun for a solar eclipse, Moon for a lunar eclipse or a new or full moon, or the critical cycle for biorhythm days. For a dasha-change, the Vimshottari lords outermost first, joined by a hyphen, then one space and the level: Saturn Mahadasha, Saturn-Mercury Antardasha, Saturn-Mercury-Ketu Pratyantardasha. Lords are always one of Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury. Never localized.
30769
30769
  */
30770
30770
  body: string;
30771
30771
  /**
@@ -30777,7 +30777,7 @@ export type ForecastTransitsResponses = {
30777
30777
  */
30778
30778
  aspect?: string;
30779
30779
  /**
30780
- * For a transit-aspect, the separation in degrees from the exact aspect at the reported instant. Tighter orb means a more exact and significant aspect.
30780
+ * For a transit-aspect, the separation in degrees from the exact aspect at the reported instant, rounded to three decimals. The instant is the moment the aspect perfects, so this reads 0. Absent for other event types.
30781
30781
  */
30782
30782
  orb?: number;
30783
30783
  /**
@@ -31051,7 +31051,7 @@ export type FindSignificantDatesResponses = {
31051
31051
  */
31052
31052
  date: string;
31053
31053
  /**
31054
- * Exact instant of the event as an ISO-8601 UTC datetime. Astronomical events are refined to this instant by search, not reported at a daily sample point.
31054
+ * Exact instant of the event as an ISO-8601 UTC datetime, to the nearest second. Astronomical events are refined to this instant by search, not reported at a daily sample point; a dasha-change is the period boundary itself, counted from the birth instant.
31055
31055
  */
31056
31056
  datetime: string;
31057
31057
  /**
@@ -31063,7 +31063,7 @@ export type FindSignificantDatesResponses = {
31063
31063
  */
31064
31064
  type: 'transit-aspect' | 'sign-ingress' | 'retrograde-station' | 'eclipse' | 'lunar-phase' | 'dasha-change' | 'critical-day';
31065
31065
  /**
31066
- * Primary subject of the event. A transiting planet for western events, Sun for a solar eclipse, Moon for a lunar eclipse or a new or full moon, a mahadasha, antardasha, or pratyantardasha label for dasha changes, or the critical cycle for biorhythm days.
31066
+ * Primary subject of the event. A transiting planet for western events, Sun for a solar eclipse, Moon for a lunar eclipse or a new or full moon, or the critical cycle for biorhythm days. For a dasha-change, the Vimshottari lords outermost first, joined by a hyphen, then one space and the level: Saturn Mahadasha, Saturn-Mercury Antardasha, Saturn-Mercury-Ketu Pratyantardasha. Lords are always one of Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury. Never localized.
31067
31067
  */
31068
31068
  body: string;
31069
31069
  /**
@@ -31075,7 +31075,7 @@ export type FindSignificantDatesResponses = {
31075
31075
  */
31076
31076
  aspect?: string;
31077
31077
  /**
31078
- * For a transit-aspect, the separation in degrees from the exact aspect at the reported instant. Tighter orb means a more exact and significant aspect.
31078
+ * For a transit-aspect, the separation in degrees from the exact aspect at the reported instant, rounded to three decimals. The instant is the moment the aspect perfects, so this reads 0. Absent for other event types.
31079
31079
  */
31080
31080
  orb?: number;
31081
31081
  /**
@@ -31415,7 +31415,7 @@ export type GenerateDigestResponses = {
31415
31415
  */
31416
31416
  date: string;
31417
31417
  /**
31418
- * Exact instant of the event as an ISO-8601 UTC datetime. Astronomical events are refined to this instant by search, not reported at a daily sample point.
31418
+ * Exact instant of the event as an ISO-8601 UTC datetime, to the nearest second. Astronomical events are refined to this instant by search, not reported at a daily sample point; a dasha-change is the period boundary itself, counted from the birth instant.
31419
31419
  */
31420
31420
  datetime: string;
31421
31421
  /**
@@ -31427,7 +31427,7 @@ export type GenerateDigestResponses = {
31427
31427
  */
31428
31428
  type: 'transit-aspect' | 'sign-ingress' | 'retrograde-station' | 'eclipse' | 'lunar-phase' | 'dasha-change' | 'critical-day';
31429
31429
  /**
31430
- * Primary subject of the event. A transiting planet for western events, Sun for a solar eclipse, Moon for a lunar eclipse or a new or full moon, a mahadasha, antardasha, or pratyantardasha label for dasha changes, or the critical cycle for biorhythm days.
31430
+ * Primary subject of the event. A transiting planet for western events, Sun for a solar eclipse, Moon for a lunar eclipse or a new or full moon, or the critical cycle for biorhythm days. For a dasha-change, the Vimshottari lords outermost first, joined by a hyphen, then one space and the level: Saturn Mahadasha, Saturn-Mercury Antardasha, Saturn-Mercury-Ketu Pratyantardasha. Lords are always one of Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury. Never localized.
31431
31431
  */
31432
31432
  body: string;
31433
31433
  /**
@@ -31439,7 +31439,7 @@ export type GenerateDigestResponses = {
31439
31439
  */
31440
31440
  aspect?: string;
31441
31441
  /**
31442
- * For a transit-aspect, the separation in degrees from the exact aspect at the reported instant. Tighter orb means a more exact and significant aspect.
31442
+ * For a transit-aspect, the separation in degrees from the exact aspect at the reported instant, rounded to three decimals. The instant is the moment the aspect perfects, so this reads 0. Absent for other event types.
31443
31443
  */
31444
31444
  orb?: number;
31445
31445
  /**
@@ -31709,12 +31709,12 @@ export type ForecastSolarReturnResponses = {
31709
31709
  */
31710
31710
  longitude: number;
31711
31711
  /**
31712
- * Timezone offset from UTC in decimal hours. Examples: New York = -5, London = 0, India = 5.5, Tokyo = 9.
31712
+ * Timezone offset from UTC in decimal hours, resolved for the birth date. Examples: New York = -5 in winter and -4 in summer, London = 0, India = 5.5, Tokyo = 9.
31713
31713
  */
31714
31714
  timezone: number;
31715
31715
  };
31716
31716
  /**
31717
- * All 14 celestial bodies in the tropical zodiac with house placements: the 10 classical planets (Sun through Pluto), the lunar nodes (North Node, South Node, in the requested `nodeType` convention), Chiron, and Black Moon Lilith.
31717
+ * All 14 celestial bodies in the tropical zodiac with house placements: the 10 classical planets (Sun through Pluto), the lunar nodes (North Node, South Node, in the requested `nodeType` convention), Chiron, and Black Moon Lilith. Chiron is included for charts from 1600 to 2500 and omitted outside that range.
31718
31718
  */
31719
31719
  planets: Array<{
31720
31720
  /**
@@ -35030,7 +35030,7 @@ export type GenerateBaziChartData = {
35030
35030
  */
35031
35031
  yearBoundary?: 'li-chun' | 'lunar-new-year';
35032
35032
  /**
35033
- * Which clock the HOUR branch is read from. "clock" is civil time exactly as a birth certificate records it, which is what most calculators use and the default here. "local-mean" shifts to the mean sun over the birth longitude, a correction of up to 59 minutes at the edge of a wide time zone. "solar" adds the equation of time on top of that, up to a further 16 minutes. Both non-civil options need "longitude" in the request and return 400 without it.
35033
+ * Which clock the day boundary and the hour branch are read from, so a correction that carries a birth across midnight moves the day pillar with the hour. "clock" is civil time exactly as a birth certificate records it, which is what most calculators use and the default here. "local-mean" shifts to the mean sun over the birth longitude, a correction of up to 59 minutes at the edge of a wide time zone. "solar" adds the equation of time on top of that, up to a further 16 minutes. Both non-civil options need "longitude" in the request and return 400 without it.
35034
35034
  */
35035
35035
  hourClock?: 'clock' | 'local-mean' | 'solar';
35036
35036
  };
@@ -35183,7 +35183,7 @@ export type GenerateBaziChartResponses = {
35183
35183
  */
35184
35184
  time: string;
35185
35185
  /**
35186
- * Decimal UTC offset the chart was computed with, resolved from whatever the request sent. An IANA name is resolved to the offset in force on the birth date, so this is the literal number applied and never the name.
35186
+ * Decimal UTC offset the chart was computed with, resolved from whatever the request sent. An IANA name is resolved to the offset in force at the birth, so this is the literal number applied and never the name. A local time that never happened (the skipped hour of a daylight-saving change) is moved forward past the gap, and date, time and timezone then echo the clock that was running, which the day and hour pillars are read from.
35187
35187
  */
35188
35188
  timezone: number;
35189
35189
  /**
@@ -35568,7 +35568,7 @@ export type CalculateLuckPillarsData = {
35568
35568
  */
35569
35569
  yearBoundary?: 'li-chun' | 'lunar-new-year';
35570
35570
  /**
35571
- * Which clock the HOUR branch is read from. "clock" is civil time exactly as a birth certificate records it, which is what most calculators use and the default here. "local-mean" shifts to the mean sun over the birth longitude, a correction of up to 59 minutes at the edge of a wide time zone. "solar" adds the equation of time on top of that, up to a further 16 minutes. Both non-civil options need "longitude" in the request and return 400 without it.
35571
+ * Which clock the day boundary and the hour branch are read from, so a correction that carries a birth across midnight moves the day pillar with the hour. "clock" is civil time exactly as a birth certificate records it, which is what most calculators use and the default here. "local-mean" shifts to the mean sun over the birth longitude, a correction of up to 59 minutes at the edge of a wide time zone. "solar" adds the equation of time on top of that, up to a further 16 minutes. Both non-civil options need "longitude" in the request and return 400 without it.
35572
35572
  */
35573
35573
  hourClock?: 'clock' | 'local-mean' | 'solar';
35574
35574
  /**
@@ -35737,7 +35737,7 @@ export type CalculateLuckPillarsResponses = {
35737
35737
  */
35738
35738
  time: string;
35739
35739
  /**
35740
- * Decimal UTC offset the chart was computed with, resolved from whatever the request sent. An IANA name is resolved to the offset in force on the birth date, so this is the literal number applied and never the name.
35740
+ * Decimal UTC offset the chart was computed with, resolved from whatever the request sent. An IANA name is resolved to the offset in force at the birth, so this is the literal number applied and never the name. A local time that never happened (the skipped hour of a daylight-saving change) is moved forward past the gap, and date, time and timezone then echo the clock that was running, which the day and hour pillars are read from.
35741
35741
  */
35742
35742
  timezone: number;
35743
35743
  /**
@@ -36018,7 +36018,7 @@ export type CalculateDayMasterStrengthData = {
36018
36018
  */
36019
36019
  yearBoundary?: 'li-chun' | 'lunar-new-year';
36020
36020
  /**
36021
- * Which clock the HOUR branch is read from. "clock" is civil time exactly as a birth certificate records it, which is what most calculators use and the default here. "local-mean" shifts to the mean sun over the birth longitude, a correction of up to 59 minutes at the edge of a wide time zone. "solar" adds the equation of time on top of that, up to a further 16 minutes. Both non-civil options need "longitude" in the request and return 400 without it.
36021
+ * Which clock the day boundary and the hour branch are read from, so a correction that carries a birth across midnight moves the day pillar with the hour. "clock" is civil time exactly as a birth certificate records it, which is what most calculators use and the default here. "local-mean" shifts to the mean sun over the birth longitude, a correction of up to 59 minutes at the edge of a wide time zone. "solar" adds the equation of time on top of that, up to a further 16 minutes. Both non-civil options need "longitude" in the request and return 400 without it.
36022
36022
  */
36023
36023
  hourClock?: 'clock' | 'local-mean' | 'solar';
36024
36024
  };
@@ -36171,7 +36171,7 @@ export type CalculateDayMasterStrengthResponses = {
36171
36171
  */
36172
36172
  time: string;
36173
36173
  /**
36174
- * Decimal UTC offset the chart was computed with, resolved from whatever the request sent. An IANA name is resolved to the offset in force on the birth date, so this is the literal number applied and never the name.
36174
+ * Decimal UTC offset the chart was computed with, resolved from whatever the request sent. An IANA name is resolved to the offset in force at the birth, so this is the literal number applied and never the name. A local time that never happened (the skipped hour of a daylight-saving change) is moved forward past the gap, and date, time and timezone then echo the clock that was running, which the day and hour pillars are read from.
36175
36175
  */
36176
36176
  timezone: number;
36177
36177
  /**
@@ -36262,7 +36262,7 @@ export type CalculateDayMasterStrengthResponses = {
36262
36262
  */
36263
36263
  factors: Array<{
36264
36264
  /**
36265
- * Which classical factor this is. month-command is de ling, whether the birth month season backs the Day Master element. rooting is de di, whether any branch stores a stem of that element. party is de shi, whether the other three stems help or spend it. Always English, whatever the lang parameter says.
36265
+ * Which classical factor this is. month-command is de ling, whether the birth month season backs the Day Master element. rooting is de di, whether any branch stores a stem of that element. party is de shi, whether the other three stems, and the principal stems of the three branches outside the month, help or spend it. Always English, whatever the lang parameter says.
36266
36266
  */
36267
36267
  id: string;
36268
36268
  /**
@@ -36361,7 +36361,7 @@ export type CalculateBaziCompatibilityData = {
36361
36361
  */
36362
36362
  yearBoundary?: 'li-chun' | 'lunar-new-year';
36363
36363
  /**
36364
- * Which clock the HOUR branch is read from. "clock" is civil time exactly as a birth certificate records it, which is what most calculators use and the default here. "local-mean" shifts to the mean sun over the birth longitude, a correction of up to 59 minutes at the edge of a wide time zone. "solar" adds the equation of time on top of that, up to a further 16 minutes. Both non-civil options need "longitude" in the request and return 400 without it.
36364
+ * Which clock the day boundary and the hour branch are read from, so a correction that carries a birth across midnight moves the day pillar with the hour. "clock" is civil time exactly as a birth certificate records it, which is what most calculators use and the default here. "local-mean" shifts to the mean sun over the birth longitude, a correction of up to 59 minutes at the edge of a wide time zone. "solar" adds the equation of time on top of that, up to a further 16 minutes. Both non-civil options need "longitude" in the request and return 400 without it.
36365
36365
  */
36366
36366
  hourClock?: 'clock' | 'local-mean' | 'solar';
36367
36367
  };
@@ -36398,7 +36398,7 @@ export type CalculateBaziCompatibilityData = {
36398
36398
  */
36399
36399
  yearBoundary?: 'li-chun' | 'lunar-new-year';
36400
36400
  /**
36401
- * Which clock the HOUR branch is read from. "clock" is civil time exactly as a birth certificate records it, which is what most calculators use and the default here. "local-mean" shifts to the mean sun over the birth longitude, a correction of up to 59 minutes at the edge of a wide time zone. "solar" adds the equation of time on top of that, up to a further 16 minutes. Both non-civil options need "longitude" in the request and return 400 without it.
36401
+ * Which clock the day boundary and the hour branch are read from, so a correction that carries a birth across midnight moves the day pillar with the hour. "clock" is civil time exactly as a birth certificate records it, which is what most calculators use and the default here. "local-mean" shifts to the mean sun over the birth longitude, a correction of up to 59 minutes at the edge of a wide time zone. "solar" adds the equation of time on top of that, up to a further 16 minutes. Both non-civil options need "longitude" in the request and return 400 without it.
36402
36402
  */
36403
36403
  hourClock?: 'clock' | 'local-mean' | 'solar';
36404
36404
  };
@@ -37166,7 +37166,7 @@ export type CalculateAnnualForecastData = {
37166
37166
  */
37167
37167
  yearBoundary?: 'li-chun' | 'lunar-new-year';
37168
37168
  /**
37169
- * Which clock the HOUR branch is read from. "clock" is civil time exactly as a birth certificate records it, which is what most calculators use and the default here. "local-mean" shifts to the mean sun over the birth longitude, a correction of up to 59 minutes at the edge of a wide time zone. "solar" adds the equation of time on top of that, up to a further 16 minutes. Both non-civil options need "longitude" in the request and return 400 without it.
37169
+ * Which clock the day boundary and the hour branch are read from, so a correction that carries a birth across midnight moves the day pillar with the hour. "clock" is civil time exactly as a birth certificate records it, which is what most calculators use and the default here. "local-mean" shifts to the mean sun over the birth longitude, a correction of up to 59 minutes at the edge of a wide time zone. "solar" adds the equation of time on top of that, up to a further 16 minutes. Both non-civil options need "longitude" in the request and return 400 without it.
37170
37170
  */
37171
37171
  hourClock?: 'clock' | 'local-mean' | 'solar';
37172
37172
  /**
@@ -37323,7 +37323,7 @@ export type CalculateAnnualForecastResponses = {
37323
37323
  */
37324
37324
  time: string;
37325
37325
  /**
37326
- * Decimal UTC offset the chart was computed with, resolved from whatever the request sent. An IANA name is resolved to the offset in force on the birth date, so this is the literal number applied and never the name.
37326
+ * Decimal UTC offset the chart was computed with, resolved from whatever the request sent. An IANA name is resolved to the offset in force at the birth, so this is the literal number applied and never the name. A local time that never happened (the skipped hour of a daylight-saving change) is moved forward past the gap, and date, time and timezone then echo the clock that was running, which the day and hour pillars are read from.
37327
37327
  */
37328
37328
  timezone: number;
37329
37329
  /**
@@ -39162,7 +39162,7 @@ export type CalculateLunarDateData = {
39162
39162
  */
39163
39163
  body?: {
39164
39164
  /**
39165
- * Gregorian date to convert to the lunisolar calendar. Send this OR the lunar fields, never both.
39165
+ * Gregorian date to convert to the lunisolar calendar. Send this OR the lunar fields, never both. Converts from the first day of lunar year 1551 to the last day of lunar year 2648, a little inside the supported date span, because numbering a lunar month needs the winter solstice on each side of it and placing a leap month needs the year before; a date outside that answers 400 date_out_of_range.
39166
39166
  */
39167
39167
  date?: string;
39168
39168
  /**
@@ -43684,7 +43684,7 @@ export type ListNinePeriodsData = {
43684
43684
  */
43685
43685
  lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru' | 'zh-Hans' | 'zh-Hant';
43686
43686
  /**
43687
- * Date to resolve the current period for, in YYYY-MM-DD format. Defaults to today in UTC. Useful for asking which period a building was completed in.
43687
+ * Date to resolve the current period for, in YYYY-MM-DD format. Defaults to today in UTC. Useful for asking which period a building was completed in. A date landing exactly on the Li Chun day a period opens is placed in the outgoing period.
43688
43688
  */
43689
43689
  date?: string;
43690
43690
  };
@@ -43834,7 +43834,7 @@ export type ListNinePeriodsResponses = {
43834
43834
  */
43835
43835
  date: string;
43836
43836
  /**
43837
- * The period in force on that date. Resolved at Li Chun, so a date in January belongs to the previous solar year and can fall in the previous period.
43837
+ * The period in force on that date. Resolved at Li Chun, so a date in January belongs to the previous solar year and can fall in the previous period. A date is read at the start of its day in the Chinese calendar frame (UTC+8) and Li Chun falls part-way through its own day, so the date a period opens on still reads as the previous period, the same reading the Kua route gives a birth date.
43838
43838
  */
43839
43839
  currentPeriod: number;
43840
43840
  /**
@@ -51363,7 +51363,7 @@ export type CalculateLifePathResponses = {
51363
51363
  */
51364
51364
  number: number;
51365
51365
  /**
51366
- * Full step-by-step breakdown of the 3-Cycle Pythagorean reduction. Shows how month, day, and year each reduce independently before combining into the final Life Path number.
51366
+ * Every step of the calculation: the birth month, day and year each reduced, then combined into the final Life Path number.
51367
51367
  */
51368
51368
  calculation: string;
51369
51369
  /**
@@ -51401,11 +51401,11 @@ export type CalculateLifePathResponses = {
51401
51401
  */
51402
51402
  title: string;
51403
51403
  /**
51404
- * Ten defining personality traits and energetic themes associated with this number. Useful for quick personality snapshots, tag clouds, and compatibility matching.
51404
+ * Defining personality traits and energetic themes of this number. Useful for quick personality snapshots, tag clouds and compatibility matching.
51405
51405
  */
51406
51406
  keywords: Array<string>;
51407
51407
  /**
51408
- * In-depth 300 to 500 word interpretation covering personality, purpose, and life themes. Written by numerology experts with decades of practice. Suitable for full-page readings and detailed reports.
51408
+ * Core interpretation of the number covering personality, purpose and life themes. Together with the strengths, challenges, career, relationships and spirituality fields it makes a full-page reading.
51409
51409
  */
51410
51410
  description: string;
51411
51411
  /**
@@ -51435,7 +51435,7 @@ export type CalculateLifePathResponse = CalculateLifePathResponses[keyof Calcula
51435
51435
  export type CalculateExpressionData = {
51436
51436
  body?: {
51437
51437
  /**
51438
- * Full birth name (first, middle, last)
51438
+ * Full birth name (first, middle, last). A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses.
51439
51439
  */
51440
51440
  fullName: string;
51441
51441
  };
@@ -51576,11 +51576,11 @@ export type CalculateExpressionResponses = {
51576
51576
  */
51577
51577
  200: {
51578
51578
  /**
51579
- * Expression number (also called Destiny number) derived from all letters in the full birth name. Reveals natural talents, abilities, and the goals you are meant to achieve. Values: 1 to 9, 11, 22, or 33.
51579
+ * Expression number (also called Destiny number) from every letter of the full birth name. Reveals natural talents, abilities, and the goals you are meant to achieve. Values: 1 to 9, 11, 22, or 33.
51580
51580
  */
51581
51581
  number: number;
51582
51582
  /**
51583
- * Full Pythagorean letter-to-number conversion showing every letter value in the birth name, grouped by word, then summed and reduced to the final Expression number.
51583
+ * Every letter value of the birth name, grouped by name: each name is summed and reduced, then the names are added and reduced to the final Expression number.
51584
51584
  */
51585
51585
  calculation: string;
51586
51586
  /**
@@ -51588,7 +51588,7 @@ export type CalculateExpressionResponses = {
51588
51588
  */
51589
51589
  type: 'single' | 'master';
51590
51590
  /**
51591
- * Whether a Karmic Debt number (13, 14, 16, 19) appeared during the name reduction. Indicates inherited challenges embedded in your given name.
51591
+ * Whether a Karmic Debt number (13, 14, 16, 19) appeared in the final reduction, the sum of the reduced names. Indicates inherited challenges embedded in your given name.
51592
51592
  */
51593
51593
  hasKarmicDebt: boolean;
51594
51594
  /**
@@ -51622,7 +51622,7 @@ export type CalculateExpressionResponses = {
51622
51622
  */
51623
51623
  keywords: Array<string>;
51624
51624
  /**
51625
- * Expert-written 300 to 500 word interpretation of the natural abilities, life mission, and destiny encoded in your birth name. Covers how these talents manifest across life stages.
51625
+ * Core interpretation of the natural abilities, life mission and destiny the birth name describes. Together with the strengths, challenges, career, relationships and spirituality fields it makes a full reading.
51626
51626
  */
51627
51627
  description: string;
51628
51628
  /**
@@ -51652,7 +51652,7 @@ export type CalculateExpressionResponse = CalculateExpressionResponses[keyof Cal
51652
51652
  export type CalculateBridgeNumbersData = {
51653
51653
  body?: {
51654
51654
  /**
51655
- * Full legal birth name as it appears on the birth certificate. Used to calculate Expression, Soul Urge, and Personality numbers. Include first, middle, and last names separated by spaces.
51655
+ * Full birth name as it appears on the birth certificate, first, middle and last names separated by spaces. Used to calculate the Expression, Soul Urge and Personality numbers. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses.
51656
51656
  */
51657
51657
  fullName: string;
51658
51658
  /**
@@ -51801,7 +51801,7 @@ export type CalculateBridgeNumbersErrors = {
51801
51801
  export type CalculateBridgeNumbersError = CalculateBridgeNumbersErrors[keyof CalculateBridgeNumbersErrors];
51802
51802
  export type CalculateBridgeNumbersResponses = {
51803
51803
  /**
51804
- * Successfully calculated three Bridge Numbers with actionable harmony guidance
51804
+ * Successfully calculated four Bridge Numbers with actionable harmony guidance
51805
51805
  */
51806
51806
  200: {
51807
51807
  /**
@@ -51838,7 +51838,7 @@ export type CalculateBridgeNumbersResponses = {
51838
51838
  meaning: string;
51839
51839
  };
51840
51840
  /**
51841
- * Bridge between Expression and Personality numbers. Reveals the gap between your true talents (all letters) and how others perceive you (consonants only). A high bridge means others may not see your real capabilities, requiring you to present yourself more authentically.
51841
+ * Bridge between Expression and Personality numbers, a pairing this API adds beside the classical bridges. Reveals the gap between your true talents (all letters) and how others perceive you (consonants only). A high bridge means others may not see your real capabilities, requiring you to present yourself more authentically.
51842
51842
  */
51843
51843
  expressionPersonality: {
51844
51844
  /**
@@ -51870,6 +51870,39 @@ export type CalculateBridgeNumbersResponses = {
51870
51870
  */
51871
51871
  meaning: string;
51872
51872
  };
51873
+ /**
51874
+ * Bridge between Soul Urge and Personality numbers, one of the classical bridges. Reveals the gap between your inner self (vowels only) and the image others meet first (consonants only). A high bridge means what you want and how you come across pull apart, calling for a more transparent presentation of your real motives.
51875
+ */
51876
+ soulUrgePersonality: {
51877
+ /**
51878
+ * Bridge number (0 to 8). The absolute difference between two core numerology numbers after reducing master numbers to single digits. 0 means the two aspects are already in natural harmony. Higher values indicate greater tension requiring conscious adjustment.
51879
+ */
51880
+ bridge: number;
51881
+ from: {
51882
+ /**
51883
+ * Name of the first core number in this bridge pair. Identifies which aspect of personality or destiny is being compared.
51884
+ */
51885
+ name: string;
51886
+ /**
51887
+ * The reduced single-digit value (1 to 9) of the first core number used in the bridge calculation.
51888
+ */
51889
+ number: number;
51890
+ };
51891
+ to: {
51892
+ /**
51893
+ * Name of the second core number in this bridge pair. Identifies the other aspect of personality or destiny being compared.
51894
+ */
51895
+ name: string;
51896
+ /**
51897
+ * The reduced single-digit value (1 to 9) of the second core number used in the bridge calculation.
51898
+ */
51899
+ number: number;
51900
+ };
51901
+ /**
51902
+ * Actionable guidance for bridging the gap between these two aspects of your numerology profile. Explains what adjustments to make to bring these energies into harmony.
51903
+ */
51904
+ meaning: string;
51905
+ };
51873
51906
  /**
51874
51907
  * Bridge between Expression and Soul Urge numbers. Reveals the gap between your outward talents (all letters) and your deepest inner desires (vowels only). A high bridge means what you are good at may differ from what your soul truly craves, calling for realignment.
51875
51908
  */
@@ -51909,7 +51942,7 @@ export type CalculateBridgeNumbersResponse = CalculateBridgeNumbersResponses[key
51909
51942
  export type CalculateSoulUrgeData = {
51910
51943
  body?: {
51911
51944
  /**
51912
- * Full birth name (vowels will be extracted)
51945
+ * Full birth name. Its vowels A, E, I, O and U give the Soul Urge, so a name with none is refused. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses.
51913
51946
  */
51914
51947
  fullName: string;
51915
51948
  };
@@ -52054,7 +52087,7 @@ export type CalculateSoulUrgeResponses = {
52054
52087
  */
52055
52088
  number: number;
52056
52089
  /**
52057
- * Full step-by-step Pythagorean reduction using only the vowels (A, E, I, O, U) from the birth name. Shows each vowel mapped to its numeric value, grouped by word, then summed and reduced to the final Soul Urge number.
52090
+ * Every vowel (A, E, I, O, U) of the birth name with its value, grouped by name: each name is summed and reduced, then the names are added and reduced to the final Soul Urge number.
52058
52091
  */
52059
52092
  calculation: string;
52060
52093
  /**
@@ -52096,7 +52129,7 @@ export type CalculateSoulUrgeResponses = {
52096
52129
  */
52097
52130
  keywords: Array<string>;
52098
52131
  /**
52099
- * Expert-written 300 to 500 word exploration of the inner self, hidden desires, and emotional landscape. Reveals what the heart truly craves beneath the surface persona.
52132
+ * Core interpretation of the inner self, hidden desires and emotional landscape. Together with the strengths, challenges, career, relationships and spirituality fields it makes a full reading.
52100
52133
  */
52101
52134
  description: string;
52102
52135
  /**
@@ -52126,7 +52159,7 @@ export type CalculateSoulUrgeResponse = CalculateSoulUrgeResponses[keyof Calcula
52126
52159
  export type CalculatePersonalityData = {
52127
52160
  body?: {
52128
52161
  /**
52129
- * Full birth name (consonants will be extracted)
52162
+ * Full birth name. Its consonants give the Personality number, so a name with none is refused. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses.
52130
52163
  */
52131
52164
  fullName: string;
52132
52165
  };
@@ -52271,7 +52304,7 @@ export type CalculatePersonalityResponses = {
52271
52304
  */
52272
52305
  number: number;
52273
52306
  /**
52274
- * Full step-by-step Pythagorean reduction using only the consonants from the birth name. Shows each consonant mapped to its numeric value, grouped by word, then summed and reduced to the final Personality number.
52307
+ * Every consonant of the birth name with its value, grouped by name: each name is summed and reduced, then the names are added and reduced to the final Personality number.
52275
52308
  */
52276
52309
  calculation: string;
52277
52310
  /**
@@ -52313,7 +52346,7 @@ export type CalculatePersonalityResponses = {
52313
52346
  */
52314
52347
  keywords: Array<string>;
52315
52348
  /**
52316
- * Expert-written 300 to 500 word analysis of the outer personality, social presence, and the image you project to the world. Reveals the gap between how others see you and who you truly are.
52349
+ * Core interpretation of the outer personality, social presence and the image projected to the world. Together with the strengths, challenges, career, relationships and spirituality fields it makes a full reading.
52317
52350
  */
52318
52351
  description: string;
52319
52352
  /**
@@ -52484,11 +52517,11 @@ export type CalculateBirthDayResponses = {
52484
52517
  */
52485
52518
  200: {
52486
52519
  /**
52487
- * Your Birth Day number, revealing the special talents and innate abilities you carry from the day you were born. Values range from 1 to 9 for single digits, or 11, 22 for Master Numbers (days 11 and 22 are never reduced).
52520
+ * Your Birth Day number, revealing the special talents and innate abilities you carry from the day you were born. Values range from 1 to 9 for single digits, or 11, 22 for Master Numbers (the 11th, 22nd and 29th).
52488
52521
  */
52489
52522
  number: number;
52490
52523
  /**
52491
- * Step-by-step digit reduction of the birth day. Single-digit days (1 to 9) remain as-is, Master Number days (11, 22) are preserved, and all other double-digit days are reduced by summing their digits.
52524
+ * Step-by-step digit reduction of the birth day. Single-digit days (1 to 9) remain as they are, a day that is or reduces to 11 or 22 keeps it, and every other two-digit day is reduced to one digit.
52492
52525
  */
52493
52526
  calculation: string;
52494
52527
  /**
@@ -52530,7 +52563,7 @@ export type CalculateBirthDayResponses = {
52530
52563
  */
52531
52564
  keywords: Array<string>;
52532
52565
  /**
52533
- * Expert-written 300 to 500 word reading of the special abilities your birth day bestows. Covers how these gifts complement your Life Path and Expression numbers.
52566
+ * Core interpretation of the special abilities the birth day brings and how they complement the Life Path and Expression numbers. Together with the strengths, challenges, career, relationships and spirituality fields it makes a full reading.
52534
52567
  */
52535
52568
  description: string;
52536
52569
  /**
@@ -52568,7 +52601,7 @@ export type CalculateMaturityData = {
52568
52601
  */
52569
52602
  expression?: number;
52570
52603
  /**
52571
- * Full birth name to calculate Expression number automatically. Use instead of passing expression directly.
52604
+ * Full birth name to calculate the Expression number automatically. Use instead of passing expression directly. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses.
52572
52605
  */
52573
52606
  fullName?: string;
52574
52607
  /**
@@ -52767,7 +52800,7 @@ export type CalculateMaturityResponses = {
52767
52800
  */
52768
52801
  keywords: Array<string>;
52769
52802
  /**
52770
- * Expert-written 300 to 500 word guide to the person you are evolving into. The Maturity number is the sum of Life Path and Expression, representing the wisdom gained through lived experience.
52803
+ * Core interpretation of the person being grown into in the second half of life, the wisdom gained through lived experience. Together with the strengths, challenges, career, relationships and spirituality fields it makes a full reading.
52771
52804
  */
52772
52805
  description: string;
52773
52806
  /**
@@ -52797,7 +52830,7 @@ export type CalculateMaturityResponse = CalculateMaturityResponses[keyof Calcula
52797
52830
  export type AnalyzeKarmicLessonsData = {
52798
52831
  body?: {
52799
52832
  /**
52800
- * Full birth name to analyze for missing numbers
52833
+ * Full birth name to analyze for missing numbers. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses.
52801
52834
  */
52802
52835
  fullName: string;
52803
52836
  };
@@ -52979,11 +53012,11 @@ export type CheckKarmicDebtData = {
52979
53012
  */
52980
53013
  month?: number;
52981
53014
  /**
52982
- * Birth day (checks Life Path)
53015
+ * Birth day (checks Birth Day on its own, and Life Path with year and month)
52983
53016
  */
52984
53017
  day?: number;
52985
53018
  /**
52986
- * Full birth name (checks Expression, Soul Urge, Personality)
53019
+ * Full birth name (checks Expression, Soul Urge, Personality). A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses.
52987
53020
  */
52988
53021
  fullName?: string;
52989
53022
  };
@@ -53128,7 +53161,7 @@ export type CheckKarmicDebtResponses = {
53128
53161
  */
53129
53162
  hasKarmicDebt: boolean;
53130
53163
  /**
53131
- * All karmic debt numbers found (13, 14, 16, 19)
53164
+ * All karmic debt numbers found (13, 14, 16, 19), each listed once, in core-number order: Life Path, Expression, Soul Urge, Personality, Birth Day.
53132
53165
  */
53133
53166
  debtNumbers: Array<number>;
53134
53167
  meanings: Array<{
@@ -53167,7 +53200,7 @@ export type CalculatePersonalDayData = {
53167
53200
  */
53168
53201
  day: number;
53169
53202
  /**
53170
- * Target date in YYYY-MM-DD format. Defaults to today (UTC).
53203
+ * Target date in YYYY-MM-DD format, in the years 100 to 2100. Defaults to today (UTC).
53171
53204
  */
53172
53205
  targetDate?: string;
53173
53206
  };
@@ -53353,11 +53386,11 @@ export type CalculatePersonalMonthData = {
53353
53386
  */
53354
53387
  day: number;
53355
53388
  /**
53356
- * Target year for calculation (defaults to current year)
53389
+ * Target year. Defaults to the current UTC year.
53357
53390
  */
53358
53391
  year?: number;
53359
53392
  /**
53360
- * Target calendar month to forecast (1-12, defaults to current month)
53393
+ * Target calendar month to forecast (1 to 12). Defaults to the current UTC month.
53361
53394
  */
53362
53395
  targetMonth?: number;
53363
53396
  };
@@ -53535,7 +53568,7 @@ export type CalculatePersonalYearData = {
53535
53568
  */
53536
53569
  day: number;
53537
53570
  /**
53538
- * Year to calculate (defaults to current year)
53571
+ * Year to forecast. Defaults to the current UTC year; the Personal Year turns over on 1 January.
53539
53572
  */
53540
53573
  year?: number;
53541
53574
  };
@@ -53906,11 +53939,11 @@ export type CalculateNumCompatibilityResponses = {
53906
53939
  */
53907
53940
  200: {
53908
53941
  /**
53909
- * Overall compatibility score (0-100)
53942
+ * Overall compatibility score: 50% Life Path, 30% Expression and 20% Soul Urge pair scores, rounded. Every pair score runs 50 to 100, so the overall score does too.
53910
53943
  */
53911
53944
  overallScore: number;
53912
53945
  /**
53913
- * Compatibility rating: Highly Compatible, Very Compatible, Compatible, Moderately Compatible, or Challenging.
53946
+ * Compatibility rating from overallScore: Highly Compatible (90 and up), Very Compatible (75 to 89), Compatible (60 to 74) or Moderately Compatible (50 to 59). The scale also names Challenging below 45, which no pair of core numbers reaches.
53914
53947
  */
53915
53948
  rating: string;
53916
53949
  lifePath: {
@@ -53923,7 +53956,7 @@ export type CalculateNumCompatibilityResponses = {
53923
53956
  */
53924
53957
  person2: number;
53925
53958
  /**
53926
- * Life Path compatibility score (0-100)
53959
+ * Life Path compatibility score (50-100)
53927
53960
  */
53928
53961
  compatibility: number;
53929
53962
  /**
@@ -53941,7 +53974,7 @@ export type CalculateNumCompatibilityResponses = {
53941
53974
  */
53942
53975
  person2: number;
53943
53976
  /**
53944
- * Expression compatibility score (0-100)
53977
+ * Expression compatibility score (50-100)
53945
53978
  */
53946
53979
  compatibility: number;
53947
53980
  /**
@@ -53959,7 +53992,7 @@ export type CalculateNumCompatibilityResponses = {
53959
53992
  */
53960
53993
  person2: number;
53961
53994
  /**
53962
- * Soul Urge compatibility score (0-100)
53995
+ * Soul Urge compatibility score (50-100)
53963
53996
  */
53964
53997
  compatibility: number;
53965
53998
  /**
@@ -53985,7 +54018,7 @@ export type CalculateNumCompatibilityResponse = CalculateNumCompatibilityRespons
53985
54018
  export type GenerateNumerologyChartData = {
53986
54019
  body?: {
53987
54020
  /**
53988
- * Full birth name as it appears on the birth certificate. Used for all letter-based Pythagorean numerology calculations including Expression, Soul Urge, Personality, and Karmic Lessons.
54021
+ * Full birth name as it appears on the birth certificate. Used for every letter-based number in the chart: Expression, Soul Urge, Personality, Karmic Lessons, Hidden Passion, Subconscious Self and the special letters. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses.
53989
54022
  */
53990
54023
  fullName: string;
53991
54024
  /**
@@ -54001,7 +54034,7 @@ export type GenerateNumerologyChartData = {
54001
54034
  */
54002
54035
  day: number;
54003
54036
  /**
54004
- * Year for Personal Year calculation (defaults to current year)
54037
+ * Calendar year for the Personal Year, defaults to the current UTC year. It moves the Personal Year only: the nested personalMonth and maturityStatus.currentAge always read the current UTC date.
54005
54038
  */
54006
54039
  currentYear?: number;
54007
54040
  };
@@ -54195,7 +54228,7 @@ export type GenerateNumerologyChartResponses = {
54195
54228
  */
54196
54229
  keywords: Array<string>;
54197
54230
  /**
54198
- * Authoritative 300 to 500 word interpretation covering personality, life purpose, and core themes. Written by numerology experts and suitable for full-page readings or PDF report generation.
54231
+ * Core interpretation of the Life Path covering personality, life purpose and core themes. Together with the strengths, challenges, career, relationships and spirituality fields it makes a full reading.
54199
54232
  */
54200
54233
  description: string;
54201
54234
  /**
@@ -54257,7 +54290,7 @@ export type GenerateNumerologyChartResponses = {
54257
54290
  */
54258
54291
  keywords: Array<string>;
54259
54292
  /**
54260
- * Expert-written 300 to 500 word analysis of natural abilities, life goals, and the talents your birth name reveals. Suitable for detailed readings and personality assessments.
54293
+ * Core interpretation of the natural abilities, life goals and talents the birth name describes. Together with the strengths, challenges, career, relationships and spirituality fields it makes a full reading.
54261
54294
  */
54262
54295
  description: string;
54263
54296
  /**
@@ -54319,7 +54352,7 @@ export type GenerateNumerologyChartResponses = {
54319
54352
  */
54320
54353
  keywords: Array<string>;
54321
54354
  /**
54322
- * Expert-written 300 to 500 word exploration of the inner self, hidden desires, and emotional landscape. Reveals what the heart truly craves beneath the surface persona.
54355
+ * Core interpretation of the inner self, hidden desires and emotional landscape. Together with the strengths, challenges, career, relationships and spirituality fields it makes a full reading.
54323
54356
  */
54324
54357
  description: string;
54325
54358
  /**
@@ -54381,7 +54414,7 @@ export type GenerateNumerologyChartResponses = {
54381
54414
  */
54382
54415
  keywords: Array<string>;
54383
54416
  /**
54384
- * Expert-written 300 to 500 word analysis of the outer personality, social presence, and the image you project to the world. Reveals the gap between perception and inner truth.
54417
+ * Core interpretation of the outer personality, social presence and the image projected to the world. Together with the strengths, challenges, career, relationships and spirituality fields it makes a full reading.
54385
54418
  */
54386
54419
  description: string;
54387
54420
  /**
@@ -54443,7 +54476,7 @@ export type GenerateNumerologyChartResponses = {
54443
54476
  */
54444
54477
  keywords: Array<string>;
54445
54478
  /**
54446
- * Expert-written 300 to 500 word reading of the special abilities your birth day bestows. Covers how these gifts complement your Life Path and Expression numbers.
54479
+ * Core interpretation of the special abilities the birth day brings and how they complement the Life Path and Expression numbers. Together with the strengths, challenges, career, relationships and spirituality fields it makes a full reading.
54447
54480
  */
54448
54481
  description: string;
54449
54482
  /**
@@ -54505,7 +54538,7 @@ export type GenerateNumerologyChartResponses = {
54505
54538
  */
54506
54539
  keywords: Array<string>;
54507
54540
  /**
54508
- * Expert-written 300 to 500 word guide to the person you are evolving into. The Maturity number represents the wisdom gained through lived experience and reveals your ultimate destination.
54541
+ * Core interpretation of the person being grown into in the second half of life, the wisdom gained through lived experience. Together with the strengths, challenges, career, relationships and spirituality fields it makes a full reading.
54509
54542
  */
54510
54543
  description: string;
54511
54544
  /**
@@ -54580,7 +54613,7 @@ export type GenerateNumerologyChartResponses = {
54580
54613
  */
54581
54614
  hasKarmicDebt: boolean;
54582
54615
  /**
54583
- * List of karmic debt numbers found (13=laziness, 14=abuse of freedom, 16=ego destruction, 19=selfishness).
54616
+ * List of karmic debt numbers found (13=laziness, 14=abuse of freedom, 16=ego destruction, 19=selfishness), each listed once, in core-number order: Life Path, Expression, Soul Urge, Personality, Birth Day.
54584
54617
  */
54585
54618
  debtNumbers: Array<number>;
54586
54619
  /**
@@ -54638,11 +54671,11 @@ export type GenerateNumerologyChartResponses = {
54638
54671
  */
54639
54672
  advice: string;
54640
54673
  /**
54641
- * Personal Month forecast nested within the Personal Year cycle.
54674
+ * Personal Month forecast for the current UTC calendar month, applied to the Personal Year above. With a currentYear other than the current year, it pairs that Personal Year with the current month.
54642
54675
  */
54643
54676
  personalMonth: {
54644
54677
  /**
54645
- * Personal Month number (1-9).
54678
+ * Personal Month number (1-9): the Personal Year above plus the current UTC calendar month, reduced to one digit.
54646
54679
  */
54647
54680
  personalMonth: number;
54648
54681
  /**
@@ -54656,7 +54689,7 @@ export type GenerateNumerologyChartResponses = {
54656
54689
  };
54657
54690
  };
54658
54691
  /**
54659
- * Four Pinnacle numbers representing major life phases with age ranges and meanings.
54692
+ * Four Pinnacle numbers representing major life phases, master numbers 11, 22 and 33 kept, with age ranges and meanings.
54660
54693
  */
54661
54694
  pinnacles: Array<{
54662
54695
  /**
@@ -54672,7 +54705,7 @@ export type GenerateNumerologyChartResponses = {
54672
54705
  */
54673
54706
  startAge: number;
54674
54707
  /**
54675
- * Age when this phase ends. Null for the 4th Pinnacle (lasts rest of life).
54708
+ * Last whole age of this phase, inclusive. The First Pinnacle ends at 36 minus the Life Path reduced to one digit and each later phase starts the year after; null for the 4th Pinnacle (lasts rest of life).
54676
54709
  */
54677
54710
  endAge: number | null;
54678
54711
  /**
@@ -54698,7 +54731,7 @@ export type GenerateNumerologyChartResponses = {
54698
54731
  };
54699
54732
  }>;
54700
54733
  /**
54701
- * Four Challenge numbers representing life obstacles aligned with Pinnacle timing.
54734
+ * Four Challenge numbers representing life obstacles. The 3rd (Main) Challenge lasts for life; the other three are timed approximately with the Pinnacle phases.
54702
54735
  */
54703
54736
  challenges: Array<{
54704
54737
  /**
@@ -54710,11 +54743,11 @@ export type GenerateNumerologyChartResponses = {
54710
54743
  */
54711
54744
  number: number;
54712
54745
  /**
54713
- * Age when this Challenge period begins.
54746
+ * Age when this Challenge is most felt. The 3rd (Main) Challenge starts at 0 and lasts for life; the 1st, 2nd and 4th take the ages of their Pinnacle phase as an approximation, since Challenges have no fixed durations.
54714
54747
  */
54715
54748
  startAge: number;
54716
54749
  /**
54717
- * Age when this period ends. Null for the 4th Challenge.
54750
+ * Last whole age of the period, inclusive, approximate as startAge explains. Null for the 3rd (Main) Challenge and the 4th, which last for life.
54718
54751
  */
54719
54752
  endAge: number | null;
54720
54753
  /**
@@ -54744,7 +54777,7 @@ export type GenerateNumerologyChartResponses = {
54744
54777
  */
54745
54778
  hiddenPassion: {
54746
54779
  /**
54747
- * Hidden Passion number (1-9). The most frequently occurring number in the birth name.
54780
+ * Hidden Passion number (1-9). The most frequently occurring number in the birth name; when several tie, the lowest of them.
54748
54781
  */
54749
54782
  number: number;
54750
54783
  /**
@@ -54752,7 +54785,7 @@ export type GenerateNumerologyChartResponses = {
54752
54785
  */
54753
54786
  count: number;
54754
54787
  /**
54755
- * All numbers tied for highest frequency (usually one, sometimes multiple).
54788
+ * All numbers tied for highest frequency, in ascending order (usually one, sometimes multiple).
54756
54789
  */
54757
54790
  allPassions: Array<number>;
54758
54791
  /**
@@ -54828,7 +54861,7 @@ export type GenerateNumerologyChartResponses = {
54828
54861
  */
54829
54862
  firstVowel: {
54830
54863
  /**
54831
- * First vowel in the full name (A, E, I, O, or U).
54864
+ * First vowel of the first name (A, E, I, O or U). A first name with none of them takes its Y, the vowel sound of names like Lynn; one with no Y either takes the first A, E, I, O or U of the rest of the name.
54832
54865
  */
54833
54866
  letter: string;
54834
54867
  /**
@@ -54888,7 +54921,7 @@ export type GenerateNumerologyChartResponses = {
54888
54921
  */
54889
54922
  isActive: boolean;
54890
54923
  /**
54891
- * Current age calculated from the birth year.
54924
+ * The current UTC calendar year minus the birth year. The birthday is not considered, so before the birthday it reads one more than the age in whole years, and currentYear does not move it.
54892
54925
  */
54893
54926
  currentAge: number;
54894
54927
  /**
@@ -55114,7 +55147,7 @@ export type GetNumberMeaningResponses = {
55114
55147
  */
55115
55148
  keywords: Array<string>;
55116
55149
  /**
55117
- * Authoritative 300 to 500 word interpretation covering personality, life purpose, and core themes. Written by numerology experts and suitable for full-page readings.
55150
+ * Core interpretation of the number covering personality, life purpose and core themes. Together with the strengths, challenges, career, relationships and spirituality fields it makes a full reading.
55118
55151
  */
55119
55152
  description: string;
55120
55153
  /**
@@ -55318,7 +55351,7 @@ export type GetDailyNumberResponses = {
55318
55351
  */
55319
55352
  keywords: Array<string>;
55320
55353
  /**
55321
- * Expert-written 300 to 500 word interpretation of the daily energy. Covers personality resonance, life themes, and how this number influences the day.
55354
+ * Core interpretation of the number of the day: its personality resonance, life themes and how it colors the day. Together with the strengths, challenges, career, relationships and spirituality fields it makes a full reading.
55322
55355
  */
55323
55356
  description: string;
55324
55357
  /**
@@ -55348,7 +55381,7 @@ export type GetDailyNumberResponse = GetDailyNumberResponses[keyof GetDailyNumbe
55348
55381
  export type CalculateChaldeanData = {
55349
55382
  body?: {
55350
55383
  /**
55351
- * The name to analyze. Chaldean tradition uses the name a person is most known by, not necessarily the full legal birth name.
55384
+ * The name to analyze. Chaldean tradition uses the name a person is most known by, not necessarily the full legal birth name. It needs at least one vowel (A, E, I, O, U) and one consonant, since the Soul Urge is read from the vowels and the Personality from the consonants; Y counts as a consonant. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses.
55352
55385
  */
55353
55386
  name: string;
55354
55387
  };
@@ -55497,7 +55530,7 @@ export type CalculateChaldeanResponses = {
55497
55530
  */
55498
55531
  destiny: {
55499
55532
  /**
55500
- * Raw sum of the Chaldean letter values before any reduction.
55533
+ * The sum the compound is read from: for a one-word name, its Chaldean letter total; for a longer name, the sum of each word reduced to its single number, as Cheiro works John Smith (18 to 9, 17 to 8, total 17).
55501
55534
  */
55502
55535
  total: number;
55503
55536
  /**
@@ -55509,7 +55542,7 @@ export type CalculateChaldeanResponses = {
55509
55542
  */
55510
55543
  root: number;
55511
55544
  /**
55512
- * Letter-by-letter Chaldean breakdown summed to the total, then to compound and root.
55545
+ * Letter-by-letter Chaldean breakdown, name by name for a longer name, summed to the total, then to compound and root.
55513
55546
  */
55514
55547
  calculation: string;
55515
55548
  /**
@@ -55543,7 +55576,7 @@ export type CalculateChaldeanResponses = {
55543
55576
  */
55544
55577
  soulUrge: {
55545
55578
  /**
55546
- * Raw sum of the Chaldean letter values before any reduction.
55579
+ * The sum the compound is read from: for a one-word name, its Chaldean letter total; for a longer name, the sum of each word reduced to its single number, as Cheiro works John Smith (18 to 9, 17 to 8, total 17).
55547
55580
  */
55548
55581
  total: number;
55549
55582
  /**
@@ -55555,7 +55588,7 @@ export type CalculateChaldeanResponses = {
55555
55588
  */
55556
55589
  root: number;
55557
55590
  /**
55558
- * Letter-by-letter Chaldean breakdown summed to the total, then to compound and root.
55591
+ * Letter-by-letter Chaldean breakdown, name by name for a longer name, summed to the total, then to compound and root.
55559
55592
  */
55560
55593
  calculation: string;
55561
55594
  /**
@@ -55589,7 +55622,7 @@ export type CalculateChaldeanResponses = {
55589
55622
  */
55590
55623
  personality: {
55591
55624
  /**
55592
- * Raw sum of the Chaldean letter values before any reduction.
55625
+ * The sum the compound is read from: for a one-word name, its Chaldean letter total; for a longer name, the sum of each word reduced to its single number, as Cheiro works John Smith (18 to 9, 17 to 8, total 17).
55593
55626
  */
55594
55627
  total: number;
55595
55628
  /**
@@ -55601,7 +55634,7 @@ export type CalculateChaldeanResponses = {
55601
55634
  */
55602
55635
  root: number;
55603
55636
  /**
55604
- * Letter-by-letter Chaldean breakdown summed to the total, then to compound and root.
55637
+ * Letter-by-letter Chaldean breakdown, name by name for a longer name, summed to the total, then to compound and root.
55605
55638
  */
55606
55639
  calculation: string;
55607
55640
  /**
@@ -55840,7 +55873,7 @@ export type GetCompoundNumberResponse = GetCompoundNumberResponses[keyof GetComp
55840
55873
  export type CalculateDualData = {
55841
55874
  body?: {
55842
55875
  /**
55843
- * The name to analyze in both systems.
55876
+ * The name to analyze in both systems. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses.
55844
55877
  */
55845
55878
  name: string;
55846
55879
  };
@@ -56016,7 +56049,7 @@ export type CalculateDualResponses = {
56016
56049
  */
56017
56050
  root: number;
56018
56051
  /**
56019
- * Raw Chaldean letter total.
56052
+ * The sum the compound is read from: for a one-word name, its Chaldean letter total; for a longer name, the sum of each word reduced to its single number, as Cheiro works John Smith (18 to 9, 17 to 8, total 17).
56020
56053
  */
56021
56054
  total: number;
56022
56055
  /**
@@ -56075,7 +56108,7 @@ export type CalculateDualResponse = CalculateDualResponses[keyof CalculateDualRe
56075
56108
  export type CalculateBusinessNameData = {
56076
56109
  body?: {
56077
56110
  /**
56078
- * The business or brand name to evaluate.
56111
+ * The business or brand name to evaluate. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses.
56079
56112
  */
56080
56113
  name: string;
56081
56114
  };
@@ -56220,7 +56253,7 @@ export type CalculateBusinessNameResponses = {
56220
56253
  */
56221
56254
  name: string;
56222
56255
  /**
56223
- * Raw Chaldean letter total of the name.
56256
+ * The sum the compound is read from: for a one-word name, its Chaldean letter total; for a longer name, the sum of each word reduced to its single number, as Cheiro works John Smith (18 to 9, 17 to 8, total 17).
56224
56257
  */
56225
56258
  total: number;
56226
56259
  /**
@@ -60445,13 +60478,21 @@ export type CastYesNoResponses = {
60445
60478
  */
60446
60479
  seed?: string;
60447
60480
  /**
60448
- * Tarot-derived answer. Yes = upright card supports a positive outcome. No = reversed card suggests obstacles. Maybe = inherently ambiguous card drawn (The Hanged Man, Wheel of Fortune, Temperance, Two of Swords, Four of Swords) signaling pause, reflection, or shifting circumstances.
60481
+ * Tarot-derived answer. Yes = upright card supports a positive outcome. No = reversed card suggests obstacles. Maybe = inherently ambiguous card drawn (The Hanged Man, Wheel of Fortune, Temperance, Two of Swords, Four of Swords) signaling pause, reflection, or shifting circumstances. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use answerLocalized for anything a reader sees.
60449
60482
  */
60450
60483
  answer: 'Yes' | 'No' | 'Maybe';
60451
60484
  /**
60452
- * Confidence level of the answer. Strong = Major Arcana card drawn (powerful, definitive cosmic energy). Qualified = Minor Arcana card drawn (nuanced, situational guidance).
60485
+ * Answer in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
60486
+ */
60487
+ answerLocalized?: string;
60488
+ /**
60489
+ * Confidence level of the answer. Strong = Major Arcana card drawn (powerful, definitive cosmic energy). Qualified = Minor Arcana card drawn (nuanced, situational guidance). Always English, whatever the lang parameter says. Use strengthLocalized for anything a reader sees.
60453
60490
  */
60454
60491
  strength: 'Strong' | 'Qualified';
60492
+ /**
60493
+ * Answer strength in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it.
60494
+ */
60495
+ strengthLocalized?: string;
60455
60496
  card: {
60456
60497
  /**
60457
60498
  * Unique card identifier in kebab-case (e.g. the-fool, ace-of-cups).
@@ -70063,7 +70104,7 @@ export type GetDreamSymbolData = {
70063
70104
  body?: never;
70064
70105
  path: {
70065
70106
  /**
70066
- * Unique symbol identifier in kebab-case (e.g., "snake", "being-chased", "teeth-falling-out").
70107
+ * Unique symbol identifier in kebab-case (e.g., "snake", "chase-dreams", "losing-teeth").
70067
70108
  */
70068
70109
  id: string;
70069
70110
  };