thoth-cli 0.1.1 → 0.2.0

package/dist/index.d.ts

@@ -6,13 +6,17 @@ interface Planet {
     sign: string;
     position: number;
     abs_position: number;
-    house?: number | null;
+    house?: string | null;
     retrograde: boolean;
 }
 interface House {
     sign: string | null;
     position: number | null;
 }
+interface LunarPhase {
+    name: string;
+    emoji: string;
+}
 interface ChartResult {
     name: string;
     datetime: {
@@ -25,9 +29,19 @@ interface ChartResult {
     location: {
         lat: number;
         lng: number;
+        city?: string;
     };
     planets: Record<string, Planet>;
     houses: Record<string, House>;
+    aspects: Array<{
+        planet1: string;
+        planet2: string;
+        aspect: string;
+        orb: number;
+    }>;
+    elements: Record<string, number>;
+    modes: Record<string, number>;
+    lunar_phase?: LunarPhase;
     ascendant: {
         sign: string | null;
         position: number | null;
@@ -36,24 +50,30 @@ interface ChartResult {
         sign: string | null;
         position: number | null;
     };
+    svg?: string;
+    type?: string;
 }
 interface Aspect {
     transit_planet: string;
     natal_planet: string;
-    aspect: 'conjunction' | 'opposition' | 'trine' | 'square' | 'sextile';
+    aspect: string;
     orb: number;
-    transit_position: number;
-    natal_position: number;
-    applying: boolean;
+    transit_house?: number;
+    natal_house?: number;
 }
 interface TransitResult {
     natal: {
         datetime: string;
+        city?: string;
     };
     transit: {
         datetime: string;
+        planets?: Record<string, Planet>;
+        lunar_phase?: LunarPhase;
     };
     aspects: Aspect[];
+    svg?: string;
+    type?: string;
 }
 interface MoonResult {
     datetime: string;
@@ -76,6 +96,128 @@ interface EphemerisResult {
     abs_position: number;
     retrograde: boolean;
 }
+interface SolarReturnResult {
+    type: string;
+    natal_date: string;
+    return_year: number;
+    exact_datetime: string;
+    location: {
+        city?: string;
+        lat?: number;
+        lng?: number;
+    };
+    planets: Record<string, Planet>;
+    houses: Record<string, House>;
+    ascendant: {
+        sign: string;
+        position: number;
+    };
+    midheaven: {
+        sign: string;
+        position: number;
+    };
+    lunar_phase?: LunarPhase;
+    svg?: string;
+}
+interface LunarReturnResult {
+    type: string;
+    natal_date: string;
+    natal_moon: {
+        sign: string;
+        position: number;
+    };
+    search_from: string;
+    exact_datetime: string;
+    location: {
+        city?: string;
+    };
+    planets: Record<string, Planet>;
+    houses: Record<string, House>;
+    ascendant: {
+        sign: string;
+        position: number;
+    };
+    midheaven: {
+        sign: string;
+        position: number;
+    };
+    svg?: string;
+}
+interface SynastryResult {
+    type: string;
+    person1: {
+        name: string;
+        date: string;
+        planets: Record<string, Planet>;
+    };
+    person2: {
+        name: string;
+        date: string;
+        planets: Record<string, Planet>;
+    };
+    aspects: Array<{
+        planet1: string;
+        planet2: string;
+        aspect: string;
+        orb: number;
+    }>;
+    aspect_count: number;
+    svg?: string;
+}
+interface ProgressionsResult {
+    type: string;
+    method: string;
+    natal_date: string;
+    target_date: string;
+    age_at_target: number;
+    progressed_date: string;
+    progressed_planets: Record<string, Planet>;
+    natal_planets: Record<string, Planet>;
+    progressed_to_natal_aspects: Array<{
+        progressed: string;
+        natal: string;
+        aspect: string;
+        orb: number;
+    }>;
+    progressed_ascendant: {
+        sign: string;
+        position: number;
+    };
+    progressed_midheaven: {
+        sign: string;
+        position: number;
+    };
+    svg?: string;
+}
+interface EphemerisPosition {
+    date: string;
+    sign: string;
+    position: number;
+    abs_position: number;
+    retrograde: boolean;
+}
+interface SignChange {
+    date: string;
+    from: string;
+    to: string;
+}
+interface RetrogradeStation {
+    date: string;
+    station: 'retrograde' | 'direct';
+    sign: string;
+    position: number;
+}
+interface EphemerisRangeResult {
+    body: string;
+    range: {
+        start: string;
+        end: string;
+        step: string;
+    };
+    positions: EphemerisPosition[];
+    sign_changes: SignChange[];
+    retrograde_stations: RetrogradeStation[];
+}
 interface ChartOptions {
     year: number;
     month: number;
@@ -87,6 +229,7 @@ interface ChartOptions {
     city?: string;
     nation?: string;
     name?: string;
+    svg?: boolean;
 }
 interface TransitOptions {
     natalYear: number;
@@ -102,6 +245,86 @@ interface TransitOptions {
     transitMonth?: number;
     transitDay?: number;
     orb?: number;
+    svg?: boolean;
+}
+interface SolarReturnOptions {
+    natalYear: number;
+    natalMonth: number;
+    natalDay: number;
+    natalHour?: number;
+    natalMinute?: number;
+    natalLat?: number;
+    natalLng?: number;
+    natalCity?: string;
+    nation?: string;
+    returnYear: number;
+    returnCity?: string;
+    svg?: boolean;
+}
+interface LunarReturnOptions {
+    natalYear: number;
+    natalMonth: number;
+    natalDay: number;
+    natalHour?: number;
+    natalMinute?: number;
+    natalLat?: number;
+    natalLng?: number;
+    natalCity?: string;
+    nation?: string;
+    fromYear: number;
+    fromMonth: number;
+    fromDay?: number;
+    returnCity?: string;
+    svg?: boolean;
+}
+interface SynastryOptions {
+    year1: number;
+    month1: number;
+    day1: number;
+    hour1?: number;
+    minute1?: number;
+    lat1?: number;
+    lng1?: number;
+    city1?: string;
+    nation1?: string;
+    name1?: string;
+    year2: number;
+    month2: number;
+    day2: number;
+    hour2?: number;
+    minute2?: number;
+    lat2?: number;
+    lng2?: number;
+    city2?: string;
+    nation2?: string;
+    name2?: string;
+    orb?: number;
+    svg?: boolean;
+}
+interface ProgressionsOptions {
+    natalYear: number;
+    natalMonth: number;
+    natalDay: number;
+    natalHour?: number;
+    natalMinute?: number;
+    natalLat?: number;
+    natalLng?: number;
+    natalCity?: string;
+    nation?: string;
+    targetYear: number;
+    targetMonth?: number;
+    targetDay?: number;
+    svg?: boolean;
+}
+interface EphemerisRangeOptions {
+    body: string;
+    startYear: number;
+    startMonth?: number;
+    startDay?: number;
+    endYear: number;
+    endMonth?: number;
+    endDay?: number;
+    step?: 'day' | 'week' | 'month';
 }
 interface MoonOptions {
     year?: number;
@@ -110,6 +333,160 @@ interface MoonOptions {
     lat?: number;
     lng?: number;
 }
+interface CompositeResult {
+    type: string;
+    method: string;
+    person1: {
+        name: string;
+        date: string;
+    };
+    person2: {
+        name: string;
+        date: string;
+    };
+    name: string;
+    planets: Record<string, {
+        sign: string;
+        position: number;
+        abs_position: number;
+        house?: string;
+    }>;
+    houses: Record<string, House>;
+    ascendant: {
+        sign: string;
+        position: number;
+    };
+    midheaven: {
+        sign: string;
+        position: number;
+    };
+    svg?: string;
+}
+interface CompositeOptions {
+    year1: number;
+    month1: number;
+    day1: number;
+    hour1?: number;
+    minute1?: number;
+    lat1?: number;
+    lng1?: number;
+    city1?: string;
+    nation1?: string;
+    name1?: string;
+    year2: number;
+    month2: number;
+    day2: number;
+    hour2?: number;
+    minute2?: number;
+    lat2?: number;
+    lng2?: number;
+    city2?: string;
+    nation2?: string;
+    name2?: string;
+    svg?: boolean;
+}
+interface DirectedPlanet {
+    sign: string;
+    position: number;
+    abs_position: number;
+    natal_sign: string;
+    natal_position: number;
+}
+interface SolarArcResult {
+    type: string;
+    method: string;
+    natal_date: string;
+    target_date: string;
+    age_at_target: number;
+    solar_arc: number;
+    directed_planets: Record<string, DirectedPlanet>;
+    directed_ascendant: DirectedPlanet;
+    directed_midheaven: DirectedPlanet;
+    directed_to_natal_aspects: Array<{
+        directed: string;
+        natal: string;
+        aspect: string;
+        orb: number;
+    }>;
+}
+interface SolarArcOptions {
+    natalYear: number;
+    natalMonth: number;
+    natalDay: number;
+    natalHour?: number;
+    natalMinute?: number;
+    natalLat?: number;
+    natalLng?: number;
+    natalCity?: string;
+    nation?: string;
+    targetYear: number;
+    targetMonth?: number;
+    targetDay?: number;
+}
+interface MoonAspect {
+    planet: string;
+    aspect: string;
+    orb: number;
+    applying: boolean;
+}
+interface HoraryHouse {
+    sign: string;
+    position: number;
+    ruler: string;
+    topic: string;
+}
+interface HoraryResult {
+    type: string;
+    question: string;
+    cast_time: {
+        datetime: string;
+        city?: string;
+    };
+    planetary_hour: string;
+    day_ruler: string;
+    querent: {
+        house: number;
+        sign: string;
+        ruler: string;
+        ruler_position: {
+            sign: string;
+            position: number;
+            house?: string;
+            retrograde: boolean;
+        };
+    };
+    moon: {
+        sign: string;
+        position: number;
+        house?: string;
+        void_of_course: boolean;
+        degrees_until_sign_change: number;
+        aspects: MoonAspect[];
+    };
+    strictures: string[];
+    houses: Record<string, HoraryHouse>;
+    planets: Record<string, Planet>;
+    ascendant: {
+        sign: string;
+        position: number;
+    };
+    midheaven: {
+        sign: string;
+        position: number;
+    };
+}
+interface HoraryOptions {
+    question: string;
+    year?: number;
+    month?: number;
+    day?: number;
+    hour?: number;
+    minute?: number;
+    lat?: number;
+    lng?: number;
+    city?: string;
+    nation?: string;
+}
 interface EphemerisOptions {
     body: string;
     year?: number;
@@ -135,6 +512,26 @@ declare function chart(options: ChartOptions): Promise<ThothResult<ChartResult>>
  * Calculate transits to a natal chart
  */
 declare function transit(options: TransitOptions): Promise<ThothResult<TransitResult>>;
+/**
+ * Calculate solar return chart
+ */
+declare function solarReturn(options: SolarReturnOptions): Promise<ThothResult<SolarReturnResult>>;
+/**
+ * Calculate lunar return chart
+ */
+declare function lunarReturn(options: LunarReturnOptions): Promise<ThothResult<LunarReturnResult>>;
+/**
+ * Calculate synastry between two charts
+ */
+declare function synastry(options: SynastryOptions): Promise<ThothResult<SynastryResult>>;
+/**
+ * Calculate secondary progressions
+ */
+declare function progressions(options: ProgressionsOptions): Promise<ThothResult<ProgressionsResult>>;
+/**
+ * Get ephemeris positions over a date range
+ */
+declare function ephemerisRange(options: EphemerisRangeOptions): Promise<ThothResult<EphemerisRangeResult>>;
 /**
  * Get moon phase and position
  */
@@ -143,6 +540,18 @@ declare function moon(options?: MoonOptions): Promise<ThothResult<MoonResult>>;
  * Get ephemeris position for a celestial body
  */
 declare function ephemeris(options: EphemerisOptions): Promise<ThothResult<EphemerisResult>>;
+/**
+ * Calculate composite chart
+ */
+declare function composite(options: CompositeOptions): Promise<ThothResult<CompositeResult>>;
+/**
+ * Calculate solar arc directions
+ */
+declare function solarArc(options: SolarArcOptions): Promise<ThothResult<SolarArcResult>>;
+/**
+ * Cast a horary chart
+ */
+declare function horary(options: HoraryOptions): Promise<ThothResult<HoraryResult>>;
 /**
  * Get version
  */
@@ -187,5 +596,37 @@ declare function formatMoon(result: MoonResult): string;
  * Format ephemeris result
  */
 declare function formatEphemeris(result: EphemerisResult): string;
+/**
+ * Format solar return result
+ */
+declare function formatSolarReturn(result: SolarReturnResult): string;
+/**
+ * Format lunar return result
+ */
+declare function formatLunarReturn(result: LunarReturnResult): string;
+/**
+ * Format synastry result
+ */
+declare function formatSynastry(result: SynastryResult): string;
+/**
+ * Format progressions result
+ */
+declare function formatProgressions(result: ProgressionsResult): string;
+/**
+ * Format ephemeris range result
+ */
+declare function formatEphemerisRange(result: EphemerisRangeResult): string;
+/**
+ * Format composite chart result
+ */
+declare function formatComposite(result: CompositeResult): string;
+/**
+ * Format solar arc directions result
+ */
+declare function formatSolarArc(result: SolarArcResult): string;
+/**
+ * Format horary chart result
+ */
+declare function formatHorary(result: HoraryResult): string;
 
-export { type Aspect, type ChartOptions, type ChartResult, type EphemerisOptions, type EphemerisResult, type House, type MoonOptions, type MoonResult, type Planet, type ThothError, type ThothResult, type TransitOptions, type TransitResult, chart, ephemeris, formatChart, formatDegrees, formatEphemeris, formatMoon, formatTransits, getAspectSymbol, getPlanetSymbol, getZodiacSymbol, isError, moon, transit, version };
+export { type Aspect, type ChartOptions, type ChartResult, type CompositeOptions, type CompositeResult, type DirectedPlanet, type EphemerisOptions, type EphemerisPosition, type EphemerisRangeOptions, type EphemerisRangeResult, type EphemerisResult, type HoraryHouse, type HoraryOptions, type HoraryResult, type House, type LunarPhase, type LunarReturnOptions, type LunarReturnResult, type MoonAspect, type MoonOptions, type MoonResult, type Planet, type ProgressionsOptions, type ProgressionsResult, type RetrogradeStation, type SignChange, type SolarArcOptions, type SolarArcResult, type SolarReturnOptions, type SolarReturnResult, type SynastryOptions, type SynastryResult, type ThothError, type ThothResult, type TransitOptions, type TransitResult, chart, composite, ephemeris, ephemerisRange, formatChart, formatComposite, formatDegrees, formatEphemeris, formatEphemerisRange, formatHorary, formatLunarReturn, formatMoon, formatProgressions, formatSolarArc, formatSolarReturn, formatSynastry, formatTransits, getAspectSymbol, getPlanetSymbol, getZodiacSymbol, horary, isError, lunarReturn, moon, progressions, solarArc, solarReturn, synastry, transit, version };

package/dist/index.js

@@ -1,32 +1,64 @@
 import {
   chart,
+  composite,
   ephemeris,
+  ephemerisRange,
   formatChart,
+  formatComposite,
   formatDegrees,
   formatEphemeris,
+  formatEphemerisRange,
+  formatHorary,
+  formatLunarReturn,
   formatMoon,
+  formatProgressions,
+  formatSolarArc,
+  formatSolarReturn,
+  formatSynastry,
   formatTransits,
   getAspectSymbol,
   getPlanetSymbol,
   getZodiacSymbol,
+  horary,
   isError,
+  lunarReturn,
   moon,
+  progressions,
+  solarArc,
+  solarReturn,
+  synastry,
   transit,
   version
-} from "./chunk-NYXKYHNK.js";
+} from "./chunk-NEQKNEBO.js";
 export {
   chart,
+  composite,
   ephemeris,
+  ephemerisRange,
   formatChart,
+  formatComposite,
   formatDegrees,
   formatEphemeris,
+  formatEphemerisRange,
+  formatHorary,
+  formatLunarReturn,
   formatMoon,
+  formatProgressions,
+  formatSolarArc,
+  formatSolarReturn,
+  formatSynastry,
   formatTransits,
   getAspectSymbol,
   getPlanetSymbol,
   getZodiacSymbol,
+  horary,
   isError,
+  lunarReturn,
   moon,
+  progressions,
+  solarArc,
+  solarReturn,
+  synastry,
   transit,
   version
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thoth-cli",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "𓅝 Astrological calculations from the command line. Swiss Ephemeris precision. Built for humans and agents.",
   "author": "AKLO <aklo@aklolabs.com>",
   "license": "MIT",