lifeastroapi 0.6.0 → 0.7.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.
package/dist/index.d.ts CHANGED
@@ -26,8 +26,22 @@ interface ResponseEnvelope<T = unknown> {
26
26
  type Ayanamsa = "lahiri" | "krishnamurti" | "raman" | "fagan" | "yukteshwar" | "true_chitrapaksha";
27
27
  /** House systems supported by the API. */
28
28
  type HouseSystem = "whole-sign" | "equal" | "placidus" | "koch" | "porphyry" | "campanus" | "regiomontanus";
29
- /** Narrative / horoscope response languages. */
30
- type Locale = "en" | "hi" | "mr" | "bn" | "kn" | "ta" | "te" | "gu" | "ml";
29
+ /**
30
+ * Response language, passed as `lang` on Vedic methods (panchang, calendar,
31
+ * festivals, eclipses, planet moments, transit, milan, muhurta, chart, prashna,
32
+ * numerology, dasha, varshaphal, ashtakavarga, Lal Kitab, horoscope, reports,
33
+ * narrative, remedies).
34
+ *
35
+ * - Complete: `en`, `hi`, `mr`, `te`, `ta`, `kn`, `ml`, `gu`. Names, terms and
36
+ * prose all come back in the language.
37
+ * - Partial: `bn`, `pa`. Names and terms come back in the language; longer
38
+ * prose is still English.
39
+ *
40
+ * Ids, dates, numbers and explicit `*_en` / `*_hi` fields stay as they are in
41
+ * every language. Western, Tarot, geo and meta methods answer in English
42
+ * (Western narrative also in `hi` and `mr`).
43
+ */
44
+ type Locale = "en" | "hi" | "mr" | "te" | "ta" | "kn" | "ml" | "gu" | "bn" | "pa";
31
45
  /**
32
46
  * A birth (or event) moment with a fixed location. `date`/`time`/`tz` describe
33
47
  * the civil moment; `lat`/`lon` the observer.
@@ -192,13 +206,18 @@ declare class Ashtakavarga {
192
206
  /** Bhinnashtakavarga (BAV) for one planet. */
193
207
  bhinna<T = unknown>(input: BirthInput & VedicMomentSettings & {
194
208
  planet: string;
209
+ lang?: Locale;
195
210
  }, opts?: RequestOptions): Promise<T>;
196
211
  /** Get Kaksha (sub-division) level Ashtakavarga analysis — divides each sign into 8 equal 3°45′ segments, each ruled by a graha. */
197
- kaksha<T = unknown>(input: NatalTransitInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
212
+ kaksha<T = unknown>(input: NatalTransitInput & VedicMomentSettings & {
213
+ lang?: Locale;
214
+ }, opts?: RequestOptions): Promise<T>;
198
215
  /** Get the Sarvashtakavarga table — the combined 12-sign benefic-point grid from all 9 grahas. */
199
216
  sarva<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
200
217
  /** Score current (or a given date's) planetary transits against a natal chart using Ashtakavarga benefic points. */
201
- transitScore<T = unknown>(input: NatalTransitInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
218
+ transitScore<T = unknown>(input: NatalTransitInput & VedicMomentSettings & {
219
+ lang?: Locale;
220
+ }, opts?: RequestOptions): Promise<T>;
202
221
  }
203
222
 
204
223
  declare class Calendar {
@@ -208,21 +227,25 @@ declare class Calendar {
208
227
  adhikMaas<T = unknown>(input: {
209
228
  year: number;
210
229
  tz?: string;
230
+ lang?: Locale;
211
231
  }, opts?: RequestOptions): Promise<T>;
212
232
  /** Get the Hindu calendar details for a Gregorian month — maps each day to its Hindu month (Chaitra/Vaishakha/…), paksha (Shukla/Krishna), tithi, and Vikram Samvat year. */
213
233
  month<T = unknown>(input: {
214
234
  date: string;
215
235
  tz: string;
236
+ lang?: Locale;
216
237
  }, opts?: RequestOptions): Promise<T>;
217
238
  /** Get the current Hindu Ritu (season) for a date — one of 6 seasons: Vasanta (spring), Grishma (summer), Varsha (monsoon), Sharad (autumn), Hemanta (pre-winter), Shishira (winter). */
218
239
  ritu<T = unknown>(input: {
219
240
  date: string;
220
241
  tz: string;
242
+ lang?: Locale;
221
243
  }, opts?: RequestOptions): Promise<T>;
222
244
  /** Get the Samvatsara (Jupiter year) name for a given year — the 60-year Jupiter cycle used in Hindu astrology (Prabhava, Vibhava, Shukla, … Akshaya). */
223
245
  samvatsara<T = unknown>(input: {
224
246
  date: string;
225
247
  tz: string;
248
+ lang?: Locale;
226
249
  }, opts?: RequestOptions): Promise<T>;
227
250
  /** Equinoxes and solstices of a year — exact moment (UTC + local), the ayana that begins (tropical Dakshinayana at the June solstice, tropical Uttarayana at the December solstice; the panchang's Uttarayana is Makara Sankranti), and with lat/lon the sunrise, sunset and day length at that place. */
228
251
  solstices<T = unknown>(input: {
@@ -231,6 +254,7 @@ declare class Calendar {
231
254
  lat?: number;
232
255
  lon?: number;
233
256
  alt?: number;
257
+ lang?: Locale;
234
258
  }, opts?: RequestOptions): Promise<T>;
235
259
  }
236
260
 
@@ -238,28 +262,44 @@ declare class Chart {
238
262
  private readonly _c;
239
263
  constructor(_c: ClientCore);
240
264
  /** Ascendant (Lagna): sign, degree, nakshatra, pada and lord. */
241
- ascendant<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
265
+ ascendant<T = unknown>(input: BirthInput & VedicBirthSettings & {
266
+ lang?: Locale;
267
+ }, opts?: RequestOptions): Promise<T>;
242
268
  /** Sarvashtakavarga (SAV) grid; grand total is always 337. */
243
- ashtakvarga<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
269
+ ashtakvarga<T = unknown>(input: BirthInput & VedicBirthSettings & {
270
+ lang?: Locale;
271
+ }, opts?: RequestOptions): Promise<T>;
244
272
  /** One planet's Bhinnashtakavarga row: its benefic points (bindus) in each of the 12 signs. `planet` is Sun, Moon, Mars, Mercury, Jupiter, Venus or Saturn. */
245
273
  ashtakvargaPlanet<T = unknown>(input: BirthInput & VedicBirthSettings & {
246
274
  planet: string;
275
+ lang?: Locale;
247
276
  }, opts?: RequestOptions): Promise<T>;
248
277
  /** Vedic graha drishti (planetary aspects) table. */
249
- aspects<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
278
+ aspects<T = unknown>(input: BirthInput & VedicBirthSettings & {
279
+ lang?: Locale;
280
+ }, opts?: RequestOptions): Promise<T>;
250
281
  /** Full birth-chart snapshot: avakhada, ascendant, all planets, sun/moon sign and birth panchang. */
251
- astroDetails<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
282
+ astroDetails<T = unknown>(input: BirthInput & VedicBirthSettings & {
283
+ lang?: Locale;
284
+ }, opts?: RequestOptions): Promise<T>;
252
285
  /** Avakhada Chakra: varna, vashya, yoni, gana, nadi and lucky factors. */
253
- avakhada<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
286
+ avakhada<T = unknown>(input: BirthInput & VedicBirthSettings & {
287
+ lang?: Locale;
288
+ }, opts?: RequestOptions): Promise<T>;
254
289
  /** Compute Bhava Bala — the six-component strength of each of the 12 houses: Bhavadhipati Bala (lord strength), Bhava Digbala, Bhava Drishti Bala, and more. */
255
290
  bhavabala<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
256
291
  /** Check which planets are combust (too close to the Sun) in a birth chart — returns each planet's angular distance from Sun, whether it is combust by classical limits, and combust severity. */
257
- combustion<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
292
+ combustion<T = unknown>(input: BirthInput & VedicBirthSettings & {
293
+ lang?: Locale;
294
+ }, opts?: RequestOptions): Promise<T>;
258
295
  /** Every planet's dignity (exalted/debilitated/own/friend/enemy/neutral). */
259
- dignity<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
296
+ dignity<T = unknown>(input: BirthInput & VedicBirthSettings & {
297
+ lang?: Locale;
298
+ }, opts?: RequestOptions): Promise<T>;
260
299
  /** Any divisional (varga) chart, e.g. D1, D9, D10, D60. */
261
300
  divisional<T = unknown>(input: BirthInput & VedicBirthSettings & {
262
301
  varga: string;
302
+ lang?: Locale;
263
303
  }, opts?: RequestOptions): Promise<T>;
264
304
  /** Doshas in a birth chart as data (20 credits): kaalsarp, mangal (from lagna, Moon and Venus with cancellation), pitra, combust, debilitation (with neecha bhanga), retrograde, gandanta, grahan, papakartari, mrityu bhaga, guru chandal, visha kanya, ganda moola. Same item fields as chart.yogas. all=true also lists absent ids. Ids only, no text: planets sun..ketu, sign_index 0-based (Aries=0), house 1-based whole-sign from the lagna, nakshatra index 0-based (Ashwini=0). */
265
305
  doshas<T = unknown>(input: BirthInput & VedicBirthSettings & {
@@ -267,37 +307,55 @@ declare class Chart {
267
307
  gender?: string;
268
308
  }, opts?: RequestOptions): Promise<T>;
269
309
  /** Ghatak Chakra (inauspicious indicators) for the chart. */
270
- ghatak<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
310
+ ghatak<T = unknown>(input: BirthInput & VedicBirthSettings & {
311
+ lang?: Locale;
312
+ }, opts?: RequestOptions): Promise<T>;
271
313
  /** Identify Graha Yuddha (planetary war) in a birth chart — occurs when two visible planets are within 1° of each other. */
272
- grahaYuddha<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
314
+ grahaYuddha<T = unknown>(input: BirthInput & VedicBirthSettings & {
315
+ lang?: Locale;
316
+ }, opts?: RequestOptions): Promise<T>;
273
317
  /** List all planets occupying each of the 12 houses in a birth chart — a house-indexed view of the chart (vs planet-indexed from chart_planets). */
274
- houseOccupants<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
318
+ houseOccupants<T = unknown>(input: BirthInput & VedicBirthSettings & {
319
+ lang?: Locale;
320
+ }, opts?: RequestOptions): Promise<T>;
275
321
  /** 12 house cusps / occupants for the chosen house system. */
276
- houses<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
322
+ houses<T = unknown>(input: BirthInput & VedicBirthSettings & {
323
+ lang?: Locale;
324
+ }, opts?: RequestOptions): Promise<T>;
277
325
  /** Get KP (Krishnamurti Paddhati) house significators for a given cusp — lists planets that significate the house through occupancy, lordship, and sub-lord chain. */
278
326
  kpHouseSignificator<T = unknown>(input: BirthInput & VedicBirthSettings & {
279
327
  cusp: number;
328
+ lang?: Locale;
280
329
  }, opts?: RequestOptions): Promise<T>;
281
330
  /** Get the KP sublord of a planet — the sub-lord of the nakshatra sub-division the planet occupies (KP star lord → sub lord → sub-sub lord chain). */
282
331
  kpSublord<T = unknown>(input: BirthInput & VedicBirthSettings & {
283
332
  planet: string;
333
+ lang?: Locale;
284
334
  }, opts?: RequestOptions): Promise<T>;
285
335
  /** Whole birth chart as data in one call (50 credits): lagna; planets with sign, degree, house, nakshatra, pada, retrograde, combust, dignity, neecha bhanga, vargottama, houses ruled, shadbala, avastha and varga placements; houses with sign, lord, SAV bindus, bhava bala, occupants and aspecting planets; Jaimini chara karakas; avakhada. vargas: comma list (default D9, max 16, D1 rejected). include: shadbala, bhavabala, ashtakvarga, aspects, avastha, karakas, avakhada, yogas or all (default all but yogas). gender narrows Mahabhagya. Ids only, no text: planets sun..ketu, sign_index 0-based (Aries=0), house 1-based whole-sign from the lagna, nakshatra index 0-based (Ashwini=0). Anything not computable is in skipped. */
286
336
  kundliFacts<T = unknown>(input: BirthInput & VedicBirthSettings & {
287
337
  vargas?: string;
288
338
  include?: string;
289
339
  gender?: string;
340
+ lang?: Locale;
290
341
  }, opts?: RequestOptions): Promise<T>;
291
342
  /** Birth (Janma) nakshatra and pada. */
292
- nakshatra<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
343
+ nakshatra<T = unknown>(input: BirthInput & VedicBirthSettings & {
344
+ lang?: Locale;
345
+ }, opts?: RequestOptions): Promise<T>;
293
346
  /** Navamsa (D9) divisional chart — convenience alias for divisional('D9'). */
294
- navamsa<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
347
+ navamsa<T = unknown>(input: BirthInput & VedicBirthSettings & {
348
+ lang?: Locale;
349
+ }, opts?: RequestOptions): Promise<T>;
295
350
  /** Detail for a single planet (sun|moon|mars|mercury|jupiter|venus|saturn|rahu|ketu). */
296
351
  planet<T = unknown>(input: BirthInput & VedicBirthSettings & {
297
352
  name: string;
353
+ lang?: Locale;
298
354
  }, opts?: RequestOptions): Promise<T>;
299
355
  /** All 9 grahas with sign, degree, nakshatra, house, retrograde, dignity, combustion and speed. */
300
- planets<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
356
+ planets<T = unknown>(input: BirthInput & VedicBirthSettings & {
357
+ lang?: Locale;
358
+ }, opts?: RequestOptions): Promise<T>;
301
359
  /** Birth-time sensitivity (20 credits): for D1 and each varga (default D9,D10,D24) the lagna sign at birth and how many minutes before/after it stays the same, with the neighbouring signs; the same for the Moon's nakshatra and pada; planet sign changes inside the window. window: half-width in minutes (default 120, max 180). Use it to tell users how much a birth-time error matters. Every instant comes as *_local (RFC 3339 with offset) and *_jd (Julian Day, UT); fields that cannot be computed are listed in skipped. */
302
360
  sensitivity<T = unknown>(input: BirthInput & VedicBirthSettings & {
303
361
  window?: number;
@@ -305,10 +363,13 @@ declare class Chart {
305
363
  topocentricMoon?: boolean;
306
364
  }, opts?: RequestOptions): Promise<T>;
307
365
  /** Shadbala (six-fold strength) for all 7 planets with components. */
308
- shadbala<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
366
+ shadbala<T = unknown>(input: BirthInput & VedicBirthSettings & {
367
+ lang?: Locale;
368
+ }, opts?: RequestOptions): Promise<T>;
309
369
  /** One shadbala component (sthana|dig|kala|chesta|naisargika|drik) for all planets. */
310
370
  shadbalaComponent<T = unknown>(input: BirthInput & VedicBirthSettings & {
311
371
  component: string;
372
+ lang?: Locale;
312
373
  }, opts?: RequestOptions): Promise<T>;
313
374
  /** Yogas present in a birth chart as data (20 credits), from the same detectors as narrative.yogas: id, kind, category, present, planets, houses, strength, cancelled + cancel_reasons, variant, axes, sub_ids, source, details. Includes neecha_bhanga.<planet> and raja_yoga.kendra_trikona. all=true also lists every absent catalogue id with present:false. Ids only, no text: planets sun..ketu, sign_index 0-based (Aries=0), house 1-based whole-sign from the lagna, nakshatra index 0-based (Ashwini=0). */
314
375
  yogas<T = unknown>(input: BirthInput & VedicBirthSettings & {
@@ -321,42 +382,55 @@ declare class Dasha {
321
382
  private readonly _c;
322
383
  constructor(_c: ClientCore);
323
384
  /** Full Char Dasha (Jaimini sign-based dasha) schedule — every mahadasha sign period with start/end dates. */
324
- char<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
385
+ char<T = unknown>(input: BirthInput & VedicBirthSettings & {
386
+ lang?: Locale;
387
+ }, opts?: RequestOptions): Promise<T>;
325
388
  /** Sub-periods inside a Char Dasha mahadasha+antardasha sign pair. */
326
389
  charAntar<T = unknown>(input: BirthInput & VedicBirthSettings & {
327
390
  md: string;
328
391
  ad: string;
392
+ lang?: Locale;
329
393
  }, opts?: RequestOptions): Promise<T>;
330
394
  /** Currently running Char Dasha (Jaimini) period stack — active mahadasha and antardasha signs with date windows. */
331
- charCurrent<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
395
+ charCurrent<T = unknown>(input: BirthInput & VedicBirthSettings & {
396
+ lang?: Locale;
397
+ }, opts?: RequestOptions): Promise<T>;
332
398
  /** Antardashas inside one Char Dasha mahadasha sign (md = sign name, e.g. 'leo'). */
333
399
  charMaha<T = unknown>(input: BirthInput & VedicBirthSettings & {
334
400
  md: string;
401
+ lang?: Locale;
335
402
  }, opts?: RequestOptions): Promise<T>;
336
403
  /** Char Dasha mahadasha-level periods only — one row per sign period. */
337
- charMajor<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
404
+ charMajor<T = unknown>(input: BirthInput & VedicBirthSettings & {
405
+ lang?: Locale;
406
+ }, opts?: RequestOptions): Promise<T>;
338
407
  /** Full Vimshottari dasha tree (depth 1-5). */
339
408
  vimshottari<T = unknown>(input: BirthInput & VedicBirthSettings & {
340
409
  depth?: number;
410
+ lang?: Locale;
341
411
  }, opts?: RequestOptions): Promise<T>;
342
412
  /** Pratyantardashas within a Maha+Antar pair. */
343
413
  vimshottariAntar<T = unknown>(input: BirthInput & VedicBirthSettings & {
344
414
  md: string;
345
415
  ad: string;
416
+ lang?: Locale;
346
417
  }, opts?: RequestOptions): Promise<T>;
347
418
  /** Currently running 5-level Vimshottari dasha stack (optionally at a custom moment). */
348
419
  vimshottariCurrent<T = unknown>(input: BirthInput & VedicBirthSettings & {
349
420
  at?: string;
421
+ lang?: Locale;
350
422
  }, opts?: RequestOptions): Promise<T>;
351
423
  /** Antardashas within one Mahadasha lord. */
352
424
  vimshottariMaha<T = unknown>(input: BirthInput & VedicBirthSettings & {
353
425
  md: string;
426
+ lang?: Locale;
354
427
  }, opts?: RequestOptions): Promise<T>;
355
428
  /** Sookshma periods within a 3-level Vimshottari combination. */
356
429
  vimshottariPratyantar<T = unknown>(input: BirthInput & VedicBirthSettings & {
357
430
  md: string;
358
431
  ad: string;
359
432
  pd: string;
433
+ lang?: Locale;
360
434
  }, opts?: RequestOptions): Promise<T>;
361
435
  /** Prana periods within a 4-level Vimshottari combination. */
362
436
  vimshottariSookshma<T = unknown>(input: BirthInput & VedicBirthSettings & {
@@ -364,18 +438,22 @@ declare class Dasha {
364
438
  ad: string;
365
439
  pd: string;
366
440
  sd: string;
441
+ lang?: Locale;
367
442
  }, opts?: RequestOptions): Promise<T>;
368
443
  /** Full Yogini dasha tree (36-year cycle, 8 lords). */
369
444
  yogini<T = unknown>(input: BirthInput & VedicBirthSettings & {
370
445
  depth?: number;
446
+ lang?: Locale;
371
447
  }, opts?: RequestOptions): Promise<T>;
372
448
  /** Yogini dasha sub-periods for a named Yogini lord. */
373
449
  yoginiByName<T = unknown>(input: BirthInput & VedicBirthSettings & {
374
450
  name: string;
451
+ lang?: Locale;
375
452
  }, opts?: RequestOptions): Promise<T>;
376
453
  /** Currently running Yogini dasha. */
377
454
  yoginiCurrent<T = unknown>(input: BirthInput & VedicBirthSettings & {
378
455
  at?: string;
456
+ lang?: Locale;
379
457
  }, opts?: RequestOptions): Promise<T>;
380
458
  }
381
459
 
@@ -388,6 +466,7 @@ declare class Eclipses {
388
466
  lon?: number;
389
467
  alt?: number;
390
468
  tz?: string;
469
+ lang?: Locale;
391
470
  }, opts?: RequestOptions): Promise<T>;
392
471
  /** Lunar eclipses in a date range. With lat/lon (and tz) each event carries a `local` block: contact times sparsha…moksha in local time, visibility at that place, and the sutak kaal (12 h before a solar, 9 h before a lunar eclipse, until moksha). */
393
472
  lunar<T = unknown>(input: DateRangeInput & {
@@ -395,6 +474,7 @@ declare class Eclipses {
395
474
  lon?: number;
396
475
  alt?: number;
397
476
  tz?: string;
477
+ lang?: Locale;
398
478
  }, opts?: RequestOptions): Promise<T>;
399
479
  /** Solar eclipses in a date range. With lat/lon (and tz) each event carries a `local` block: contact times sparsha…moksha in local time, visibility at that place, and the sutak kaal (12 h before a solar, 9 h before a lunar eclipse, until moksha). */
400
480
  solar<T = unknown>(input: DateRangeInput & {
@@ -402,6 +482,7 @@ declare class Eclipses {
402
482
  lon?: number;
403
483
  alt?: number;
404
484
  tz?: string;
485
+ lang?: Locale;
405
486
  }, opts?: RequestOptions): Promise<T>;
406
487
  }
407
488
 
@@ -418,6 +499,7 @@ declare class Festivals {
418
499
  locale?: string;
419
500
  monthSystem?: string;
420
501
  ayanamsa?: string;
502
+ lang?: Locale;
421
503
  }, opts?: RequestOptions): Promise<T>;
422
504
  /** All festivals, vrats and observances on one civil date at a location (same engine and fields as festivals.month): Ekadashi smarta/Vaishnava, Pradosh, Purnima, Amavasya, Sankranti, jayantis, eclipses, each with the windows a panchang prints (moonrise, pradosh kaal, parana). Defaults to New Delhi / Asia/Kolkata. */
423
505
  onDate<T = unknown>(input: {
@@ -428,6 +510,7 @@ declare class Festivals {
428
510
  locale?: string;
429
511
  monthSystem?: string;
430
512
  ayanamsa?: string;
513
+ lang?: Locale;
431
514
  }, opts?: RequestOptions): Promise<T>;
432
515
  /** Year-wise Vrat & Upavas dates of one family at a location — type: ekadashi | parana | pradosh | sankashti | vinayaka | purnima | amavasya | chandra_darshana | masik_shivaratri | durgashtami | kalashtami | skanda_shashthi | karthigai | shraddha | janmashtami | sankranti | satyanarayana | bhanu_saptami | eclipse (comma-separated for several). Same occurrence objects as festivals.month. */
433
516
  vrat<T = unknown>(input: {
@@ -439,6 +522,7 @@ declare class Festivals {
439
522
  locale?: string;
440
523
  monthSystem?: string;
441
524
  ayanamsa?: string;
525
+ lang?: Locale;
442
526
  }, opts?: RequestOptions): Promise<T>;
443
527
  }
444
528
 
@@ -487,11 +571,17 @@ declare class Lalkitab {
487
571
  private readonly _c;
488
572
  constructor(_c: ClientCore);
489
573
  /** Lal Kitab chart — planets mapped into Lal Kitab's fixed Aries-based houses. */
490
- chart<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
574
+ chart<T = unknown>(input: BirthInput & VedicBirthSettings & {
575
+ lang?: Locale;
576
+ }, opts?: RequestOptions): Promise<T>;
491
577
  /** Full 35-year Lal Kitab dasha schedule — planet-ruled periods with start/end dates. */
492
- dasha<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
578
+ dasha<T = unknown>(input: BirthInput & VedicBirthSettings & {
579
+ lang?: Locale;
580
+ }, opts?: RequestOptions): Promise<T>;
493
581
  /** Currently active Lal Kitab dasha planet and period window. */
494
- dashaCurrent<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
582
+ dashaCurrent<T = unknown>(input: BirthInput & VedicBirthSettings & {
583
+ lang?: Locale;
584
+ }, opts?: RequestOptions): Promise<T>;
495
585
  }
496
586
 
497
587
  declare class Meta {
@@ -517,10 +607,13 @@ declare class Milan {
517
607
  private readonly _c;
518
608
  constructor(_c: ClientCore);
519
609
  /** Full 36-point Ashtakoota breakdown across all 8 kootas. */
520
- ashtakoota<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
610
+ ashtakoota<T = unknown>(input: BoyGirlInput & VedicMomentSettings & {
611
+ lang?: Locale;
612
+ }, opts?: RequestOptions): Promise<T>;
521
613
  /** One koota (varna|vashya|tara|yoni|graha_maitri|gana|bhakoot|nadi). */
522
614
  ashtakootaKoota<T = unknown>(input: BoyGirlInput & VedicMomentSettings & {
523
615
  koota: string;
616
+ lang?: Locale;
524
617
  }, opts?: RequestOptions): Promise<T>;
525
618
  /** Just the Ashtakoota (Guna Milan) total score and verdict. */
526
619
  ashtakootaTotal<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
@@ -533,68 +626,107 @@ declare class Milan {
533
626
  date?: string;
534
627
  time?: string;
535
628
  tz?: string;
629
+ lang?: Locale;
536
630
  }, opts?: RequestOptions): Promise<T>;
537
631
  /** Check Dhan Yog (wealth yoga) for a single person's chart — assesses 2nd/11th house lord strength and Jupiter placement for prosperity. */
538
- dhanYog<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
632
+ dhanYog<T = unknown>(input: BirthInput & VedicMomentSettings & {
633
+ lang?: Locale;
634
+ }, opts?: RequestOptions): Promise<T>;
539
635
  /** Assess longevity for a single person's chart — classical analysis of lagna, 8th house, and Moon sign longevity indicators. */
540
- longevity<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
636
+ longevity<T = unknown>(input: BirthInput & VedicMomentSettings & {
637
+ lang?: Locale;
638
+ }, opts?: RequestOptions): Promise<T>;
541
639
  /** Check Mahendra Koota — the 4th additional compatibility factor beyond Ashtakoota. */
542
- mahendra<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
640
+ mahendra<T = unknown>(input: BoyGirlInput & VedicMomentSettings & {
641
+ lang?: Locale;
642
+ }, opts?: RequestOptions): Promise<T>;
543
643
  /** Mangal Dosha (Manglik) detection for one chart. */
544
- mangalDosha<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
644
+ mangalDosha<T = unknown>(input: BirthInput & VedicMomentSettings & {
645
+ lang?: Locale;
646
+ }, opts?: RequestOptions): Promise<T>;
545
647
  /** Nadi dosha detection plus exceptions. */
546
- nadiDosha<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
648
+ nadiDosha<T = unknown>(input: BoyGirlInput & VedicMomentSettings & {
649
+ lang?: Locale;
650
+ }, opts?: RequestOptions): Promise<T>;
547
651
  /** Check Navamsa compatibility — compares the D9 (Navamsa) chart placements of both partners for deeper marriage harmony beyond the D1 chart. */
548
- navamsaCompat<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
652
+ navamsaCompat<T = unknown>(input: BoyGirlInput & VedicMomentSettings & {
653
+ lang?: Locale;
654
+ }, opts?: RequestOptions): Promise<T>;
549
655
  /** Couple chart overlay as data (20 credits): each partner's grahas in the other's whole-sign houses (with conjunct grahas), same-sign and same-nakshatra pairs, Moon sign relation (e.g. "2/12"), and each lagna lord's placement in the other's chart (sign, house, dignity, combust, retro). Each partner's chart uses the ayanamsa of their own birth moment. Ids only, no text: planets sun..ketu, sign_index 0-based (Aries=0), house 1-based whole-sign from the lagna, nakshatra index 0-based (Ashwini=0). */
550
656
  overlay<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
551
657
  /** Check Santan Yog for a single person's chart — assesses 5th house lord and Jupiter placement to indicate prospects for children. */
552
- santanYog<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
658
+ santanYog<T = unknown>(input: BirthInput & VedicMomentSettings & {
659
+ lang?: Locale;
660
+ }, opts?: RequestOptions): Promise<T>;
553
661
  /** Check Shani Dosha for a single person's chart — Saturn in 1st, 4th, 7th, 10th, or 12th house from lagna. */
554
- shaniDosha<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
662
+ shaniDosha<T = unknown>(input: BirthInput & VedicMomentSettings & {
663
+ lang?: Locale;
664
+ }, opts?: RequestOptions): Promise<T>;
555
665
  /** Check Stree Dirgha — the distance from bride's nakshatra to groom's must be more than 9 nakshatras for a beneficial match (indicates the groom will lead a longer, more prosperous life than the bride expected). */
556
- streeDirgha<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
666
+ streeDirgha<T = unknown>(input: BoyGirlInput & VedicMomentSettings & {
667
+ lang?: Locale;
668
+ }, opts?: RequestOptions): Promise<T>;
557
669
  /** Couple matching data in one call (60 credits), numbers identical to the separate routes: ashtakoota (every koota), navamsa_compat, mangal_dosha of both plus pair status, seventh_house facts of both (7th sign, occupants, 7th lord, Venus, Jupiter, D9 7th, D7 5th), and sade_sati windows of both for 10 years from from. include=kundli_facts adds both full charts. Ids only, no text: planets sun..ketu, sign_index 0-based (Aries=0), house 1-based whole-sign from the lagna, nakshatra index 0-based (Ashwini=0). */
558
670
  summary<T = unknown>(input: BoyGirlInput & VedicMomentSettings & {
559
671
  from?: string;
560
672
  tz?: string;
561
673
  include?: string;
674
+ lang?: Locale;
562
675
  }, opts?: RequestOptions): Promise<T>;
563
676
  /** Vivah Phal (marriage-outcome) assessment for one chart. */
564
- vivahPhal<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
677
+ vivahPhal<T = unknown>(input: BirthInput & VedicMomentSettings & {
678
+ lang?: Locale;
679
+ }, opts?: RequestOptions): Promise<T>;
565
680
  }
566
681
 
567
682
  declare class Muhurta {
568
683
  private readonly _c;
569
684
  constructor(_c: ClientCore);
570
- /** Best-scoring general muhurta window in a date range. */
571
- bestTime<T = unknown>(input: MuhurtaInput, opts?: RequestOptions): Promise<T>;
685
+ /** Best-scoring general muhurta window in a date range. Each `factors[]` item has a stable English `id` (e.g. `Tithi`, `RahuKaal`); `name` and `value` follow `lang`. */
686
+ bestTime<T = unknown>(input: MuhurtaInput & {
687
+ lang?: Locale;
688
+ }, opts?: RequestOptions): Promise<T>;
572
689
  /** Compute Chandra Bala — the Moon's strength relative to a person's natal Moon sign on a given date. */
573
690
  chandraBala<T = unknown>(input: BirthInput & VedicBirthSettings & {
574
691
  birthMoonSign: number;
575
692
  }, opts?: RequestOptions): Promise<T>;
576
- /** Find auspicious Griha Pravesh (housewarming) muhurta windows in a date range — checks tithi, nakshatra, vara, Sun position, and lagna for the ceremony. */
577
- grahaPravesh<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
578
- /** Naamkaran (naming ceremony) muhurta windows. */
693
+ /** Find auspicious Griha Pravesh (housewarming) muhurta windows in a date range — checks tithi, nakshatra, vara, Sun position, and lagna for the ceremony. Each `factors[]` item has a stable English `id` (e.g. `Tithi`, `RahuKaal`); `name` and `value` follow `lang`. */
694
+ grahaPravesh<T = unknown>(input: MomentInput & VedicMomentSettings & {
695
+ lang?: Locale;
696
+ }, opts?: RequestOptions): Promise<T>;
697
+ /** Naamkaran (naming ceremony) muhurta windows. Each `factors[]` item has a stable English `id` (e.g. `Tithi`, `RahuKaal`); `name` and `value` follow `lang`. */
579
698
  naamkaran<T = unknown>(input: MomentInput & VedicMomentSettings & {
580
699
  birthDate: string;
700
+ lang?: Locale;
581
701
  }, opts?: RequestOptions): Promise<T>;
582
702
  /** Find Panchaka-free (Panchaka Rahita) windows in a date range — Panchaka occurs when Moon is in Aquarius or Pisces and creates obstacles for travel, construction, funerals, and certain ceremonies. */
583
- panchakaRahita<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
703
+ panchakaRahita<T = unknown>(input: MomentInput & VedicMomentSettings & {
704
+ lang?: Locale;
705
+ }, opts?: RequestOptions): Promise<T>;
584
706
  /** Find Sarvartha Siddhi Yoga windows — one of the most auspicious panchang yogas formed by specific vara+nakshatra combinations. */
585
- sarvarthaSiddhi<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
707
+ sarvarthaSiddhi<T = unknown>(input: MomentInput & VedicMomentSettings & {
708
+ lang?: Locale;
709
+ }, opts?: RequestOptions): Promise<T>;
586
710
  /** Find Shubha Yoga (auspicious panchang yoga) windows in a date range — checks for Amrit Siddhi, Sarvartha Siddhi, Ravi Yoga, and other classical panchang yogas in combination. */
587
- shubhaYoga<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
711
+ shubhaYoga<T = unknown>(input: MomentInput & VedicMomentSettings & {
712
+ lang?: Locale;
713
+ }, opts?: RequestOptions): Promise<T>;
588
714
  /** Compute Tara Bala score for a given date relative to a person's birth nakshatra — rates the day's Moon nakshatra as Janma/Sampat/Vipat/Kshema/Pratyak/Sadhana/Vadha/Mitra/Param-Mitra. */
589
715
  taraBala<T = unknown>(input: BirthInput & VedicBirthSettings & {
590
716
  birthNak: number;
591
717
  }, opts?: RequestOptions): Promise<T>;
592
- /** Auspicious wedding (vivah) muhurta windows in a date range. */
593
- vivah<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
594
- /** Find auspicious Vyapar (business/trade) muhurta windows — suitable for starting a business, signing contracts, launching a product, or opening a shop. */
595
- vyapar<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
596
- /** Find auspicious Yatra (travel/journey) muhurta windows — avoids Disha Shool (directional inauspiciousness), Rahu Kaal, Nak Shool, and favours Pushya/Hasta/Ashwini/Anuradha nakshatras for journeys. */
597
- yatra<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
718
+ /** Auspicious wedding (vivah) muhurta windows in a date range. Each `factors[]` item has a stable English `id` (e.g. `Tithi`, `RahuKaal`); `name` and `value` follow `lang`. */
719
+ vivah<T = unknown>(input: MomentInput & VedicMomentSettings & {
720
+ lang?: Locale;
721
+ }, opts?: RequestOptions): Promise<T>;
722
+ /** Find auspicious Vyapar (business/trade) muhurta windows — suitable for starting a business, signing contracts, launching a product, or opening a shop. Each `factors[]` item has a stable English `id` (e.g. `Tithi`, `RahuKaal`); `name` and `value` follow `lang`. */
723
+ vyapar<T = unknown>(input: MomentInput & VedicMomentSettings & {
724
+ lang?: Locale;
725
+ }, opts?: RequestOptions): Promise<T>;
726
+ /** Find auspicious Yatra (travel/journey) muhurta windows — avoids Disha Shool (directional inauspiciousness), Rahu Kaal, Nak Shool, and favours Pushya/Hasta/Ashwini/Anuradha nakshatras for journeys. Each `factors[]` item has a stable English `id` (e.g. `Tithi`, `RahuKaal`); `name` and `value` follow `lang`. */
727
+ yatra<T = unknown>(input: MomentInput & VedicMomentSettings & {
728
+ lang?: Locale;
729
+ }, opts?: RequestOptions): Promise<T>;
598
730
  }
599
731
 
600
732
  declare class Narrative {
@@ -645,6 +777,7 @@ declare class Narrative {
645
777
  /** Get a daily horoscope in Tamil astrology style — uses the Tamil rashi system and traditional Tamil Panchangam for the day's reading. The input is the birth chart; pass `onDate` (YYYY-MM-DD) to read a day other than today. */
646
778
  horoscopeDailyTamil<T = unknown>(input: BirthInput & VedicBirthSettings & {
647
779
  onDate?: string;
780
+ lang?: Locale;
648
781
  }, opts?: RequestOptions): Promise<T>;
649
782
  /** Get a personalised weekly horoscope narrative computed from the birth chart's rising sign (lagna) — personalised 7-day outlook with major transit themes. The input is the birth chart; pass `onDate` (YYYY-MM-DD) to read a day other than today. */
650
783
  horoscopeWeeklyByLagna<T = unknown>(input: BirthInput & VedicBirthSettings & {
@@ -783,6 +916,7 @@ declare class Narrative {
783
916
  lat: number;
784
917
  lon: number;
785
918
  year: number;
919
+ lang?: Locale;
786
920
  }, opts?: RequestOptions): Promise<T>;
787
921
  /** Narrative interpretation of a specific yoga in the chart. */
788
922
  yoga<T = unknown>(input: BirthInput & VedicBirthSettings & {
@@ -851,29 +985,47 @@ declare class Panchang {
851
985
  /** Abhijit Muhurat (auspicious window around solar noon). */
852
986
  abhijit<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
853
987
  /** Full advanced panchang: everything in basic plus all muhurta windows, Choghadiya, Hindu month, samvat and more. */
854
- advanced<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
988
+ advanced<T = unknown>(input: MomentInput & VedicMomentSettings & {
989
+ lang?: Locale;
990
+ }, opts?: RequestOptions): Promise<T>;
855
991
  /** Amrit Kalam auspicious window. */
856
- amritKalam<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
992
+ amritKalam<T = unknown>(input: MomentInput & VedicMomentSettings & {
993
+ lang?: Locale;
994
+ }, opts?: RequestOptions): Promise<T>;
857
995
  /** Composite basic panchang in one call: tithi, nakshatra, yoga, karana, vara, sun/moon rise & set. */
858
- basic<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
996
+ basic<T = unknown>(input: MomentInput & VedicMomentSettings & {
997
+ lang?: Locale;
998
+ }, opts?: RequestOptions): Promise<T>;
859
999
  /** Brahma Muhurat window before sunrise. */
860
1000
  brahmaMuhurat<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
861
1001
  /** Choghadiya periods (day + night). */
862
- choghadiya<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1002
+ choghadiya<T = unknown>(input: MomentInput & VedicMomentSettings & {
1003
+ lang?: Locale;
1004
+ }, opts?: RequestOptions): Promise<T>;
863
1005
  /** Durmuhurta inauspicious periods for the day. */
864
1006
  durmuhurta<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
865
1007
  /** Gulika Kaal window. */
866
1008
  gulika<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
867
1009
  /** Hindu lunar month, paksha, samvat and adhik/kshaya detection. */
868
- hinduMonth<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1010
+ hinduMonth<T = unknown>(input: MomentInput & VedicMomentSettings & {
1011
+ lang?: Locale;
1012
+ }, opts?: RequestOptions): Promise<T>;
869
1013
  /** Planetary hours (horas) for the day, or the hora at a given time. */
870
- hora<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1014
+ hora<T = unknown>(input: MomentInput & VedicMomentSettings & {
1015
+ lang?: Locale;
1016
+ }, opts?: RequestOptions): Promise<T>;
871
1017
  /** Get the Dinman (day length) and Ratriman (night length) for a date — the exact duration of daytime from sunrise to sunset and nighttime from sunset to next sunrise, in ghatis (1 ghati = 24 minutes). */
872
- horaDinman<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1018
+ horaDinman<T = unknown>(input: MomentInput & VedicMomentSettings & {
1019
+ lang?: Locale;
1020
+ }, opts?: RequestOptions): Promise<T>;
873
1021
  /** Current karana (half-tithi). */
874
- karana<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1022
+ karana<T = unknown>(input: MomentInput & VedicMomentSettings & {
1023
+ lang?: Locale;
1024
+ }, opts?: RequestOptions): Promise<T>;
875
1025
  /** Lagna (rising sign) table for the day with start/end times for each sign. */
876
- lagnaTable<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1026
+ lagnaTable<T = unknown>(input: MomentInput & VedicMomentSettings & {
1027
+ lang?: Locale;
1028
+ }, opts?: RequestOptions): Promise<T>;
877
1029
  /** Full-month panchang calendar (one entry per day). tz accepts an IANA name ("Asia/Kolkata"), a fixed offset ("+05:30") or decimal hours ("5.5"). Pass include: "sheet" for a complete printable Hindu calendar page: per-day tithi/nakshatra/moon-sign end-times ("27:07+" notation), kshaya days, moonrise/moonset, Hindu month, Vikram/Shaka samvat, moon phase and every festival of the day, plus the page header. */
878
1030
  monthly<T = unknown>(input: {
879
1031
  lat: number;
@@ -886,17 +1038,23 @@ declare class Panchang {
886
1038
  locale?: string;
887
1039
  monthSystem?: string;
888
1040
  ayanamsa?: string;
1041
+ lang?: Locale;
889
1042
  }, opts?: RequestOptions): Promise<T>;
890
1043
  /** Moonrise and moonset times. */
891
1044
  moonriseMoonset<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
892
1045
  /** Moon's nakshatra with pada, lord and start/end at the moment. */
893
- nakshatra<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1046
+ nakshatra<T = unknown>(input: MomentInput & VedicMomentSettings & {
1047
+ lang?: Locale;
1048
+ }, opts?: RequestOptions): Promise<T>;
894
1049
  /** Personalised daily Tara Bala prediction relative to a birth nakshatra (index 0-26). */
895
1050
  nakshatraPrediction<T = unknown>(input: MomentInput & VedicMomentSettings & {
896
1051
  birthNak: number;
1052
+ lang?: Locale;
1053
+ }, opts?: RequestOptions): Promise<T>;
1054
+ /** Panchaka classification at the moment. `avoidance` is the id list (comma-separated); `avoidance_text` is the same list as reader text in `lang`. */
1055
+ panchaka<T = unknown>(input: MomentInput & VedicMomentSettings & {
1056
+ lang?: Locale;
897
1057
  }, opts?: RequestOptions): Promise<T>;
898
- /** Panchaka classification at the moment. */
899
- panchaka<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
900
1058
  /** Pradosh Kaal twilight window after sunset. */
901
1059
  pradoshKaal<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
902
1060
  /** Rahu Kaal inauspicious window. */
@@ -905,23 +1063,36 @@ declare class Panchang {
905
1063
  sankranti<T = unknown>(input: {
906
1064
  date: string;
907
1065
  tz: string;
1066
+ lang?: Locale;
908
1067
  }, opts?: RequestOptions): Promise<T>;
909
1068
  /** Siddha Yoga vara+nakshatra auspicious combination check. */
910
- siddhaYoga<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1069
+ siddhaYoga<T = unknown>(input: MomentInput & VedicMomentSettings & {
1070
+ lang?: Locale;
1071
+ }, opts?: RequestOptions): Promise<T>;
911
1072
  /** Quick 5-element panchang strip (tithi, nakshatra, yoga, karana, vara) plus sunrise/sunset. */
912
- summary<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1073
+ summary<T = unknown>(input: MomentInput & VedicMomentSettings & {
1074
+ lang?: Locale;
1075
+ }, opts?: RequestOptions): Promise<T>;
913
1076
  /** Sunrise and sunset times plus day length. */
914
1077
  sunriseSunset<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
915
1078
  /** Current tithi (lunar day) with paksha, lord and transition timing. */
916
- tithi<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1079
+ tithi<T = unknown>(input: MomentInput & VedicMomentSettings & {
1080
+ lang?: Locale;
1081
+ }, opts?: RequestOptions): Promise<T>;
917
1082
  /** Hindu weekday (vara) and its ruling planet. */
918
- vara<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1083
+ vara<T = unknown>(input: MomentInput & VedicMomentSettings & {
1084
+ lang?: Locale;
1085
+ }, opts?: RequestOptions): Promise<T>;
919
1086
  /** Varjyam forbidden window based on the Moon's nakshatra. */
920
- varjyam<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1087
+ varjyam<T = unknown>(input: MomentInput & VedicMomentSettings & {
1088
+ lang?: Locale;
1089
+ }, opts?: RequestOptions): Promise<T>;
921
1090
  /** Yamaganda inauspicious window. */
922
1091
  yamaganda<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
923
1092
  /** Current panchang yoga (one of 27). */
924
- yoga<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1093
+ yoga<T = unknown>(input: MomentInput & VedicMomentSettings & {
1094
+ lang?: Locale;
1095
+ }, opts?: RequestOptions): Promise<T>;
925
1096
  }
926
1097
 
927
1098
  declare class PlanetMoments {
@@ -934,6 +1105,7 @@ declare class PlanetMoments {
934
1105
  time?: string;
935
1106
  tz: string;
936
1107
  maxDays?: number;
1108
+ lang?: Locale;
937
1109
  }, opts?: RequestOptions): Promise<T>;
938
1110
  /** A planet's sign ingresses (sankranti) in a date range. */
939
1111
  ingress<T = unknown>(input: {
@@ -942,6 +1114,7 @@ declare class PlanetMoments {
942
1114
  time?: string;
943
1115
  tz: string;
944
1116
  maxDays?: number;
1117
+ lang?: Locale;
945
1118
  }, opts?: RequestOptions): Promise<T>;
946
1119
  /** A planet's retrograde windows (station retro -> station direct) in a date range. */
947
1120
  retrogradeWindow<T = unknown>(input: {
@@ -950,6 +1123,7 @@ declare class PlanetMoments {
950
1123
  time?: string;
951
1124
  tz: string;
952
1125
  maxDays?: number;
1126
+ lang?: Locale;
953
1127
  }, opts?: RequestOptions): Promise<T>;
954
1128
  /** Get the current speed and motion state of a planet — degrees per day, whether it is direct/retrograde/stationary, and its speed relative to mean motion. */
955
1129
  speed<T = unknown>(input: {
@@ -957,6 +1131,7 @@ declare class PlanetMoments {
957
1131
  date: string;
958
1132
  time?: string;
959
1133
  tz: string;
1134
+ lang?: Locale;
960
1135
  }, opts?: RequestOptions): Promise<T>;
961
1136
  }
962
1137
 
@@ -966,16 +1141,24 @@ declare class Prashna {
966
1141
  /** Cast a Prashna (horary) chart and compute the classical yes/no answer. */
967
1142
  answer<T = unknown>(input: MomentInput & VedicMomentSettings & {
968
1143
  house: number;
1144
+ lang?: Locale;
969
1145
  }, opts?: RequestOptions): Promise<T>;
970
1146
  /** Compute the Arudha Lagna of a Prashna chart — the perceived image/manifestation of the question's subject. */
971
- arudha<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1147
+ arudha<T = unknown>(input: MomentInput & VedicMomentSettings & {
1148
+ lang?: Locale;
1149
+ }, opts?: RequestOptions): Promise<T>;
972
1150
  /** Cast the full Prashna (horary) chart for the moment a question is asked — returns lagna, all planet placements, houses, and panchang at the moment of the question. */
973
- chart<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1151
+ chart<T = unknown>(input: MomentInput & VedicMomentSettings & {
1152
+ lang?: Locale;
1153
+ }, opts?: RequestOptions): Promise<T>;
974
1154
  /** Get the lagna lord analysis for a Prashna chart — where the lagna lord is placed, its strength, and what it indicates about the querent's situation and chances of success. */
975
- lagnaLord<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1155
+ lagnaLord<T = unknown>(input: MomentInput & VedicMomentSettings & {
1156
+ lang?: Locale;
1157
+ }, opts?: RequestOptions): Promise<T>;
976
1158
  /** Get the KP significators for a Prashna chart — lists planets significating the houses relevant to the question (e.g. */
977
1159
  significators<T = unknown>(input: MomentInput & VedicMomentSettings & {
978
1160
  house: number;
1161
+ lang?: Locale;
979
1162
  }, opts?: RequestOptions): Promise<T>;
980
1163
  }
981
1164
 
@@ -991,6 +1174,7 @@ declare class Remedies {
991
1174
  daan<T = unknown>(input: {
992
1175
  id: string;
993
1176
  locale?: string;
1177
+ lang?: Locale;
994
1178
  }, opts?: RequestOptions): Promise<T>;
995
1179
  /** Remedies for one graha by reason (10 credits): a filter over the remedy catalogue (same rows and languages as remedies.vedic). reason: debilitated, combust, dusthana, weak_shadbala, dasha or dosha:<id> (graha is optional with dosha:<id>). Each item adds kind (mantra, daan, vrat, pooja, pilgrimage, yantra, rudraksha), weekday (0 = Sunday, or null) and matched_by. Free kinds by default; include adds pooja, pilgrimage, yantra, rudraksha; category limits to one catalogue category. */
996
1180
  forGraha<T = unknown>(input?: {
@@ -1005,11 +1189,13 @@ declare class Remedies {
1005
1189
  planet: string;
1006
1190
  house: string;
1007
1191
  locale?: string;
1192
+ lang?: Locale;
1008
1193
  }, opts?: RequestOptions): Promise<T>;
1009
1194
  /** List Lal Kitab remedies (upay), optionally filtered by planet. */
1010
1195
  lalkitabList<T = unknown>(input?: {
1011
1196
  planet?: string;
1012
1197
  locale?: string;
1198
+ lang?: Locale;
1013
1199
  }, opts?: RequestOptions): Promise<T>;
1014
1200
  /** Full details of a mantra remedy by id. */
1015
1201
  mantra<T = unknown>(input: {
@@ -1025,6 +1211,7 @@ declare class Remedies {
1025
1211
  rudraksha<T = unknown>(input: {
1026
1212
  id: string;
1027
1213
  locale?: string;
1214
+ lang?: Locale;
1028
1215
  }, opts?: RequestOptions): Promise<T>;
1029
1216
  /** Get Vedic astrological remedies for a birth chart — personalised remedies based on weak planets, doshas, and challenging dashas. */
1030
1217
  vedic<T = unknown>(input: BirthInput & VedicBirthSettings & {
@@ -1040,6 +1227,7 @@ declare class Remedies {
1040
1227
  yantra<T = unknown>(input: {
1041
1228
  id: string;
1042
1229
  locale?: string;
1230
+ lang?: Locale;
1043
1231
  }, opts?: RequestOptions): Promise<T>;
1044
1232
  }
1045
1233
 
@@ -1151,11 +1339,17 @@ declare class Transit {
1151
1339
  private readonly _c;
1152
1340
  constructor(_c: ClientCore);
1153
1341
  /** Score current planetary transits against a natal chart using Ashtakavarga — shows which houses transiting planets are moving through and how many benefic points those signs have in the natal chart. */
1154
- ashtakavarga<T = unknown>(input: NatalTransitInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1342
+ ashtakavarga<T = unknown>(input: NatalTransitInput & VedicMomentSettings & {
1343
+ lang?: Locale;
1344
+ }, opts?: RequestOptions): Promise<T>;
1155
1345
  /** List the pairs of planets occupying the same sidereal sign at a moment (planetary conjunctions by sign). Takes a date, not a birth chart; defaults to today. */
1156
- doubleTransit<T = unknown>(input?: InstantInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1346
+ doubleTransit<T = unknown>(input?: InstantInput & VedicMomentSettings & {
1347
+ lang?: Locale;
1348
+ }, opts?: RequestOptions): Promise<T>;
1157
1349
  /** Current sidereal positions of all 9 grahas (defaults to now). */
1158
- positions<T = unknown>(input?: InstantInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1350
+ positions<T = unknown>(input?: InstantInput & VedicMomentSettings & {
1351
+ lang?: Locale;
1352
+ }, opts?: RequestOptions): Promise<T>;
1159
1353
  /** Saturn Sade Sati status (rising/peak/setting) relative to the birth Moon. */
1160
1354
  sadeSati<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1161
1355
  /** Sade Sati and Dhaiya windows from the natal Moon (20 credits): intervals (one per stay of Saturn in a sign, kind sade_sati with phase rising/peak/setting, dhaiya_4 kantak or dhaiya_8 ashtama, exact ingress times, retro_reentry), cycles (merged passes with phase spans) and at_from (status at from). from defaults to now, years 25 (max 60); includePast starts at birth. Every instant comes as *_local (RFC 3339 with offset) and *_jd (Julian Day, UT); fields that cannot be computed are listed in skipped. */
@@ -1168,9 +1362,13 @@ declare class Transit {
1168
1362
  /** Get the complete history and future windows of Small Panoti (Ashtama Shani) for a natal chart — all past and upcoming 2.5-year periods when Saturn transits the 8th house from natal Moon. */
1169
1363
  smallPanotiHistory<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1170
1364
  /** Compute Tara Bala for today's transiting Moon relative to a natal chart — rates the day as Janma/Sampat/Vipat/Kshema/Pratyak/Sadhana/Vadha/Mitra/Param-Mitra tara. */
1171
- tarabala<T = unknown>(input: NatalTransitInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1365
+ tarabala<T = unknown>(input: NatalTransitInput & VedicMomentSettings & {
1366
+ lang?: Locale;
1367
+ }, opts?: RequestOptions): Promise<T>;
1172
1368
  /** Check Vedha (transit obstruction) for a natal chart — certain house transits are blocked (vedha'd) by another planet transiting a specific opposing house simultaneously. */
1173
- vedha<T = unknown>(input: NatalTransitInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1369
+ vedha<T = unknown>(input: NatalTransitInput & VedicMomentSettings & {
1370
+ lang?: Locale;
1371
+ }, opts?: RequestOptions): Promise<T>;
1174
1372
  /** Every stay of one planet (sun..ketu) in a sidereal sign that overlaps [from, from + years] (20 credits), with exact ingress times, retro_reentry and retrograde_at_start. With birth (date, time, tz) each window has house_from_moon; with birth lat/lon also house_from_lagna. years: default 25 / max 60 for jupiter, saturn, rahu, ketu; 5 / 20 for sun, mercury, venus, mars; 1 / 2 for moon. Every instant comes as *_local (RFC 3339 with offset) and *_jd (Julian Day, UT); fields that cannot be computed are listed in skipped. */
1175
1373
  windows<T = unknown>(input: OptionalNatalWindowInput & VedicMomentSettings & {
1176
1374
  planet: string;
@@ -1184,18 +1382,22 @@ declare class Varshaphal {
1184
1382
  /** Varshaphal (annual solar-return) chart for a year. */
1185
1383
  chart<T = unknown>(input: BirthInput & VedicBirthSettings & {
1186
1384
  year: number;
1385
+ lang?: Locale;
1187
1386
  }, opts?: RequestOptions): Promise<T>;
1188
1387
  /** Tajika Harsha Bala for the annual chart. */
1189
1388
  harshaBala<T = unknown>(input: BirthInput & VedicBirthSettings & {
1190
1389
  year: number;
1390
+ lang?: Locale;
1191
1391
  }, opts?: RequestOptions): Promise<T>;
1192
1392
  /** Get the Varsha Lord (Varshesha, year ruler) for an annual chart, chosen by the Tajika Panchadhikari rule from the five office-bearers (Munthesh, Janmesh, Varsha Lagnesh, Trirashipati, Dina/Ratripati); the response also lists the candidates and the hora lord of the return. */
1193
1393
  lord<T = unknown>(input: BirthInput & VedicBirthSettings & {
1194
1394
  year: number;
1395
+ lang?: Locale;
1195
1396
  }, opts?: RequestOptions): Promise<T>;
1196
1397
  /** Varshaphal Mudda Dasha periods for the solar-return year. */
1197
1398
  muddaDasha<T = unknown>(input: BirthInput & VedicBirthSettings & {
1198
1399
  year: number;
1400
+ lang?: Locale;
1199
1401
  }, opts?: RequestOptions): Promise<T>;
1200
1402
  /** Get Muntha placement for a Varshaphal year — Muntha moves one sign per year from birth lagna and its house position in the annual chart is a key indicator of the year's themes. */
1201
1403
  muntha<T = unknown>(input: BirthInput & VedicBirthSettings & {
@@ -1208,6 +1410,7 @@ declare class Varshaphal {
1208
1410
  /** Get Tajika Yogas in the Varshaphal annual chart — Ikkaval, Induvara, Ithasala, Ishrafa, Nakta, Yamaya, Manau, Khallasara, Duphali-Kuttha, and other Tajika aspect-based yogas that indicate the tone of the solar-return year. */
1209
1411
  yoga<T = unknown>(input: BirthInput & VedicBirthSettings & {
1210
1412
  year: number;
1413
+ lang?: Locale;
1211
1414
  }, opts?: RequestOptions): Promise<T>;
1212
1415
  }
1213
1416