astrolith 0.1.0

data/lib/ruby_chart_engine/charts/transit.rb

@@ -0,0 +1,64 @@
+require_relative 'base_chart'
+
+module RubyChartEngine
+  module Charts
+    class Transit < BaseChart
+      attr_reader :natal_chart, :transit_aspects
+
+      # Transit chart - current planetary positions compared to natal chart
+      def initialize(natal_chart_params:, transit_datetime:, house_system: :placidus)
+        # Create natal chart if not provided
+        @natal_chart = if natal_chart_params.is_a?(Natal)
+                         natal_chart_params
+                       else
+                         Natal.new(**natal_chart_params)
+                       end
+
+        # Use natal chart location for transit chart
+        # (transits are typically calculated for the natal location)
+        super(
+          datetime: transit_datetime,
+          latitude: @natal_chart.coordinates.latitude,
+          longitude: @natal_chart.coordinates.longitude,
+          timezone: natal_chart_params[:timezone] || 'UTC',
+          house_system: house_system
+        )
+
+        # Calculate aspects between transit planets and natal planets
+        calculate_transit_aspects!
+      end
+
+      def to_hash
+        super.merge(
+          chart_type: 'transit',
+          natal_chart_metadata: @natal_chart.to_hash[:metadata],
+          transit_aspects: @transit_aspects
+        )
+      end
+
+      private
+
+      def calculate_transit_aspects!
+        # Calculate aspects from transit planets to natal planets
+        @transit_aspects = Calculations::Aspects.calculate(
+          @planets,
+          @natal_chart.planets
+        )
+
+        # Also calculate aspects from natal to transit (for completeness)
+        reverse_aspects = Calculations::Aspects.calculate(
+          @natal_chart.planets,
+          @planets
+        )
+
+        # Combine and deduplicate
+        @transit_aspects = (@transit_aspects + reverse_aspects).uniq do |aspect|
+          [
+            [aspect[:planet1], aspect[:planet2]].sort,
+            aspect[:type]
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/ruby_chart_engine/input/coordinates.rb

@@ -0,0 +1,49 @@
+module RubyChartEngine
+  module Input
+    class Coordinates
+      attr_reader :latitude, :longitude
+
+      # Parse coordinates from various formats:
+      # - Decimal degrees: { lat: 32.7157, lon: -117.1611 }
+      # - Standard text: { lat: '32n43', lon: '117w10' }
+      # - Mixed: { lat: 32.7157, lon: '117w10' }
+      def initialize(lat:, lon:)
+        @latitude = parse_coordinate(lat, :lat)
+        @longitude = parse_coordinate(lon, :lon)
+      end
+
+      private
+
+      def parse_coordinate(value, type)
+        return value.to_f if value.is_a?(Numeric)
+        return value.to_f if value.is_a?(String) && value.match?(/^-?\d+\.?\d*$/)
+
+        # Parse standard text format like '32n43' or '117w10'
+        parse_standard_text(value, type)
+      end
+
+      def parse_standard_text(value, type)
+        # Match patterns like: 32n43, 32N43, 32n43'30", etc.
+        match = value.match(/(\d+)([nsewNSEW])(\d+)?(?:'(\d+)")?/)
+
+        raise Error, "Invalid coordinate format: #{value}" unless match
+
+        degrees = match[1].to_i
+        direction = match[2].downcase
+        minutes = match[3]&.to_i || 0
+        seconds = match[4]&.to_i || 0
+
+        decimal = degrees + (minutes / 60.0) + (seconds / 3600.0)
+
+        # Apply sign based on direction
+        if type == :lat
+          decimal = -decimal if direction == 's'
+        else
+          decimal = -decimal if direction == 'w'
+        end
+
+        decimal
+      end
+    end
+  end
+end

data/lib/ruby_chart_engine/input/datetime.rb

@@ -0,0 +1,68 @@
+require 'time'
+
+module RubyChartEngine
+  module Input
+    class DateTime
+      attr_reader :year, :month, :day, :hour, :minute, :second, :datetime
+
+      # Parse datetime from various formats:
+      # - Ruby DateTime/Time object
+      # - ISO 8601 string: "2024-03-15T14:30:00"
+      # - Hash: { year: 2024, month: 3, day: 15, hour: 14, minute: 30 }
+      def initialize(datetime)
+        @datetime = parse_datetime(datetime)
+        @year = @datetime.year
+        @month = @datetime.month
+        @day = @datetime.day
+        @hour = @datetime.hour
+        @minute = @datetime.min
+        @second = @datetime.sec
+      end
+
+      # Convert to Julian Day Number for Swiss Ephemeris
+      def to_julian_day(timezone_offset = 0)
+        # Adjust for timezone offset (in hours)
+        adjusted_time = @datetime - (timezone_offset * 3600)
+
+        # Use Swiss Ephemeris to calculate Julian Day
+        # swe_julday takes 4 arguments: year, month, day, hour (as decimal)
+        Swe4r.swe_julday(
+          adjusted_time.year,
+          adjusted_time.month,
+          adjusted_time.day,
+          adjusted_time.hour + (adjusted_time.min / 60.0) + (adjusted_time.sec / 3600.0)
+        )
+      end
+
+      private
+
+      def parse_datetime(value)
+        case value
+        when ::DateTime, ::Time
+          value.to_datetime
+        when String
+          ::DateTime.parse(value)
+        when Hash
+          validate_datetime_hash!(value)
+          ::DateTime.new(
+            value[:year],
+            value[:month],
+            value[:day],
+            value[:hour] || 0,
+            value[:minute] || 0,
+            value[:second] || 0
+          )
+        else
+          raise Error, "Invalid datetime format: #{value.class}"
+        end
+      end
+
+      def validate_datetime_hash!(hash)
+        required = [:year, :month, :day]
+        missing = required - hash.keys
+
+        raise Error, "Missing required datetime fields: #{missing.join(', ')}" if missing.any?
+      end
+    end
+  end
+end

data/lib/ruby_chart_engine/input/timezone.rb

@@ -0,0 +1,76 @@
+require 'tzinfo'
+
+module RubyChartEngine
+  module Input
+    class Timezone
+      attr_reader :timezone, :offset
+
+      # Parse timezone from various formats:
+      # - TZInfo timezone identifier: "America/Los_Angeles"
+      # - UTC offset: "+05:30" or -8
+      # - TZInfo::Timezone object
+      def initialize(timezone, datetime = nil)
+        @timezone = parse_timezone(timezone)
+        @datetime = datetime
+        @offset = calculate_offset
+      end
+
+      # Get offset in hours
+      def offset_hours
+        @offset / 3600.0
+      end
+
+      private
+
+      def parse_timezone(value)
+        case value
+        when TZInfo::Timezone
+          value
+        when String
+          if value.match?(/^[+-]?\d{1,2}:?\d{0,2}$/)
+            # UTC offset format
+            parse_utc_offset(value)
+          else
+            # TZInfo identifier
+            TZInfo::Timezone.get(value)
+          end
+        when Numeric
+          # Hours offset
+          parse_utc_offset(value)
+        else
+          raise Error, "Invalid timezone format: #{value.class}"
+        end
+      end
+
+      def parse_utc_offset(value)
+        # Convert to seconds offset
+        case value
+        when String
+          sign = value.start_with?('-') ? -1 : 1
+          parts = value.gsub(/^[+-]/, '').split(':')
+          hours = parts[0].to_i
+          minutes = parts[1]&.to_i || 0
+          offset_seconds = sign * (hours * 3600 + minutes * 60)
+        when Numeric
+          offset_seconds = value * 3600
+        end
+
+        # Create a timezone with fixed offset
+        TZInfo::Timezone.get('UTC').tap do |tz|
+          @offset = offset_seconds
+        end
+      end
+
+      def calculate_offset
+        return @offset if @offset
+
+        if @timezone.is_a?(TZInfo::Timezone) && @datetime
+          period = @timezone.period_for_local(@datetime)
+          period.utc_total_offset
+        else
+          0
+        end
+      end
+    end
+  end
+end

data/lib/ruby_chart_engine/serializers/json_serializer.rb

@@ -0,0 +1,44 @@
+module RubyChartEngine
+  module Serializers
+    class JsonSerializer
+      def self.serialize(chart)
+        chart.to_hash.to_json
+      end
+
+      def self.serialize_pretty(chart)
+        JSON.pretty_generate(chart.to_hash)
+      end
+
+      # Serialize multiple charts
+      def self.serialize_collection(charts)
+        charts.map(&:to_hash).to_json
+      end
+
+      # Serialize with custom options
+      def self.serialize_with_options(chart, options = {})
+        data = chart.to_hash
+
+        # Apply filters if specified
+        if options[:include]
+          data = data.select { |k, _| options[:include].include?(k) }
+        end
+
+        if options[:exclude]
+          data = data.reject { |k, _| options[:exclude].include?(k) }
+        end
+
+        # Format output
+        if options[:pretty]
+          JSON.pretty_generate(data)
+        else
+          data.to_json
+        end
+      end
+
+      # Parse JSON back to hash
+      def self.deserialize(json_string)
+        JSON.parse(json_string, symbolize_names: true)
+      end
+    end
+  end
+end

data/lib/ruby_chart_engine/version.rb

@@ -0,0 +1,3 @@
+module RubyChartEngine
+  VERSION = "0.1.0"
+end

data/lib/ruby_chart_engine.rb

@@ -0,0 +1,82 @@
+require 'swe4r'
+require 'ephemeris'
+require 'daru'
+require 'json'
+
+require_relative 'ruby_chart_engine/version'
+require_relative 'ruby_chart_engine/input/coordinates'
+require_relative 'ruby_chart_engine/input/datetime'
+require_relative 'ruby_chart_engine/input/timezone'
+
+require_relative 'ruby_chart_engine/calculations/positions'
+require_relative 'ruby_chart_engine/calculations/houses'
+require_relative 'ruby_chart_engine/calculations/aspects'
+require_relative 'ruby_chart_engine/calculations/dignities'
+
+require_relative 'ruby_chart_engine/serializers/json_serializer'
+
+require_relative 'ruby_chart_engine/charts/base_chart'
+require_relative 'ruby_chart_engine/charts/natal'
+require_relative 'ruby_chart_engine/charts/solar_return'
+require_relative 'ruby_chart_engine/charts/progressed'
+require_relative 'ruby_chart_engine/charts/composite'
+require_relative 'ruby_chart_engine/charts/transit'
+
+module RubyChartEngine
+  class Error < StandardError; end
+
+  # Swiss Ephemeris object ID constants
+  # These are standard SE values used across all implementations
+  PLANETS = {
+    sun: 0,       # SE_SUN
+    moon: 1,      # SE_MOON
+    mercury: 2,   # SE_MERCURY
+    venus: 3,     # SE_VENUS
+    mars: 4,      # SE_MARS
+    jupiter: 5,   # SE_JUPITER
+    saturn: 6,    # SE_SATURN
+    uranus: 7,    # SE_URANUS
+    neptune: 8,   # SE_NEPTUNE
+    pluto: 9      # SE_PLUTO
+  }.freeze
+
+  POINTS = {
+    north_node: 10,  # SE_TRUE_NODE (or use 11 for mean node)
+    south_node: 10,  # Will be calculated as opposite of north node
+    chiron: 15       # SE_CHIRON
+  }.freeze
+
+  ANGLES = {
+    ascendant: :asc,
+    midheaven: :mc,
+    descendant: :dsc,
+    imum_coeli: :ic
+  }.freeze
+
+  # Zodiac signs
+  SIGNS = [
+    { name: 'Aries', element: 'Fire', modality: 'Cardinal' },
+    { name: 'Taurus', element: 'Earth', modality: 'Fixed' },
+    { name: 'Gemini', element: 'Air', modality: 'Mutable' },
+    { name: 'Cancer', element: 'Water', modality: 'Cardinal' },
+    { name: 'Leo', element: 'Fire', modality: 'Fixed' },
+    { name: 'Virgo', element: 'Earth', modality: 'Mutable' },
+    { name: 'Libra', element: 'Air', modality: 'Cardinal' },
+    { name: 'Scorpio', element: 'Water', modality: 'Fixed' },
+    { name: 'Sagittarius', element: 'Fire', modality: 'Mutable' },
+    { name: 'Capricorn', element: 'Earth', modality: 'Cardinal' },
+    { name: 'Aquarius', element: 'Air', modality: 'Fixed' },
+    { name: 'Pisces', element: 'Water', modality: 'Mutable' }
+  ].freeze
+
+  # House systems
+  HOUSE_SYSTEMS = {
+    placidus: 'P',
+    koch: 'K',
+    porphyrius: 'O',
+    regiomontanus: 'R',
+    campanus: 'C',
+    equal: 'E',
+    whole_sign: 'W'
+  }.freeze
+end

metadata

@@ -0,0 +1,177 @@
+--- !ruby/object:Gem::Specification
+name: astrolith
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Go-pye
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-12-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: swe4r
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+- !ruby/object:Gem::Dependency
+  name: ephemeris
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: daru
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: tzinfo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: apexcharts
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: prawn
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+description: Astrolith is a decoupled astrological data calculation engine that generates
+  structured JSON output. It supports multiple chart types including Natal, Solar
+  Return, Progressed, Composite, and Transit charts.
+email:
+- Go-pye@users.noreply.github.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- astrolith.gemspec
+- examples/example_usage.rb
+- lib/ruby_chart_engine.rb
+- lib/ruby_chart_engine/calculations/aspects.rb
+- lib/ruby_chart_engine/calculations/dignities.rb
+- lib/ruby_chart_engine/calculations/houses.rb
+- lib/ruby_chart_engine/calculations/positions.rb
+- lib/ruby_chart_engine/charts/base_chart.rb
+- lib/ruby_chart_engine/charts/composite.rb
+- lib/ruby_chart_engine/charts/natal.rb
+- lib/ruby_chart_engine/charts/progressed.rb
+- lib/ruby_chart_engine/charts/solar_return.rb
+- lib/ruby_chart_engine/charts/transit.rb
+- lib/ruby_chart_engine/input/coordinates.rb
+- lib/ruby_chart_engine/input/datetime.rb
+- lib/ruby_chart_engine/input/timezone.rb
+- lib/ruby_chart_engine/serializers/json_serializer.rb
+- lib/ruby_chart_engine/version.rb
+homepage: https://github.com/Go-pye/astrolith
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.7
+signing_key:
+specification_version: 4
+summary: A Ruby port of immanuel-python astrology library
+test_files: []