@roxyapi/ui-vue 0.29.0 → 0.31.0

package/dist/types/types.gen.d.ts

@@ -6944,7 +6944,7 @@ export type HeliacalRequest = {
 };
 export type BasicCard = {
     /**
-     * Unique card identifier in kebab-case (e.g. fool, ace-of-cups, queen-of-swords).
+     * Unique card identifier in kebab-case, with no leading article on Major Arcana (e.g. fool, star, ace-of-cups, queen-of-swords). This is the canonical form, whatever spelling was requested.
      */
     id: string;
     /**
@@ -6970,7 +6970,7 @@ export type BasicCard = {
 };
 export type Card = {
     /**
-     * Unique card identifier in kebab-case (e.g. fool, ace-of-cups, queen-of-swords).
+     * Unique card identifier in kebab-case, with no leading article on Major Arcana (e.g. fool, star, ace-of-cups, queen-of-swords). This is the canonical form, whatever spelling was requested.
      */
     id: string;
     /**
@@ -8057,7 +8057,7 @@ export type GetPlanetMeaningData = {
     body?: never;
     path: {
         /**
-         * Planet ID (lowercase, e.g., sun, moon, mercury) or display name (case-insensitive, e.g., Sun, MOON).
+         * Planet ID (lowercase, e.g., sun, moon, mercury) or display name (case-insensitive, e.g., Sun, MOON). Spaces, hyphens and underscores are interchangeable, so the two lunar nodes answer to north-node and south-node as well as to their ids north node and south node, and Black Moon Lilith answers to black-moon-lilith as well as to lilith.
          */
         id: string;
     };
