astro_chart 0.1.0 → 0.4.0

data/lib/astro_chart/transits.rb

@@ -0,0 +1,108 @@
+require_relative "pure"
+require_relative "ephemeris"
+require_relative "zodiac"
+require_relative "aspects"
+require_relative "houses"
+require_relative "planets"
+require_relative "synastry"
+
+module AstroChart
+  # Transits (行運): where the planets are in the sky right now (or at any
+  # moment), compared against a natal chart.
+  #
+  # Pure composition of existing modules — Planets.calculate_positions gives
+  # the sky positions for any JD, Houses.find_house places them into the
+  # natal houses, and Aspects.calculate scores transit-to-natal contacts.
+  #
+  # Typical usage with a Chart#generate result:
+  #
+  #   jd = AstroChart::TimeConversion.to_julian_day("2026-07-24", "12:00", "Asia/Taipei")
+  #   AstroChart::Transits.at(jd)                  # 天象快照 { "太陽" => 121.9, ... }
+  #   AstroChart::Transits.against(natal_chart, jd) # 行運行星落入本命宮位 + 行運相位
+  module Transits
+    # Bodies used for transit-to-natal aspects. Mirrors Synastry: 南交點 is
+    # excluded because it sits exactly opposite 北交點 — every south-node
+    # aspect would just mirror a north-node one and double the noise.
+    ASPECT_BODIES = Synastry::BODIES
+
+    # Sky snapshot at a Julian Day.
+    #
+    # Returns { "太陽" => 123.45, ..., "南交點" => 303.45 } — ecliptic
+    # longitudes (total degrees 0-360) for the 12 bodies
+    # (Ephemeris::PLANETS + 南交點 = 北交點 + 180°).
+    def self.at(jd)
+      Planets.calculate_positions(jd)
+    end
+
+    # Transits against a natal chart (a Chart#generate result hash).
+    #
+    # jd: Julian Day of the transit moment.
+    # orb_limit: keep only aspects with orb <= limit (default 3.0 — transit
+    #   practice uses much tighter orbs than the natal defaults in Aspects).
+    #
+    # Returns:
+    #   {
+    #     "planets" => [ { "planet" => "木星", "zodiac" => "獅子座",
+    #                      "degree" => 5.1, "total_degree" => 125.1,
+    #                      "natal_house" => 7 }, ... 12 entries ],
+    #     "aspects" => [ { "transit_planet" => "土星", "natal_planet" => "太陽",
+    #                      "aspect_type" => "四分相", "orb" => 1.23 }, ... ]
+    #   }
+    #
+    # aspects are sorted by orb (tightest first).
+    def self.against(natal_chart, jd, orb_limit: 3.0)
+      transit_positions = at(jd)
+      natal_positions   = Synastry.positions_from_chart(natal_chart)
+      natal_cusps       = Synastry.cusps_from_chart(natal_chart)
+
+      {
+        "planets" => planet_details(transit_positions, natal_cusps),
+        "aspects" => aspects_to_natal(transit_positions, natal_positions,
+                                      orb_limit: orb_limit,
+                                      keys: %w[transit_planet natal_planet]),
+      }
+    end
+
+    # Build the per-planet detail list, placing each transiting body into
+    # the natal houses.
+    def self.planet_details(positions, natal_cusps)
+      positions.map do |name, pos|
+        {
+          "planet"       => name,
+          "zodiac"       => Zodiac.sign_name(pos),
+          "degree"       => (pos % 30).round(4),
+          "total_degree" => pos.round(4),
+          "natal_house"  => Houses.find_house(pos, natal_cusps),
+        }
+      end
+    end
+
+    # Aspects from moving positions to natal positions, filtered by
+    # orb_limit and sorted by orb. `keys` names the two hash keys so
+    # Progressions can reuse this with "progressed_planet".
+    def self.aspects_to_natal(moving_positions, natal_positions, orb_limit:,
+                              keys: %w[transit_planet natal_planet])
+      moving_key, natal_key = keys
+      results = []
+
+      moving_positions.each do |m_name, m_pos|
+        next unless ASPECT_BODIES.include?(m_name)
+
+        natal_positions.each do |n_name, n_pos|
+          aspect_type, orb = Aspects.calculate(m_pos, n_pos)
+          next if aspect_type.nil?
+          next if orb_limit && orb > orb_limit
+
+          results << {
+            moving_key    => m_name,
+            natal_key     => n_name,
+            "aspect_type" => aspect_type,
+            "orb"         => orb,
+          }
+        end
+      end
+
+      results.sort_by { |r| r["orb"] }
+    end
+  end
+end

data/lib/astro_chart/version.rb

@@ -1,3 +1,3 @@
 module AstroChart
-  VERSION = "0.1.0"
+  VERSION = "0.4.0"
 end

data/lib/astro_chart.rb

@@ -1,12 +1,30 @@
 require_relative "astro_chart/version"
-require_relative "astro_chart/astro_chart_ext"
+# NOTE: the Swiss Ephemeris C extension (astro_chart_ext) is NOT loaded here.
+# The default backend is pure Ruby; the extension is required on demand by
+# `AstroChart.backend = :swiss` so environments without a compiled extension
+# still work out of the box.
+require_relative "astro_chart/pure"
 require_relative "astro_chart/ephemeris"
 require_relative "astro_chart/zodiac"
 require_relative "astro_chart/aspects"
 require_relative "astro_chart/houses"
 require_relative "astro_chart/time_conversion"
 require_relative "astro_chart/planets"
+require_relative "astro_chart/points"
+require_relative "astro_chart/patterns"
+require_relative "astro_chart/stats"
+require_relative "astro_chart/synastry"
 require_relative "astro_chart/chart"
+require_relative "astro_chart/transits"
+require_relative "astro_chart/progressions"
+require_relative "astro_chart/composite"
+require_relative "astro_chart/solar_return"
+require_relative "astro_chart/draconic"
+require_relative "astro_chart/dignities"
+require_relative "astro_chart/profection"
+require_relative "astro_chart/transit_timing"
+require_relative "astro_chart/solar_arc"
+require_relative "astro_chart/lunar_return"
 
 module AstroChart
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: astro_chart
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Huang Yudi
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-01 00:00:00.000000000 Z
+date: 2026-08-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tzinfo
@@ -52,65 +52,55 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '13.0'
-- !ruby/object:Gem::Dependency
-  name: rake-compiler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.2'
-description: A Ruby gem for natal astrology chart calculation, powered by Swiss Ephemeris
-  C library with Moshier ephemeris. No external data files needed.
+description: 'Astrology chart calculation in pure Ruby: apparent planetary longitudes
+  (VSOP87D, ELP-2000/82B moon, Meeus Pluto), Placidus and whole-sign houses, retrograde
+  flags, aspects, derived points (Part of Fortune, mean Lilith), aspect-pattern detection
+  and element statistics, plus synastry, transits, secondary progressions, composite
+  charts and solar returns. No C extension, no external data files. Implemented from
+  public formulas (Meeus, Astronomical Algorithms 2nd ed.).'
 email:
 executables: []
-extensions:
-- ext/astro_chart/extconf.rb
+extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - LICENSE
+- README.md
 - astro_chart.gemspec
-- ext/astro_chart/astro_chart_ext.c
-- ext/astro_chart/extconf.rb
-- ext/astro_chart/swecl.c
-- ext/astro_chart/swedate.c
-- ext/astro_chart/swedate.h
-- ext/astro_chart/swedll.h
-- ext/astro_chart/sweephe4.c
-- ext/astro_chart/sweephe4.h
-- ext/astro_chart/swehel.c
-- ext/astro_chart/swehouse.c
-- ext/astro_chart/swehouse.h
-- ext/astro_chart/swejpl.c
-- ext/astro_chart/swejpl.h
-- ext/astro_chart/swemmoon.c
-- ext/astro_chart/swemplan.c
-- ext/astro_chart/swemptab.h
-- ext/astro_chart/swenut2000a.h
-- ext/astro_chart/sweodef.h
-- ext/astro_chart/sweph.c
-- ext/astro_chart/sweph.h
-- ext/astro_chart/swephexp.h
-- ext/astro_chart/swephlib.c
-- ext/astro_chart/swephlib.h
 - lib/astro_chart.rb
 - lib/astro_chart/aspects.rb
 - lib/astro_chart/chart.rb
+- lib/astro_chart/composite.rb
+- lib/astro_chart/dignities.rb
+- lib/astro_chart/draconic.rb
 - lib/astro_chart/ephemeris.rb
 - lib/astro_chart/houses.rb
+- lib/astro_chart/lunar_return.rb
+- lib/astro_chart/patterns.rb
 - lib/astro_chart/planets.rb
+- lib/astro_chart/points.rb
+- lib/astro_chart/profection.rb
+- lib/astro_chart/progressions.rb
+- lib/astro_chart/pure.rb
+- lib/astro_chart/pure/core.rb
+- lib/astro_chart/pure/houses.rb
+- lib/astro_chart/pure/moon.rb
+- lib/astro_chart/pure/moon_elp.rb
+- lib/astro_chart/pure/pluto.rb
+- lib/astro_chart/pure/vsop87.rb
+- lib/astro_chart/pure/vsop87_data.rb
+- lib/astro_chart/solar_arc.rb
+- lib/astro_chart/solar_return.rb
+- lib/astro_chart/stats.rb
+- lib/astro_chart/synastry.rb
 - lib/astro_chart/time_conversion.rb
+- lib/astro_chart/transit_timing.rb
+- lib/astro_chart/transits.rb
 - lib/astro_chart/version.rb
 - lib/astro_chart/zodiac.rb
 homepage: https://github.com/morriedig/astro_chart
 licenses:
-- AGPL-3.0
+- MIT
 metadata: {}
 post_install_message:
 rdoc_options: []
@@ -130,5 +120,6 @@ requirements: []
 rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
-summary: Natal chart calculation using Swiss Ephemeris
+summary: Pure-Ruby astrology chart calculation (planets, Placidus/whole-sign houses,
+  aspects, synastry, transits, progressions, composite, solar returns)
 test_files: []