@@ -9530,9 +9530,13 @@ export type CalculateSynastryResponses = {
                  */
                 degree: number;
                 /**
-                 * House this planet occupies in the person 1 chart (1-12).
+                 * House this planet occupies in the person 1 chart (1-12). This is the placement in this person OWN chart. For the house overlay a synastry reading is built on, read houseInOtherChart.
                  */
                 house: number;
+                /**
+                 * Which of person 2 houses this planet of person 1 falls into (1-12), counted on that person cusps in the same house system. This is the house OVERLAY, the half of synastry the inter-aspects do not cover: an aspect says two bodies are in relationship, an overlay says which area of the other person life this body lands in. Both people get their own overlay, so person 2 planets carry the reverse reading.
+                 */
+                houseInOtherChart: number;
                 /**
                  * True when the planet is retrograde at this moment.
                  */
@@ -9609,9 +9613,13 @@ export type CalculateSynastryResponses = {
                  */
                 degree: number;
                 /**
-                 * House this planet occupies in the person 2 chart (1-12).
+                 * House this planet occupies in the person 2 chart (1-12). This is the placement in this person OWN chart. For the house overlay a synastry reading is built on, read houseInOtherChart.
                  */
                 house: number;
+                /**
+                 * Which of person 1 houses this planet of person 2 falls into (1-12), counted on that person cusps in the same house system. This is the house OVERLAY, the half of synastry the inter-aspects do not cover: an aspect says two bodies are in relationship, an overlay says which area of the other person life this body lands in. Both people get their own overlay, so person 1 planets carry the reverse reading.
+                 */
+                houseInOtherChart: number;
                 /**
                  * True when the planet is retrograde at this moment.
                  */
@@ -10013,6 +10021,221 @@ export type CalculateAspectsResponses = {
     200: AspectsResponse;
 };
 export type CalculateAspectsResponse = CalculateAspectsResponses[keyof CalculateAspectsResponses];
+export type GetMonthlyTropicalAspectsData = {
+    body?: {
+        /**
+         * Year for the aspect calendar (1900-2100). Defaults to the current year (UTC).
+         */
+        year?: number;
+        /**
+         * Month number (1-12). Defaults to the current month (UTC).
+         */
+        month?: number;
+        /**
+         * Timezone offset from UTC in hours. Event dates and times are reported in this zone, which is what makes a published calendar read correctly for its audience. Defaults to 0 (UTC).
+         */
+        timezone?: number | string;
+        /**
+         * Lunar node convention. "mean" is the smoothed average node, which always moves retrograde; "true" is the osculating node, which tracks the real perturbed node, oscillates up to about 1.5 degrees either side of the mean on a 173-day cycle, and can briefly turn direct. Neither is more correct and they almost always fall in the same sign. Applies to the North and South Node. True is the osculating node and the default, because it is what most Western chart software reports; mean is the smoothed node preferred by several evolutionary schools, so pass "mean" to match one. Nothing else in the chart changes, and the two agree on the sign except when the node sits within about 1.8 degrees of a cusp. Defaults to "true".
+         */
+        nodeType?: 'mean' | 'true';
+    };
+    path?: never;
+    query?: {
+        /**
+         * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
+         */
+        lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
+    };
+    url: '/astrology/aspects/monthly';
+};
+export type GetMonthlyTropicalAspectsErrors = {
+    /**
+     * Validation error. `issues[]` lists every failed field.
+     */
+    400: {
+        /**
+         * First issue summary.
+         */
+        error: string;
+        code: 'validation_error';
+        /**
+         * Every validation failure. Use this to rebuild a valid request.
+         */
+        issues: Array<{
+            /**
+             * Dot-separated field path, or "(root)" for top-level.
+             */
+            path: string;
+            message: string;
+            /**
+             * Zod issue code (invalid_type, too_small, too_big, invalid_string, ...).
+             */
+            code?: string;
+            /**
+             * Expected type for invalid_type.
+             */
+            expected?: string;
+            /**
+             * Minimum bound for too_small issues.
+             */
+            minimum?: number | string;
+            /**
+             * Maximum bound for too_big issues.
+             */
+            maximum?: number | string;
+            inclusive?: boolean;
+            /**
+             * Format name for string issues (regex, email, url, uuid).
+             */
+            format?: string;
+            /**
+             * Regex pattern when format is regex.
+             */
+            pattern?: string;
+        }>;
+    };
+    /**
+     * Invalid or missing API key
+     */
+    401: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+    /**
+     * Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
+     */
+    405: {
+        error: string;
+        code: 'method_not_allowed';
+        /**
+         * Allowed HTTP methods for this path. Mirrors the Allow response header.
+         */
+        allow: Array<string>;
+        /**
+         * Link to the product page for this domain.
+         */
+        docs?: string;
+    };
+    /**
+     * Monthly rate limit exceeded
+     */
+    429: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+    /**
+     * Internal server error
+     */
+    500: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+};
+export type GetMonthlyTropicalAspectsError = GetMonthlyTropicalAspectsErrors[keyof GetMonthlyTropicalAspectsErrors];
+export type GetMonthlyTropicalAspectsResponses = {
+    /**
+     * Monthly aspect calendar calculated successfully
+     */
+    200: {
+        /**
+         * Year of the calendar. Echoes the year requested, or the current UTC year when it was omitted.
+         */
+        year: number;
+        /**
+         * Month of the calendar. Echoes the month requested, or the current UTC month when it was omitted.
+         */
+        month: number;
+        /**
+         * Timezone the event dates and times are reported in. Echoes the request.
+         */
+        timezone: number;
+        /**
+         * Every aspect event in the month, in chronological order across all body pairs.
+         */
+        events: Array<{
+            /**
+             * First body forming the aspect. Always canonical English whatever the lang parameter says, so it stays safe to compare against in code. Use planet1Localized for anything a reader sees.
+             */
+            planet1: string;
+            /**
+             * First body in the requested language. Present only when lang is supplied.
+             */
+            planet1Localized?: string;
+            /**
+             * Second body forming the aspect. Always canonical English.
+             */
+            planet2: string;
+            /**
+             * Second body in the requested language. Present only when lang is supplied.
+             */
+            planet2Localized?: string;
+            /**
+             * Aspect type, canonical English. One of conjunction (0 deg), semi-sextile (30 deg), semi-square (45 deg), sextile (60 deg), square (90 deg), trine (120 deg), sesquiquadrate (135 deg), quincunx (150 deg), opposition (180 deg).
+             */
+            aspect: string;
+            /**
+             * Aspect name in the requested language. Present only when lang is supplied.
+             */
+            aspectLocalized?: string;
+            /**
+             * Whether the aspect is harmonious, challenging or neutral. Canonical English, so a calendar can colour or filter on it directly. natureLocalized carries the reader-facing form.
+             */
+            nature: string;
+            /**
+             * Nature in the requested language. Present only when lang is supplied.
+             */
+            natureLocalized?: string;
+            /**
+             * Date the aspect is closest to exact, in the requested timezone (YYYY-MM-DD).
+             */
+            date: string;
+            /**
+             * Time the aspect is closest to exact, in the requested timezone (HH:MM).
+             */
+            time: string;
+            /**
+             * Combined timestamp of closest approach, in the requested timezone.
+             */
+            datetime: string;
+            /**
+             * Distance from exact in degrees at the reported instant. Effectively zero for an aspect that perfects inside the month, and larger only where the pair turns before reaching exact.
+             */
+            orb: number;
+            /**
+             * Actual angular separation between the two bodies in degrees at the reported instant, measured the short way round the circle.
+             */
+            separation: number;
+            /**
+             * Tropical ecliptic longitude of the first body at the reported instant.
+             */
+            planet1Longitude: number;
+            /**
+             * Tropical ecliptic longitude of the second body at the reported instant.
+             */
+            planet2Longitude: number;
+        }>;
+    };
+};
+export type GetMonthlyTropicalAspectsResponse = GetMonthlyTropicalAspectsResponses[keyof GetMonthlyTropicalAspectsResponses];
 export type DetectAspectPatternsData = {
     body?: AspectPatternsRequest;
     path?: never;
@@ -10261,6 +10484,226 @@ export type CalculateTransitsResponses = {
     200: TransitsResponse;
 };
 export type CalculateTransitsResponse = CalculateTransitsResponses[keyof CalculateTransitsResponses];
+export type GetMonthlyTropicalTransitsData = {
+    body?: {
+        /**
+         * Year for the monthly transit table (1900-2100). Defaults to the current year (UTC).
+         */
+        year?: number;
+        /**
+         * Month number (1-12). Defaults to the current month (UTC).
+         */
+        month?: number;
+        /**
+         * Timezone offset from UTC in hours. Ingress dates and times are reported in this zone, which is what makes a published calendar read correctly for its audience. Defaults to 0 (UTC).
+         */
+        timezone?: number | string;
+        /**
+         * Lunar node convention. "mean" is the smoothed average node, which always moves retrograde; "true" is the osculating node, which tracks the real perturbed node, oscillates up to about 1.5 degrees either side of the mean on a 173-day cycle, and can briefly turn direct. Neither is more correct and they almost always fall in the same sign. Applies to the North and South Node. True is the osculating node and the default, because it is what most Western chart software reports; mean is the smoothed node preferred by several evolutionary schools, so pass "mean" to match one. Nothing else in the chart changes, and the two agree on the sign except when the node sits within about 1.8 degrees of a cusp. Defaults to "true".
+         */
+        nodeType?: 'mean' | 'true';
+    };
+    path?: never;
+    query?: {
+        /**
+         * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
+         */
+        lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
+    };
+    url: '/astrology/transits/monthly';
+};
+export type GetMonthlyTropicalTransitsErrors = {
+    /**
+     * Validation error. `issues[]` lists every failed field.
+     */
+    400: {
+        /**
+         * First issue summary.
+         */
+        error: string;
+        code: 'validation_error';
+        /**
+         * Every validation failure. Use this to rebuild a valid request.
+         */
+        issues: Array<{
+            /**
+             * Dot-separated field path, or "(root)" for top-level.
+             */
+            path: string;
+            message: string;
+            /**
+             * Zod issue code (invalid_type, too_small, too_big, invalid_string, ...).
+             */
+            code?: string;
+            /**
+             * Expected type for invalid_type.
+             */
+            expected?: string;
+            /**
+             * Minimum bound for too_small issues.
+             */
+            minimum?: number | string;
+            /**
+             * Maximum bound for too_big issues.
+             */
+            maximum?: number | string;
+            inclusive?: boolean;
+            /**
+             * Format name for string issues (regex, email, url, uuid).
+             */
+            format?: string;
+            /**
+             * Regex pattern when format is regex.
+             */
+            pattern?: string;
+        }>;
+    };
+    /**
+     * Invalid or missing API key
+     */
+    401: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+    /**
+     * Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
+     */
+    405: {
+        error: string;
+        code: 'method_not_allowed';
+        /**
+         * Allowed HTTP methods for this path. Mirrors the Allow response header.
+         */
+        allow: Array<string>;
+        /**
+         * Link to the product page for this domain.
+         */
+        docs?: string;
+    };
+    /**
+     * Monthly rate limit exceeded
+     */
+    429: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+    /**
+     * Internal server error
+     */
+    500: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+};
+export type GetMonthlyTropicalTransitsError = GetMonthlyTropicalTransitsErrors[keyof GetMonthlyTropicalTransitsErrors];
+export type GetMonthlyTropicalTransitsResponses = {
+    /**
+     * Monthly transit table calculated successfully
+     */
+    200: {
+        /**
+         * Year of the table. Echoes the year requested, or the current UTC year when it was omitted.
+         */
+        year: number;
+        /**
+         * Month of the table. Echoes the month requested, or the current UTC month when it was omitted.
+         */
+        month: number;
+        /**
+         * Timezone the ingress dates and times are reported in. Echoes the request.
+         */
+        timezone: number;
+        /**
+         * Where every body stands as the month opens, so a calendar can show the run-in as well as the changes.
+         */
+        startingPositions: Array<{
+            /**
+             * Body name, canonical English.
+             */
+            planet: string;
+            /**
+             * Body name in the requested language.
+             */
+            planetLocalized?: string;
+            /**
+             * Tropical sign the body occupies at the start of the month.
+             */
+            sign: string;
+            /**
+             * Sign in the requested language.
+             */
+            signLocalized?: string;
+            /**
+             * Tropical ecliptic longitude in degrees at 00:00 UTC on the first of the month.
+             */
+            longitude: number;
+        }>;
+        /**
+         * Every sign change in the month, in chronological order across all bodies. Empty only for a month in which nothing changes sign, which cannot happen while the Moon is included.
+         */
+        transitEvents: Array<{
+            /**
+             * Body that changes sign during the month. One of the 14 Western bodies. Always canonical English whatever the lang parameter says, so it stays safe to compare against in code. Use planetLocalized for anything a reader sees.
+             */
+            planet: string;
+            /**
+             * Body name in the requested language. Present only when lang is supplied.
+             */
+            planetLocalized?: string;
+            /**
+             * Tropical sign the body leaves. Canonical English.
+             */
+            fromSign: string;
+            /**
+             * Sign left, in the requested language. Present only when lang is supplied.
+             */
+            fromSignLocalized?: string;
+            /**
+             * Tropical sign the body enters. Canonical English.
+             */
+            toSign: string;
+            /**
+             * Sign entered, in the requested language. Present only when lang is supplied.
+             */
+            toSignLocalized?: string;
+            /**
+             * Date of the ingress in the requested timezone (YYYY-MM-DD).
+             */
+            date: string;
+            /**
+             * Time of the ingress in the requested timezone (HH:MM).
+             */
+            time: string;
+            /**
+             * Combined ingress timestamp in the requested timezone.
+             */
+            datetime: string;
+            /**
+             * Whether the body was retrograde at the moment it crossed. A retrograde ingress is the body re-entering a sign it already left, which is why the same body can appear more than once in a month.
+             */
+            isRetrograde: boolean;
+        }>;
+    };
+};
+export type GetMonthlyTropicalTransitsResponse = GetMonthlyTropicalTransitsResponses[keyof GetMonthlyTropicalTransitsResponses];
 export type CalculateTransitAspectsData = {
     body?: {
         /**
@@ -10427,334 +10870,720 @@ export type CalculateTransitAspectsErrors = {
         code: string;
     };
 };
-export type CalculateTransitAspectsError = CalculateTransitAspectsErrors[keyof CalculateTransitAspectsErrors];
-export type CalculateTransitAspectsResponses = {
+export type CalculateTransitAspectsError = CalculateTransitAspectsErrors[keyof CalculateTransitAspectsErrors];
+export type CalculateTransitAspectsResponses = {
+    /**
+     * Transit aspects calculated successfully
+     */
+    200: {
+        /**
+         * Date and time of the transit calculation.
+         */
+        transitDate: string;
+        /**
+         * House system actually used for the natal cusps behind every house number in this response. Differs from the requested system only above the polar circle, where quadrant systems fall back to Whole Sign.
+         */
+        houseSystem: 'placidus' | 'whole-sign' | 'equal' | 'koch';
+        /**
+         * The twelve NATAL house cusps that every house number in this response is read against, in the house system named by houseSystem. Same shape as the natal-chart houses array, so a bi-wheel can be drawn with real house sectors from this one response instead of pairing it with a second call.
+         */
+        houses: Array<{
+            /**
+             * House number (1-12). Each house governs specific life themes in Western astrology.
+             */
+            number: number;
+            /**
+             * Ecliptic longitude of this house cusp in degrees (0-360).
+             */
+            longitude: number;
+            /**
+             * Zodiac sign on this house cusp. Colors the themes of this life area.
+             */
+            sign: string;
+            /**
+             * Degree within the zodiac sign on this cusp (0-29.999).
+             */
+            degree: number;
+            /**
+             * Zodiac sign name on this cusp 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.
+             */
+            signLocalized?: string;
+        }>;
+        /**
+         * The natal Ascendant (rising sign): the eastern horizon at birth, and the left-hand horizon a chart wheel is oriented to. Reported alongside the cusps because the two are not the same longitude in every house system: Whole Sign puts the first cusp at 0 degrees of the rising sign, which can sit most of a sign away from the Ascendant itself.
+         */
+        ascendant: {
+            /**
+             * Tropical zodiac sign on the natal Ascendant. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
+             */
+            sign: string;
+            /**
+             * Ascendant sign name 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.
+             */
+            signLocalized?: string;
+            /**
+             * Degree within the Ascendant sign (0-29.999).
+             */
+            degree: number;
+            /**
+             * Absolute ecliptic longitude of the natal Ascendant in degrees (0-360).
+             */
+            longitude: number;
+        };
+        /**
+         * Current transiting positions in the tropical zodiac, each placed in the natal house it is passing through. All 14 celestial bodies: the 10 classical planets (Sun through Pluto), the lunar nodes, Chiron, and Black Moon Lilith.
+         */
+        transitPlanets: Array<{
+            /**
+             * Body name. One of the 10 classical planets (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto), the lunar nodes (North Node, South Node), Chiron, or Black Moon Lilith (the mean lunar apogee). The nodes follow the request `nodeType`, which defaults to the true (osculating) node; pass "mean" for the smoothed node. The two differ by up to about 1.8 degrees and no other body is affected.
+             */
+            name: 'Sun' | 'Moon' | 'Mercury' | 'Venus' | 'Mars' | 'Jupiter' | 'Saturn' | 'Uranus' | 'Neptune' | 'Pluto' | 'North Node' | 'South Node' | 'Chiron' | 'Black Moon Lilith';
+            /**
+             * Tropical ecliptic longitude in degrees (0-360). Primary coordinate for zodiac sign and aspect calculations.
+             */
+            longitude: number;
+            /**
+             * Ecliptic latitude in degrees. Near zero for most planets, varies for the Moon and Pluto, and reaches up to about 5 degrees for Black Moon Lilith (projected from the inclined mean lunar orbit).
+             */
+            latitude: number;
+            /**
+             * Tropical zodiac sign this planet occupies. Determined by 30-degree divisions of ecliptic longitude.
+             */
+            sign: string;
+            /**
+             * Degree within the zodiac sign (0-29.999). Indicates how far the planet has progressed through the sign.
+             */
+            degree: number;
+            /**
+             * Natal house (1-12) this transiting body is currently passing through, read against the natal house cusps. This is the life area the transit activates, so it is driven by the natal birth time and location rather than by the transit moment.
+             */
+            house: number;
+            /**
+             * Daily motion in degrees per day. Negative values indicate retrograde motion.
+             */
+            speed: number;
+            /**
+             * Whether the planet appears to move backward from Earth perspective. Retrograde periods signal review and introspection.
+             */
+            isRetrograde: boolean;
+            /**
+             * Body name 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.
+             */
+            nameLocalized?: string;
+            /**
+             * Zodiac sign name 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.
+             */
+            signLocalized?: string;
+        }>;
+        /**
+         * Natal (birth chart) planetary positions used as the baseline for transit aspect comparison, each placed in its natal house.
+         */
+        natalPlanets: Array<{
+            /**
+             * Body name. One of the 10 classical planets (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto), the lunar nodes (North Node, South Node), Chiron, or Black Moon Lilith (the mean lunar apogee). The nodes follow the request `nodeType`, which defaults to the true (osculating) node; pass "mean" for the smoothed node. The two differ by up to about 1.8 degrees and no other body is affected.
+             */
+            name: 'Sun' | 'Moon' | 'Mercury' | 'Venus' | 'Mars' | 'Jupiter' | 'Saturn' | 'Uranus' | 'Neptune' | 'Pluto' | 'North Node' | 'South Node' | 'Chiron' | 'Black Moon Lilith';
+            /**
+             * Tropical ecliptic longitude in degrees (0-360). Primary coordinate for zodiac sign and aspect calculations.
+             */
+            longitude: number;
+            /**
+             * Ecliptic latitude in degrees. Near zero for most planets, varies for the Moon and Pluto, and reaches up to about 5 degrees for Black Moon Lilith (projected from the inclined mean lunar orbit).
+             */
+            latitude: number;
+            /**
+             * Tropical zodiac sign this planet occupies. Determined by 30-degree divisions of ecliptic longitude.
+             */
+            sign: string;
+            /**
+             * Degree within the zodiac sign (0-29.999). Indicates how far the planet has progressed through the sign.
+             */
+            degree: number;
+            /**
+             * House placement (1-12). Determined by the selected house system and birth location.
+             */
+            house: number;
+            /**
+             * Daily motion in degrees per day. Negative values indicate retrograde motion.
+             */
+            speed: number;
+            /**
+             * Whether the planet appears to move backward from Earth perspective. Retrograde periods signal review and introspection.
+             */
+            isRetrograde: boolean;
+            /**
+             * Body name 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.
+             */
+            nameLocalized?: string;
+            /**
+             * Zodiac sign name 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.
+             */
+            signLocalized?: string;
+        }>;
+        /**
+         * Transit-to-natal aspects with interpretations, strength ratings, and guidance. Each aspect represents a transiting planet forming a geometric angle to a natal planet.
+         */
+        aspects: Array<{
+            /**
+             * First planet in the aspect pair.
+             */
+            planet1: 'Sun' | 'Moon' | 'Mercury' | 'Venus' | 'Mars' | 'Jupiter' | 'Saturn' | 'Uranus' | 'Neptune' | 'Pluto' | 'North Node' | 'South Node' | 'Chiron' | 'Black Moon Lilith';
+            /**
+             * Second planet in the aspect pair.
+             */
+            planet2: 'Sun' | 'Moon' | 'Mercury' | 'Venus' | 'Mars' | 'Jupiter' | 'Saturn' | 'Uranus' | 'Neptune' | 'Pluto' | 'North Node' | 'South Node' | 'Chiron' | 'Black Moon Lilith';
+            /**
+             * Aspect type. Major: conjunction (0), opposition (180), trine (120), square (90), sextile (60). Minor: semi-sextile, quincunx, semi-square, sesquiquadrate.
+             */
+            type: 'CONJUNCTION' | 'OPPOSITION' | 'TRINE' | 'SQUARE' | 'SEXTILE' | 'SEMI_SEXTILE' | 'QUINCUNX' | 'SEMI_SQUARE' | 'SESQUIQUADRATE';
+            /**
+             * Exact angular separation that defines this aspect type in degrees.
+             */
+            angle: number;
+            /**
+             * Deviation from exact aspect in degrees. Tighter orb means stronger influence.
+             */
+            orb: number;
+            /**
+             * Whether the aspect is applying (planets moving toward exact) or separating (moving apart). Applying aspects grow stronger.
+             */
+            isApplying: boolean;
+            /**
+             * Aspect strength percentage (0-100). Based on orb tightness relative to the allowed maximum.
+             */
+            strength: number;
+            /**
+             * Aspect nature. Harmonious (trine, sextile) flows easily. Challenging (square, opposition) creates tension and growth. Neutral (conjunction) blends energies. Always English, whatever the lang parameter says: it is an identifier consumers switch and style on. Use interpretationLocalized for anything a reader sees.
+             */
+            interpretation: 'harmonious' | 'challenging' | 'neutral';
+            /**
+             * First planet name 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.
+             */
+            planet1Localized?: string;
+            /**
+             * Second planet name 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.
+             */
+            planet2Localized?: string;
+            /**
+             * Aspect type name 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.
+             */
+            typeLocalized?: string;
+            /**
+             * Rich interpretation of the transit aspect: narrative summary, timing, impact assessment, practical guidance, and keywords.
+             */
+            transitInterpretation: {
+                /**
+                 * Narrative interpretation of this transit aspect and its life impact.
+                 */
+                summary: string;
+                /**
+                 * When this transit is most active and how long its influence lasts, localized. The bucket follows the speed of the transiting body: a few hours for the Moon, a few days for the Sun, Mercury, Venus and Mars, one to two weeks for Jupiter, several weeks for Saturn, and an extended period for Uranus, Neptune and Pluto.
+                 */
+                timing: string;
+                /**
+                 * Strength and nature of this transit effect — constructive, challenging, or neutral.
+                 */
+                impact: string;
+                /**
+                 * Practical advice for working with this transit energy.
+                 */
+                guidance: string;
+                /**
+                 * Key themes activated by this transit aspect.
+                 */
+                keywords: Array<string>;
+            };
+        }>;
+        /**
+         * Statistical summary of all transit aspects. The harmonious-to-challenging ratio reveals the overall transit weather — whether the current period favors ease or demands effort.
+         */
+        summary: {
+            /**
+             * Total number of transit-to-natal aspects found.
+             */
+            total: number;
+            /**
+             * Count of harmonious aspects (trine, sextile). These transits bring ease, flow, and opportunity.
+             */
+            harmonious: number;
+            /**
+             * Count of challenging aspects (square, opposition, semi-square, sesquiquadrate). These transits bring tension, growth pressure, and action.
+             */
+            challenging: number;
+            /**
+             * Count of neutral aspects (conjunction, minor aspects). Conjunctions blend energies — the outcome depends on the planets involved.
+             */
+            neutral: number;
+            /**
+             * The tightest aspect by orb. This is the most potent transit currently active — the one most likely to be felt.
+             */
+            strongest: {
+                /**
+                 * First planet in the aspect pair.
+                 */
+                planet1: 'Sun' | 'Moon' | 'Mercury' | 'Venus' | 'Mars' | 'Jupiter' | 'Saturn' | 'Uranus' | 'Neptune' | 'Pluto' | 'North Node' | 'South Node' | 'Chiron' | 'Black Moon Lilith';
+                /**
+                 * Second planet in the aspect pair.
+                 */
+                planet2: 'Sun' | 'Moon' | 'Mercury' | 'Venus' | 'Mars' | 'Jupiter' | 'Saturn' | 'Uranus' | 'Neptune' | 'Pluto' | 'North Node' | 'South Node' | 'Chiron' | 'Black Moon Lilith';
+                /**
+                 * Aspect type. Major: conjunction (0), opposition (180), trine (120), square (90), sextile (60). Minor: semi-sextile, quincunx, semi-square, sesquiquadrate.
+                 */
+                type: 'CONJUNCTION' | 'OPPOSITION' | 'TRINE' | 'SQUARE' | 'SEXTILE' | 'SEMI_SEXTILE' | 'QUINCUNX' | 'SEMI_SQUARE' | 'SESQUIQUADRATE';
+                /**
+                 * Exact angular separation that defines this aspect type in degrees.
+                 */
+                angle: number;
+                /**
+                 * Deviation from exact aspect in degrees. Tighter orb means stronger influence.
+                 */
+                orb: number;
+                /**
+                 * Whether the aspect is applying (planets moving toward exact) or separating (moving apart). Applying aspects grow stronger.
+                 */
+                isApplying: boolean;
+                /**
+                 * Aspect strength percentage (0-100). Based on orb tightness relative to the allowed maximum.
+                 */
+                strength: number;
+                /**
+                 * Aspect nature. Harmonious (trine, sextile) flows easily. Challenging (square, opposition) creates tension and growth. Neutral (conjunction) blends energies. Always English, whatever the lang parameter says: it is an identifier consumers switch and style on. Use interpretationLocalized for anything a reader sees.
+                 */
+                interpretation: 'harmonious' | 'challenging' | 'neutral';
+                /**
+                 * First planet name 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.
+                 */
+                planet1Localized?: string;
+                /**
+                 * Second planet name 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.
+                 */
+                planet2Localized?: string;
+                /**
+                 * Aspect type name 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.
+                 */
+                typeLocalized?: string;
+                /**
+                 * Rich interpretation of the transit aspect: narrative summary, timing, impact assessment, practical guidance, and keywords.
+                 */
+                transitInterpretation: {
+                    /**
+                     * Narrative interpretation of this transit aspect and its life impact.
+                     */
+                    summary: string;
+                    /**
+                     * When this transit is most active and how long its influence lasts, localized. The bucket follows the speed of the transiting body: a few hours for the Moon, a few days for the Sun, Mercury, Venus and Mars, one to two weeks for Jupiter, several weeks for Saturn, and an extended period for Uranus, Neptune and Pluto.
+                     */
+                    timing: string;
+                    /**
+                     * Strength and nature of this transit effect — constructive, challenging, or neutral.
+                     */
+                    impact: string;
+                    /**
+                     * Practical advice for working with this transit energy.
+                     */
+                    guidance: string;
+                    /**
+                     * Key themes activated by this transit aspect.
+                     */
+                    keywords: Array<string>;
+                };
+            } | null;
+            /**
+             * Transit aspect counts grouped by aspect type (conjunction, trine, square, opposition, sextile, etc.). Useful for quickly assessing the transit weather.
+             */
+            byType: {
+                [key: string]: number;
+            };
+        };
+    };
+};
+export type CalculateTransitAspectsResponse = CalculateTransitAspectsResponses[keyof CalculateTransitAspectsResponses];
+export type GetMonthlyDeclinationParallelsData = {
+    body?: {
+        /**
+         * Year for the declination calendar (1900-2100). Defaults to the current year (UTC).
+         */
+        year?: number;
+        /**
+         * Month number (1-12). Defaults to the current month (UTC).
+         */
+        month?: number;
+        /**
+         * Timezone offset from UTC in hours. Event dates and times are reported in this zone, which is what makes a published calendar read correctly for its audience. Defaults to 0 (UTC).
+         */
+        timezone?: number | string;
+        /**
+         * How far from exact still counts, in degrees. The traditional orb for a declination contact is tighter than for a zodiacal aspect because declination changes slowly. Defaults to 1.5.
+         */
+        orb?: number;
+        /**
+         * Lunar node convention. "mean" is the smoothed average node, which always moves retrograde; "true" is the osculating node, which tracks the real perturbed node, oscillates up to about 1.5 degrees either side of the mean on a 173-day cycle, and can briefly turn direct. Neither is more correct and they almost always fall in the same sign. Applies to the North and South Node. True is the osculating node and the default, because it is what most Western chart software reports; mean is the smoothed node preferred by several evolutionary schools, so pass "mean" to match one. Nothing else in the chart changes, and the two agree on the sign except when the node sits within about 1.8 degrees of a cusp. Defaults to "true".
+         */
+        nodeType?: 'mean' | 'true';
+    };
+    path?: never;
+    query?: {
+        /**
+         * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
+         */
+        lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
+    };
+    url: '/astrology/parallels/monthly';
+};
+export type GetMonthlyDeclinationParallelsErrors = {
+    /**
+     * Validation error. `issues[]` lists every failed field.
+     */
+    400: {
+        /**
+         * First issue summary.
+         */
+        error: string;
+        code: 'validation_error';
+        /**
+         * Every validation failure. Use this to rebuild a valid request.
+         */
+        issues: Array<{
+            /**
+             * Dot-separated field path, or "(root)" for top-level.
+             */
+            path: string;
+            message: string;
+            /**
+             * Zod issue code (invalid_type, too_small, too_big, invalid_string, ...).
+             */
+            code?: string;
+            /**
+             * Expected type for invalid_type.
+             */
+            expected?: string;
+            /**
+             * Minimum bound for too_small issues.
+             */
+            minimum?: number | string;
+            /**
+             * Maximum bound for too_big issues.
+             */
+            maximum?: number | string;
+            inclusive?: boolean;
+            /**
+             * Format name for string issues (regex, email, url, uuid).
+             */
+            format?: string;
+            /**
+             * Regex pattern when format is regex.
+             */
+            pattern?: string;
+        }>;
+    };
+    /**
+     * Invalid or missing API key
+     */
+    401: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+    /**
+     * Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
+     */
+    405: {
+        error: string;
+        code: 'method_not_allowed';
+        /**
+         * Allowed HTTP methods for this path. Mirrors the Allow response header.
+         */
+        allow: Array<string>;
+        /**
+         * Link to the product page for this domain.
+         */
+        docs?: string;
+    };
+    /**
+     * Monthly rate limit exceeded
+     */
+    429: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+    /**
+     * Internal server error
+     */
+    500: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+};
+export type GetMonthlyDeclinationParallelsError = GetMonthlyDeclinationParallelsErrors[keyof GetMonthlyDeclinationParallelsErrors];
+export type GetMonthlyDeclinationParallelsResponses = {
+    /**
+     * Monthly declination calendar calculated successfully
+     */
+    200: {
+        /**
+         * Year of the calendar. Echoes the year requested, or the current UTC year when it was omitted.
+         */
+        year: number;
+        /**
+         * Month of the calendar. Echoes the month requested, or the current UTC month when it was omitted.
+         */
+        month: number;
+        /**
+         * Timezone the event dates and times are reported in. Echoes the request.
+         */
+        timezone: number;
+        /**
+         * Orb in degrees that was applied. Echoes the request.
+         */
+        orb: number;
+        /**
+         * Every declination contact in the month, in chronological order across all body pairs.
+         */
+        events: Array<{
+            /**
+             * First body in the contact. Always canonical English whatever the lang parameter says, so it stays safe to compare against in code. Use planet1Localized for anything a reader sees.
+             */
+            planet1: string;
+            /**
+             * First body in the requested language. Present only when lang is supplied.
+             */
+            planet1Localized?: string;
+            /**
+             * Second body in the contact. Always canonical English.
+             */
+            planet2: string;
+            /**
+             * Second body in the requested language. Present only when lang is supplied.
+             */
+            planet2Localized?: string;
+            /**
+             * parallel means both bodies stand at the same declination, the same distance north or south of the celestial equator, and reads much like a conjunction. contraparallel means equal and opposite declinations, one as far north as the other is south, and reads much like an opposition. Neither depends on how far apart the two bodies are along the zodiac, which is what makes them worth tracking alongside ordinary aspects.
+             */
+            type: 'parallel' | 'contraparallel';
+            /**
+             * Date the contact is closest to exact, in the requested timezone (YYYY-MM-DD).
+             */
+            date: string;
+            /**
+             * Time the contact is closest to exact, in the requested timezone (HH:MM).
+             */
+            time: string;
+            /**
+             * Combined timestamp of closest approach, in the requested timezone.
+             */
+            datetime: string;
+            /**
+             * Distance from exact in degrees at the reported instant. Effectively zero for a contact that perfects inside the month, and larger only where the pair turns before reaching exact.
+             */
+            orb: number;
+            /**
+             * Geocentric declination of the first body at the reported instant, in degrees. Positive is north of the celestial equator, negative south.
+             */
+            declination1: number;
+            /**
+             * Geocentric declination of the second body at the reported instant, in degrees.
+             */
+            declination2: number;
+        }>;
+    };
+};
+export type GetMonthlyDeclinationParallelsResponse = GetMonthlyDeclinationParallelsResponses[keyof GetMonthlyDeclinationParallelsResponses];
+export type GetPlanetaryNodePassagesData = {
+    body?: {
+        /**
+         * Year to scan for node passages (1900-2100).
+         */
+        year: number;
+        /**
+         * Timezone offset from UTC in hours. Crossing dates and times are reported in this zone. Defaults to 0 (UTC).
+         */
+        timezone?: number | string;
+    };
+    path?: never;
+    query?: {
+        /**
+         * Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English.
+         */
+        lang?: 'en' | 'tr' | 'de' | 'es' | 'hi' | 'pt' | 'fr' | 'ru';
+    };
+    url: '/astrology/ecliptic-crossings';
+};
+export type GetPlanetaryNodePassagesErrors = {
+    /**
+     * Validation error. `issues[]` lists every failed field.
+     */
+    400: {
+        /**
+         * First issue summary.
+         */
+        error: string;
+        code: 'validation_error';
+        /**
+         * Every validation failure. Use this to rebuild a valid request.
+         */
+        issues: Array<{
+            /**
+             * Dot-separated field path, or "(root)" for top-level.
+             */
+            path: string;
+            message: string;
+            /**
+             * Zod issue code (invalid_type, too_small, too_big, invalid_string, ...).
+             */
+            code?: string;
+            /**
+             * Expected type for invalid_type.
+             */
+            expected?: string;
+            /**
+             * Minimum bound for too_small issues.
+             */
+            minimum?: number | string;
+            /**
+             * Maximum bound for too_big issues.
+             */
+            maximum?: number | string;
+            inclusive?: boolean;
+            /**
+             * Format name for string issues (regex, email, url, uuid).
+             */
+            format?: string;
+            /**
+             * Regex pattern when format is regex.
+             */
+            pattern?: string;
+        }>;
+    };
+    /**
+     * Invalid or missing API key
+     */
+    401: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+    /**
+     * Method not allowed. The path exists but only responds to the methods listed in `allow[]` and the `Allow` response header.
+     */
+    405: {
+        error: string;
+        code: 'method_not_allowed';
+        /**
+         * Allowed HTTP methods for this path. Mirrors the Allow response header.
+         */
+        allow: Array<string>;
+        /**
+         * Link to the product page for this domain.
+         */
+        docs?: string;
+    };
+    /**
+     * Monthly rate limit exceeded
+     */
+    429: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+    /**
+     * Internal server error
+     */
+    500: {
+        /**
+         * Human-readable error message. May change wording.
+         */
+        error: string;
+        /**
+         * Machine-readable error code. Stable identifier.
+         */
+        code: string;
+    };
+};
+export type GetPlanetaryNodePassagesError = GetPlanetaryNodePassagesErrors[keyof GetPlanetaryNodePassagesErrors];
+export type GetPlanetaryNodePassagesResponses = {
     /**
-     * Transit aspects calculated successfully
+     * Node passages calculated successfully
      */
     200: {
         /**
-         * Date and time of the transit calculation.
-         */
-        transitDate: string;
-        /**
-         * House system actually used for the natal cusps behind every house number in this response. Differs from the requested system only above the polar circle, where quadrant systems fall back to Whole Sign.
-         */
-        houseSystem: 'placidus' | 'whole-sign' | 'equal' | 'koch';
-        /**
-         * The twelve NATAL house cusps that every house number in this response is read against, in the house system named by houseSystem. Same shape as the natal-chart houses array, so a bi-wheel can be drawn with real house sectors from this one response instead of pairing it with a second call.
+         * Year that was scanned. Echoes the request.
          */
-        houses: Array<{
-            /**
-             * House number (1-12). Each house governs specific life themes in Western astrology.
-             */
-            number: number;
-            /**
-             * Ecliptic longitude of this house cusp in degrees (0-360).
-             */
-            longitude: number;
-            /**
-             * Zodiac sign on this house cusp. Colors the themes of this life area.
-             */
-            sign: string;
-            /**
-             * Degree within the zodiac sign on this cusp (0-29.999).
-             */
-            degree: number;
-            /**
-             * Zodiac sign name on this cusp 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.
-             */
-            signLocalized?: string;
-        }>;
+        year: number;
         /**
-         * The natal Ascendant (rising sign): the eastern horizon at birth, and the left-hand horizon a chart wheel is oriented to. Reported alongside the cusps because the two are not the same longitude in every house system: Whole Sign puts the first cusp at 0 degrees of the rising sign, which can sit most of a sign away from the Ascendant itself.
+         * Timezone the dates and times are reported in. Echoes the request.
          */
-        ascendant: {
-            /**
-             * Tropical zodiac sign on the natal Ascendant. Always English, whatever the lang parameter says. Use signLocalized for anything a reader sees.
-             */
-            sign: string;
-            /**
-             * Ascendant sign name 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.
-             */
-            signLocalized?: string;
-            /**
-             * Degree within the Ascendant sign (0-29.999).
-             */
-            degree: number;
-            /**
-             * Absolute ecliptic longitude of the natal Ascendant in degrees (0-360).
-             */
-            longitude: number;
-        };
+        timezone: number;
         /**
-         * Current transiting positions in the tropical zodiac, each placed in the natal house it is passing through. All 14 celestial bodies: the 10 classical planets (Sun through Pluto), the lunar nodes, Chiron, and Black Moon Lilith.
+         * Every node passage in the year, in chronological order across all bodies. The fast bodies dominate: a slow body can go years or decades between node passages, so an absent planet means it did not cross that year rather than that it was not checked.
          */
-        transitPlanets: Array<{
-            /**
-             * Body name. One of the 10 classical planets (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto), the lunar nodes (North Node, South Node), Chiron, or Black Moon Lilith (the mean lunar apogee). The nodes follow the request `nodeType`, which defaults to the true (osculating) node; pass "mean" for the smoothed node. The two differ by up to about 1.8 degrees and no other body is affected.
-             */
-            name: 'Sun' | 'Moon' | 'Mercury' | 'Venus' | 'Mars' | 'Jupiter' | 'Saturn' | 'Uranus' | 'Neptune' | 'Pluto' | 'North Node' | 'South Node' | 'Chiron' | 'Black Moon Lilith';
-            /**
-             * Tropical ecliptic longitude in degrees (0-360). Primary coordinate for zodiac sign and aspect calculations.
-             */
-            longitude: number;
-            /**
-             * Ecliptic latitude in degrees. Near zero for most planets, varies for the Moon and Pluto, and reaches up to about 5 degrees for Black Moon Lilith (projected from the inclined mean lunar orbit).
-             */
-            latitude: number;
+        events: Array<{
             /**
-             * Tropical zodiac sign this planet occupies. Determined by 30-degree divisions of ecliptic longitude.
+             * Body making the crossing. Always canonical English whatever the lang parameter says, so it stays safe to compare against in code. Use planetLocalized for anything a reader sees.
              */
-            sign: string;
-            /**
-             * Degree within the zodiac sign (0-29.999). Indicates how far the planet has progressed through the sign.
-             */
-            degree: number;
-            /**
-             * Natal house (1-12) this transiting body is currently passing through, read against the natal house cusps. This is the life area the transit activates, so it is driven by the natal birth time and location rather than by the transit moment.
-             */
-            house: number;
+            planet: string;
             /**
-             * Daily motion in degrees per day. Negative values indicate retrograde motion.
+             * Body name in the requested language. Present only when lang is supplied.
              */
-            speed: number;
+            planetLocalized?: string;
             /**
-             * Whether the planet appears to move backward from Earth perspective. Retrograde periods signal review and introspection.
+             * ascending is the crossing from south of the ecliptic to north, at the body north node. descending is the reverse, at its south node.
              */
-            isRetrograde: boolean;
+            direction: 'ascending' | 'descending';
             /**
-             * Body name 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.
+             * Date of the crossing in the requested timezone (YYYY-MM-DD).
              */
-            nameLocalized?: string;
+            date: string;
             /**
-             * Zodiac sign name 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.
+             * Time of the crossing in the requested timezone (HH:MM).
              */
-            signLocalized?: string;
-        }>;
-        /**
-         * Natal (birth chart) planetary positions used as the baseline for transit aspect comparison, each placed in its natal house.
-         */
-        natalPlanets: Array<{
+            time: string;
             /**
-             * Body name. One of the 10 classical planets (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto), the lunar nodes (North Node, South Node), Chiron, or Black Moon Lilith (the mean lunar apogee). The nodes follow the request `nodeType`, which defaults to the true (osculating) node; pass "mean" for the smoothed node. The two differ by up to about 1.8 degrees and no other body is affected.
+             * Combined crossing timestamp in the requested timezone.
              */
-            name: 'Sun' | 'Moon' | 'Mercury' | 'Venus' | 'Mars' | 'Jupiter' | 'Saturn' | 'Uranus' | 'Neptune' | 'Pluto' | 'North Node' | 'South Node' | 'Chiron' | 'Black Moon Lilith';
+            datetime: string;
             /**
-             * Tropical ecliptic longitude in degrees (0-360). Primary coordinate for zodiac sign and aspect calculations.
+             * Tropical ecliptic longitude of the body at the crossing, in degrees. This is the only value in the response that depends on the zodiac frame.
              */
             longitude: number;
             /**
-             * Ecliptic latitude in degrees. Near zero for most planets, varies for the Moon and Pluto, and reaches up to about 5 degrees for Black Moon Lilith (projected from the inclined mean lunar orbit).
-             */
-            latitude: number;
-            /**
-             * Tropical zodiac sign this planet occupies. Determined by 30-degree divisions of ecliptic longitude.
+             * Tropical sign the body occupies at the crossing. Canonical English.
              */
             sign: string;
             /**
-             * Degree within the zodiac sign (0-29.999). Indicates how far the planet has progressed through the sign.
-             */
-            degree: number;
-            /**
-             * House placement (1-12). Determined by the selected house system and birth location.
-             */
-            house: number;
-            /**
-             * Daily motion in degrees per day. Negative values indicate retrograde motion.
-             */
-            speed: number;
-            /**
-             * Whether the planet appears to move backward from Earth perspective. Retrograde periods signal review and introspection.
-             */
-            isRetrograde: boolean;
-            /**
-             * Body name 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.
-             */
-            nameLocalized?: string;
-            /**
-             * Zodiac sign name 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.
+             * Sign in the requested language. Present only when lang is supplied.
              */
             signLocalized?: string;
         }>;
-        /**
-         * Transit-to-natal aspects with interpretations, strength ratings, and guidance. Each aspect represents a transiting planet forming a geometric angle to a natal planet.
-         */
-        aspects: Array<{
-            /**
-             * First planet in the aspect pair.
-             */
-            planet1: 'Sun' | 'Moon' | 'Mercury' | 'Venus' | 'Mars' | 'Jupiter' | 'Saturn' | 'Uranus' | 'Neptune' | 'Pluto' | 'North Node' | 'South Node' | 'Chiron' | 'Black Moon Lilith';
-            /**
-             * Second planet in the aspect pair.
-             */
-            planet2: 'Sun' | 'Moon' | 'Mercury' | 'Venus' | 'Mars' | 'Jupiter' | 'Saturn' | 'Uranus' | 'Neptune' | 'Pluto' | 'North Node' | 'South Node' | 'Chiron' | 'Black Moon Lilith';
-            /**
-             * Aspect type. Major: conjunction (0), opposition (180), trine (120), square (90), sextile (60). Minor: semi-sextile, quincunx, semi-square, sesquiquadrate.
-             */
-            type: 'CONJUNCTION' | 'OPPOSITION' | 'TRINE' | 'SQUARE' | 'SEXTILE' | 'SEMI_SEXTILE' | 'QUINCUNX' | 'SEMI_SQUARE' | 'SESQUIQUADRATE';
-            /**
-             * Exact angular separation that defines this aspect type in degrees.
-             */
-            angle: number;
-            /**
-             * Deviation from exact aspect in degrees. Tighter orb means stronger influence.
-             */
-            orb: number;
-            /**
-             * Whether the aspect is applying (planets moving toward exact) or separating (moving apart). Applying aspects grow stronger.
-             */
-            isApplying: boolean;
-            /**
-             * Aspect strength percentage (0-100). Based on orb tightness relative to the allowed maximum.
-             */
-            strength: number;
-            /**
-             * Aspect nature. Harmonious (trine, sextile) flows easily. Challenging (square, opposition) creates tension and growth. Neutral (conjunction) blends energies. Always English, whatever the lang parameter says: it is an identifier consumers switch and style on. Use interpretationLocalized for anything a reader sees.
-             */
-            interpretation: 'harmonious' | 'challenging' | 'neutral';
-            /**
-             * First planet name 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.
-             */
-            planet1Localized?: string;
-            /**
-             * Second planet name 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.
-             */
-            planet2Localized?: string;
-            /**
-             * Aspect type name 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.
-             */
-            typeLocalized?: string;
-            /**
-             * Rich interpretation of the transit aspect: narrative summary, timing, impact assessment, practical guidance, and keywords.
-             */
-            transitInterpretation: {
-                /**
-                 * Narrative interpretation of this transit aspect and its life impact.
-                 */
-                summary: string;
-                /**
-                 * When this transit is most active and how long its influence lasts, localized. The bucket follows the speed of the transiting body: a few hours for the Moon, a few days for the Sun, Mercury, Venus and Mars, one to two weeks for Jupiter, several weeks for Saturn, and an extended period for Uranus, Neptune and Pluto.
-                 */
-                timing: string;
-                /**
-                 * Strength and nature of this transit effect — constructive, challenging, or neutral.
-                 */
-                impact: string;
-                /**
-                 * Practical advice for working with this transit energy.
-                 */
-                guidance: string;
-                /**
-                 * Key themes activated by this transit aspect.
-                 */
-                keywords: Array<string>;
-            };
-        }>;
-        /**
-         * Statistical summary of all transit aspects. The harmonious-to-challenging ratio reveals the overall transit weather — whether the current period favors ease or demands effort.
-         */
-        summary: {
-            /**
-             * Total number of transit-to-natal aspects found.
-             */
-            total: number;
-            /**
-             * Count of harmonious aspects (trine, sextile). These transits bring ease, flow, and opportunity.
-             */
-            harmonious: number;
-            /**
-             * Count of challenging aspects (square, opposition, semi-square, sesquiquadrate). These transits bring tension, growth pressure, and action.
-             */
-            challenging: number;
-            /**
-             * Count of neutral aspects (conjunction, minor aspects). Conjunctions blend energies — the outcome depends on the planets involved.
-             */
-            neutral: number;
-            /**
-             * The tightest aspect by orb. This is the most potent transit currently active — the one most likely to be felt.
-             */
-            strongest: {
-                /**
-                 * First planet in the aspect pair.
-                 */
-                planet1: 'Sun' | 'Moon' | 'Mercury' | 'Venus' | 'Mars' | 'Jupiter' | 'Saturn' | 'Uranus' | 'Neptune' | 'Pluto' | 'North Node' | 'South Node' | 'Chiron' | 'Black Moon Lilith';
-                /**
-                 * Second planet in the aspect pair.
-                 */
-                planet2: 'Sun' | 'Moon' | 'Mercury' | 'Venus' | 'Mars' | 'Jupiter' | 'Saturn' | 'Uranus' | 'Neptune' | 'Pluto' | 'North Node' | 'South Node' | 'Chiron' | 'Black Moon Lilith';
-                /**
-                 * Aspect type. Major: conjunction (0), opposition (180), trine (120), square (90), sextile (60). Minor: semi-sextile, quincunx, semi-square, sesquiquadrate.
-                 */
-                type: 'CONJUNCTION' | 'OPPOSITION' | 'TRINE' | 'SQUARE' | 'SEXTILE' | 'SEMI_SEXTILE' | 'QUINCUNX' | 'SEMI_SQUARE' | 'SESQUIQUADRATE';
-                /**
-                 * Exact angular separation that defines this aspect type in degrees.
-                 */
-                angle: number;
-                /**
-                 * Deviation from exact aspect in degrees. Tighter orb means stronger influence.
-                 */
-                orb: number;
-                /**
-                 * Whether the aspect is applying (planets moving toward exact) or separating (moving apart). Applying aspects grow stronger.
-                 */
-                isApplying: boolean;
-                /**
-                 * Aspect strength percentage (0-100). Based on orb tightness relative to the allowed maximum.
-                 */
-                strength: number;
-                /**
-                 * Aspect nature. Harmonious (trine, sextile) flows easily. Challenging (square, opposition) creates tension and growth. Neutral (conjunction) blends energies. Always English, whatever the lang parameter says: it is an identifier consumers switch and style on. Use interpretationLocalized for anything a reader sees.
-                 */
-                interpretation: 'harmonious' | 'challenging' | 'neutral';
-                /**
-                 * First planet name 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.
-                 */
-                planet1Localized?: string;
-                /**
-                 * Second planet name 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.
-                 */
-                planet2Localized?: string;
-                /**
-                 * Aspect type name 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.
-                 */
-                typeLocalized?: string;
-                /**
-                 * Rich interpretation of the transit aspect: narrative summary, timing, impact assessment, practical guidance, and keywords.
-                 */
-                transitInterpretation: {
-                    /**
-                     * Narrative interpretation of this transit aspect and its life impact.
-                     */
-                    summary: string;
-                    /**
-                     * When this transit is most active and how long its influence lasts, localized. The bucket follows the speed of the transiting body: a few hours for the Moon, a few days for the Sun, Mercury, Venus and Mars, one to two weeks for Jupiter, several weeks for Saturn, and an extended period for Uranus, Neptune and Pluto.
-                     */
-                    timing: string;
-                    /**
-                     * Strength and nature of this transit effect — constructive, challenging, or neutral.
-                     */
-                    impact: string;
-                    /**
-                     * Practical advice for working with this transit energy.
-                     */
-                    guidance: string;
-                    /**
-                     * Key themes activated by this transit aspect.
-                     */
-                    keywords: Array<string>;
-                };
-            } | null;
-            /**
-             * Transit aspect counts grouped by aspect type (conjunction, trine, square, opposition, sextile, etc.). Useful for quickly assessing the transit weather.
-             */
-            byType: {
-                [key: string]: number;
-            };
-        };
     };
 };
-export type CalculateTransitAspectsResponse = CalculateTransitAspectsResponses[keyof CalculateTransitAspectsResponses];
+export type GetPlanetaryNodePassagesResponse = GetPlanetaryNodePassagesResponses[keyof GetPlanetaryNodePassagesResponses];
 export type GenerateSolarReturnData = {
     body?: {
         /**
@@ -18820,11 +19649,11 @@ export type GetVedicDailyReadingResponses = {
          */
         areas: {
             /**
-             * The finance area: the positive house group 2, 5, 11 netted against the negative group 6, 8, 12, read off the lords of the running dasha, bhukti and antara, because that is the KP rule for when a matter fructifies, plus the natal basis the day is read against. ALWAYS AN OBJECT. Above latitude 66.56 the six netted members are null, because the Placidus cusps behind the significators have no solution there, while natal is still populated because it is a property of the birth chart and needs no cusps; the reading also still carries its gochara, panchanga and dasha and names the omission in degraded. The two house groups are Krishnamurti Paddhati practice, but the NET is a KP practitioner convention rather than a classical operation: the KP sources that carry these groups use them as a promise test and an avoidance test, never as arithmetic. The groups also vary by author, and the 6th house is the live disagreement, since some KP authors place it on the POSITIVE side as service income and salary, the exact opposite of the assignment used here. This is a six house net and it is NOT the focus=finance lens, which re-reads all twelve bhavas in money vocabulary and moves no number. The two are orthogonal and both ship.
+             * The finance area: the positive house group 2, 5, 11 netted against the negative group 6, 8, 12, read off the lords of the running dasha, bhukti and antara, because that is the KP rule for when a matter fructifies, plus the natal basis the day is read against. ALWAYS AN OBJECT. Above latitude 66.56 the six netted members are null, because the Placidus cusps behind the significators have no solution there, while natal is still populated because it is a property of the birth chart and needs no cusps; the reading also still carries its gochara, panchanga and dasha and names the omission in degraded. The two house groups are Krishnamurti Paddhati practice, but the NET is a KP practitioner convention rather than a classical operation: the KP sources that carry these groups use them as a promise test and an avoidance test, never as arithmetic. The groups also vary by author, and TWO houses are live disagreements rather than one. The 6th: some KP authors place it on the POSITIVE side as service income and salary, the exact opposite of the assignment used here. The 5th: it is named as a speculative GAIN house in the same KP sources that elsewhere call it a negation house, reading it as the 12th from the 6th and therefore loss of earning capacity, and both readings appear in one publication. The 1st is treated as a negation house by some authors on the same logic, as the 12th from the 2nd, and is not on either side here. This is a six house net and it is NOT the focus=finance lens, which re-reads all twelve bhavas in money vocabulary and moves no number. The two are orthogonal and both ship.
              */
             finance: {
                 /**
-                 * Share of the running lords six-house connections that land on the positive group, 0 to 100, rounded. A COUNT, so positive and negative below reproduce it in one division: round(positive / (positive + negative) * 100). Zero when the running lords reach none of the six houses, which is an ABSENCE of connection rather than a negative verdict. Null above latitude 66.56, where the Placidus cusps the KP significators are read from have no solution: the question does not apply there rather than the answer being no, so never render it as zero or as a weak verdict. The natal block beside it is unaffected and still ships, and degraded names areas.finance.score. The two house groups are Krishnamurti Paddhati practice, but the NET is a KP practitioner convention rather than a classical operation: the KP sources that carry these groups use them as a promise test and an avoidance test, never as arithmetic. The groups also vary by author, and the 6th house is the live disagreement, since some KP authors place it on the POSITIVE side as service income and salary, the exact opposite of the assignment used here. This is a six house net and it is NOT the focus=finance lens, which re-reads all twelve bhavas in money vocabulary and moves no number. The two are orthogonal and both ship.
+                 * Share of the running lords six-house connections that land on the positive group, 0 to 100, rounded. A COUNT, so positive and negative below reproduce it in one division: round(positive / (positive + negative) * 100). Zero when the running lords reach none of the six houses, which is an ABSENCE of connection rather than a negative verdict. Null above latitude 66.56, where the Placidus cusps the KP significators are read from have no solution: the question does not apply there rather than the answer being no, so never render it as zero or as a weak verdict. The natal block beside it is unaffected and still ships, and degraded names areas.finance.score. The two house groups are Krishnamurti Paddhati practice, but the NET is a KP practitioner convention rather than a classical operation: the KP sources that carry these groups use them as a promise test and an avoidance test, never as arithmetic. The groups also vary by author, and TWO houses are live disagreements rather than one. The 6th: some KP authors place it on the POSITIVE side as service income and salary, the exact opposite of the assignment used here. The 5th: it is named as a speculative GAIN house in the same KP sources that elsewhere call it a negation house, reading it as the 12th from the 6th and therefore loss of earning capacity, and both readings appear in one publication. The 1st is treated as a negation house by some authors on the same logic, as the 12th from the 2nd, and is not on either side here. This is a six house net and it is NOT the focus=finance lens, which re-reads all twelve bhavas in money vocabulary and moves no number. The two are orthogonal and both ship.
                  */
                 score: number | null;
                 /**
@@ -35053,7 +35882,7 @@ export type GetCardData = {
     body?: never;
     path: {
         /**
-         * Unique card identifier in kebab-case. Major arcana: "fool", "magician", "death", etc. Minor arcana: "ace-of-cups", "seven-of-wands", "queen-of-swords", "king-of-pentacles", etc.
+         * Card identifier. Major arcana: "fool", "magician", "death". Minor arcana: "ace-of-cups", "seven-of-wands", "queen-of-swords", "king-of-pentacles". Casing and separators are flexible, so "Fool" and "ACE_OF_CUPS" both resolve, and a leading definite article is optional, so "the-star" resolves to "star". The canonical form, and the one every response echoes, is kebab-case with no article.
          */
         id: string;
     };
@@ -36638,9 +37467,9 @@ export type GetReadingResponses = {
                  */
                 rawValue: number;
                 /**
-                 * Current phase of the cycle. One of: peak, high, rising, critical_ascending, critical_descending, falling, low, trough.
+                 * Current phase of the cycle. One of: peak, high, rising, critical_ascending, critical_descending, falling, low, trough. Canonical English whatever the lang parameter says, so it stays safe to compare against in code; phaseLabel carries the reader-facing form and IS translated.
                  */
-                phase: string;
+                phase: 'peak' | 'high' | 'rising' | 'critical_ascending' | 'critical_descending' | 'falling' | 'low' | 'trough';
                 /**
                  * Human-readable phase name for display in UIs, dashboards, and reports.
                  */
@@ -36662,9 +37491,9 @@ export type GetReadingResponses = {
                  */
                 daysUntilCritical: number;
                 /**
-                 * Short-term direction of the cycle. One of: rising, falling, peaking, bottoming.
+                 * Short-term direction of the cycle, which is its SLOPE rather than its band, so it moves independently of phase. One of: rising, falling, peaking, bottoming. Canonical English, like phase.
                  */
-                trend: string;
+                trend: 'rising' | 'falling' | 'peaking' | 'bottoming';
                 /**
                  * Editorial 2-3 sentence reading specific to this cycle at its current phase position.
                  */
@@ -36676,9 +37505,9 @@ export type GetReadingResponses = {
          */
         energyRating: number;
         /**
-         * Summary phase label. One of: high_energy, mixed, recovery, critical.
+         * Summary phase across every cycle for the day. One of: high_energy, mixed, recovery, critical.
          */
-        overallPhase: string;
+        overallPhase: 'high_energy' | 'mixed' | 'recovery' | 'critical';
         /**
          * Editorial 3-5 sentence reading combining all cycle states into a coherent daily assessment.
          */
@@ -36694,15 +37523,15 @@ export type GetReadingResponses = {
             /**
              * Which cycle is at or near zero crossing.
              */
-            cycle: string;
+            cycle: 'physical' | 'emotional' | 'intellectual' | 'intuitive' | 'aesthetic' | 'awareness' | 'spiritual' | 'passion' | 'mastery' | 'wisdom';
             /**
-             * Alert type. zero_crossing when a cycle crosses zero, approaching_critical when within 1 day of zero.
+             * Alert type. One of: zero_crossing. Raised once for the whole critical band, when the cycle sits within 9 points of zero in either direction.
              */
-            type: string;
+            type: 'zero_crossing';
             /**
              * Whether the cycle is rising through zero (ascending) or falling through zero (descending).
              */
-            direction: string;
+            direction: 'ascending' | 'descending';
             /**
              * Specific advisory text for this critical alert.
              */
@@ -37080,9 +37909,9 @@ export type GetCriticalDaysResponses = {
              */
             date: string;
             /**
-             * Which primary cycle crosses zero on this date.
+             * Which primary cycle crosses zero on this date. One of: physical, emotional, intellectual. Only the three primary cycles are scanned; the secondary and composite cycles are not.
              */
-            cycle: string;
+            cycle: 'physical' | 'emotional' | 'intellectual';
             /**
              * Cycle period in days.
              */
@@ -37090,11 +37919,11 @@ export type GetCriticalDaysResponses = {
             /**
              * Whether the cycle is rising through zero (ascending) or falling through zero (descending).
              */
-            direction: string;
+            direction: 'ascending' | 'descending';
             /**
-             * How many primary cycles are critical on this date. single, double, or triple.
+             * How many primary cycles are critical on this date. One of: single, double, triple.
              */
-            severity: string;
+            severity: 'single' | 'double' | 'triple';
             /**
              * Advisory text explaining the significance of this critical day and recommended precautions.
              */
@@ -37292,9 +38121,9 @@ export type CalculateBioCompatibilityResponses = {
                  */
                 alignment: number;
                 /**
-                 * Alignment phase. One of: in_sync, complementary, neutral, opposing.
+                 * How the two people's cycles sit against each other. One of: in_sync, complementary, neutral, opposing. This is a PAIR alignment and shares no values with the single-person cycle phase.
                  */
-                phase: string;
+                phase: 'in_sync' | 'complementary' | 'neutral' | 'opposing';
                 /**
                  * Human-readable description of how this cycle alignment affects the relationship.
                  */
@@ -37481,7 +38310,7 @@ export type GetPhasesResponses = {
                 /**
                  * Current phase identifier.
                  */
-                phase: string;
+                phase: 'peak' | 'high' | 'rising' | 'critical_ascending' | 'critical_descending' | 'falling' | 'low' | 'trough';
                 /**
                  * Human-readable phase label.
                  */
@@ -37501,7 +38330,7 @@ export type GetPhasesResponses = {
                 /**
                  * Short-term direction: rising, falling, peaking, or bottoming.
                  */
-                trend: string;
+                trend: 'rising' | 'falling' | 'peaking' | 'bottoming';
             };
         };
         /**
@@ -37651,14 +38480,14 @@ export type GetDailyBiorhythmResponses = {
          */
         energyRating: number;
         /**
-         * Summary phase. One of: high_energy, mixed, recovery, critical.
+         * Summary phase across every cycle for the day. One of: high_energy, mixed, recovery, critical.
          */
-        overallPhase: string;
+        overallPhase: 'high_energy' | 'mixed' | 'recovery' | 'critical';
         spotlight: {
             /**
-             * Which primary cycle is featured as the daily spotlight.
+             * Which primary cycle is featured as the daily spotlight. One of: physical, emotional, intellectual.
              */
-            cycle: string;
+            cycle: 'physical' | 'emotional' | 'intellectual';
             /**
              * Current value of the spotlight cycle (-100 to 100).
              */
@@ -37666,7 +38495,7 @@ export type GetDailyBiorhythmResponses = {
             /**
              * Current phase of the spotlight cycle.
              */
-            phase: string;
+            phase: 'peak' | 'high' | 'rising' | 'critical_ascending' | 'critical_descending' | 'falling' | 'low' | 'trough';
             /**
              * Personalized message about the spotlight cycle and what it means for today.
              */
@@ -43322,7 +44151,7 @@ export type GetUsageStatsResponses = {
          */
         plan: string;
         /**
-         * Billable requests counted against the current calendar month. Read from the same counter the rate limiter enforces on, so it never reports a rosier number than the limit that will 429 you. Cached responses still count.
+         * Billable requests counted against the current calendar month. The quota window is the UTC calendar month and resets on the 1st at 12:00 AM UTC, never on your renewal date, so an annual plan refills every month and a plan bought mid month still refills on the 1st. Read from the same counter the rate limiter enforces on, so it never reports a rosier number than the limit that will 429 you. Cached responses still count.
          */
         usedThisMonth: number;
         /**
@@ -43330,7 +44159,7 @@ export type GetUsageStatsResponses = {
          */
         requestsPerMonth: number;
         /**
-         * Requests left before the monthly allowance is exhausted, floored at zero. Equal to requestsPerMonth minus usedThisMonth.
+         * Requests left before the monthly allowance is exhausted, floored at zero. Equal to requestsPerMonth minus usedThisMonth. Refills at the calendar month rollover, whose exact instant every API response carries as a Unix timestamp in the X-RateLimit-Reset header.
          */
         remainingThisMonth: number;
         /**
@@ -43342,7 +44171,7 @@ export type GetUsageStatsResponses = {
          */
         status: string;
         /**
-         * ISO 8601 timestamp when the current billing period ends. A renewal extends this date in place. API access survives a cancelled or suspended status until this moment passes.
+         * ISO 8601 timestamp when the current billing period ends. A renewal extends this date in place. API access survives a cancelled or suspended status until this moment passes. This is a BILLING date, not a quota date: the monthly allowance resets on the 1st of each month independently of it.
          */
         endDate: string;
     };