data/ext/astro_chart/astro_chart_ext.c

@@ -1,99 +0,0 @@
-#include <ruby.h>
-#include "swephexp.h"
-
-static VALUE mAstroChart;
-static VALUE mExt;
-
-/*
- * AstroChart::Ext.julday(year, month, day, hour) -> Float
- *
- * Convert a date/time to Julian Day number using Gregorian calendar.
- */
-static VALUE rb_julday(VALUE self, VALUE year, VALUE month, VALUE day, VALUE hour) {
-    int y = NUM2INT(year);
-    int m = NUM2INT(month);
-    int d = NUM2INT(day);
-    double h = NUM2DBL(hour);
-
-    double jd = swe_julday(y, m, d, h, SE_GREG_CAL);
-    return DBL2NUM(jd);
-}
-
-/*
- * AstroChart::Ext.calc_ut(jd, planet_id) -> Float
- *
- * Calculate planet ecliptic longitude using Moshier ephemeris.
- * Returns the longitude in degrees (0-360).
- */
-static VALUE rb_calc_ut(VALUE self, VALUE jd, VALUE planet_id) {
-    double tjd = NUM2DBL(jd);
-    int ipl = NUM2INT(planet_id);
-    double xx[6];
-    char serr[256];
-
-    int32 ret = swe_calc_ut(tjd, ipl, SEFLG_MOSEPH, xx, serr);
-    if (ret < 0) {
-        rb_raise(rb_eRuntimeError, "swe_calc_ut failed: %s", serr);
-    }
-
-    return DBL2NUM(xx[0]); /* ecliptic longitude */
-}
-
-/*
- * AstroChart::Ext.houses(jd, latitude, longitude, system) -> Hash
- *
- * Calculate house cusps and ascendant/MC.
- * system: ASCII code for house system (e.g. 'P' = 80 for Placidus)
- *
- * Returns a Hash with:
- *   "cusps"     => Array of 12 house cusp degrees
- *   "ascendant" => Ascendant degree
- *   "mc"        => MC degree
- */
-static VALUE rb_houses(VALUE self, VALUE jd, VALUE lat, VALUE lon, VALUE hsys) {
-    double tjd = NUM2DBL(jd);
-    double geolat = NUM2DBL(lat);
-    double geolon = NUM2DBL(lon);
-    int system = NUM2INT(hsys);
-
-    double cusps[13];  /* cusps[0] unused, cusps[1..12] */
-    double ascmc[10];
-
-    swe_houses(tjd, geolat, geolon, system, cusps, ascmc);
-
-    VALUE result = rb_hash_new();
-    VALUE cusps_ary = rb_ary_new_capa(12);
-
-    int i;
-    for (i = 1; i <= 12; i++) {
-        rb_ary_push(cusps_ary, DBL2NUM(cusps[i]));
-    }
-
-    rb_hash_aset(result, rb_str_new_cstr("cusps"), cusps_ary);
-    rb_hash_aset(result, rb_str_new_cstr("ascendant"), DBL2NUM(ascmc[0]));
-    rb_hash_aset(result, rb_str_new_cstr("mc"), DBL2NUM(ascmc[1]));
-
-    return result;
-}
-
-void Init_astro_chart_ext(void) {
-    mAstroChart = rb_define_module("AstroChart");
-    mExt = rb_define_module_under(mAstroChart, "Ext");
-
-    rb_define_module_function(mExt, "julday", rb_julday, 4);
-    rb_define_module_function(mExt, "calc_ut", rb_calc_ut, 2);
-    rb_define_module_function(mExt, "houses", rb_houses, 4);
-
-    /* Planet ID constants */
-    rb_define_const(mExt, "SUN", INT2NUM(SE_SUN));
-    rb_define_const(mExt, "MOON", INT2NUM(SE_MOON));
-    rb_define_const(mExt, "MERCURY", INT2NUM(SE_MERCURY));
-    rb_define_const(mExt, "VENUS", INT2NUM(SE_VENUS));
-    rb_define_const(mExt, "MARS", INT2NUM(SE_MARS));
-    rb_define_const(mExt, "JUPITER", INT2NUM(SE_JUPITER));
-    rb_define_const(mExt, "SATURN", INT2NUM(SE_SATURN));
-    rb_define_const(mExt, "URANUS", INT2NUM(SE_URANUS));
-    rb_define_const(mExt, "NEPTUNE", INT2NUM(SE_NEPTUNE));
-    rb_define_const(mExt, "PLUTO", INT2NUM(SE_PLUTO));
-    rb_define_const(mExt, "TRUE_NODE", INT2NUM(SE_TRUE_NODE));
-}

data/ext/astro_chart/extconf.rb

@@ -1,8 +0,0 @@
-require "mkmf"
-
-# Swiss Ephemeris source files to compile alongside our extension
-$srcs = Dir.glob("#{$srcdir}/*.c").map { |f| File.basename(f) }
-
-$CFLAGS << " -DNO_SWE_GLP"
-
-create_makefile("astro_chart/astro_chart_ext")