Circular Natal Horoscope JS

To add support for a new language, you must implement the tokens in src/utilities/language.js. Copy the existing English or Spanish tokens and add them to a new key matching the desired ISO language code.

When generating the horoscope, pass the language code to the constructor to receive localized labels in the .label keys of Sign, Aspect, Planet, and House objects.

// Example usage with Spanish
new Horoscope({ language: "es" });

You can install the package via npm or yarn to use it in your project.

npm i circular-natal-horoscope-js --save

# or yarn

yarn add circular-natal-horoscope-js

You can override the default orb degrees used for aspect calculations by passing a customOrbs object to the Horoscope constructor. Keys should match the aspect type names.

import { Origin, Horoscope } from "circular-natal-horoscope-js";

const customOrbs = {
  conjunction: 8,
  opposition: 8,
  trine: 8,
  square: 7,
  sextile: 6,
  quincunx: 5,
  quintile: 1,
  septile: 1,
  "semi-square": 1,
  "semi-sextile": 1,
};

const horoscope = new Horoscope({
  origin: new Origin({...}),
  houseSystem: "whole-sign",
  zodiac: "tropical",
  aspectPoints: ['bodies', 'points', 'angles'],
  aspectWithPoints: ['bodies', 'points', 'angles'],
  aspectTypes: ["major", "minor"],
  customOrbs: customOrbs,
  language: 'en'
});

The Origin class derives the local timezone from latitude/longitude and calculates UTC time, accounting for historical daylight savings. It only supports C.E. dates (> 0).

Parameters:

• year: int (>= 0)
• month: int (0 = January, 11 = December)
• date: int (1-31)
• hour: int (0-23)
• minute: int (0-59)
• latitude: float (-90.00 to 90.00)
• longitude: float (-180.00 to 180.00)

import { Origin } from "circular-natal-horoscope-js";

const origin = new Origin({
  year: 2020,
  month: 11, // 0 = January, 11 = December!
  date: 1,
  hour: 16,
  minute: 30,
  latitude: 40.0,
  longitude: -70.0,
});

The project uses Webpack to bundle the demo application. The configuration defines an entry point at ./demo/script.js and outputs a UMD (Universal Module Definition) library named demoScript.js into the demo/dist directory. It also uses HtmlWebpackPlugin to generate demo.html from the ./demo/demo.html template.

var HtmlWebpackPlugin = require("html-webpack-plugin");
const path = require("path");

module.exports = {
  entry: {
    index: "./demo/script.js",
  },
  output: {
    filename: "demoScript.js",
    path: path.resolve(__dirname, "demo", "dist"),
    library: "[name].js",
    libraryTarget: "umd",
  },
  plugins: [
    new HtmlWebpackPlugin({
      filename: "demo.html",
      template: "./demo/demo.html",
    }),
  ],
};

Once a Horoscope instance is created, you can access the computed data through several properties:

• Angles: Contains all, ascendant, and midheaven info.
• Ascendant: Specific info for the ascendant.
• Midheaven: Specific info for the midheaven.
• Aspects: Contains all, points (organized by point), and types (organized by aspect type).
• CelestialBodies: Contains all and individual planets/asteroids (e.g., sun, moon, mercury, etc.).
• CelestialPoints: Contains all and lunar nodes/lilith (e.g., northnode, southnode, lilith).
• Houses: An array of the 12 house cusps.
• SunSign: Info about the zodiac sign the sun is in.
• ZodiacCusps: An array of the 12 zodiac cusps.

The Origin class serves as the base data component required for chart casting. It encapsulates the location and time for astronomical calculations. When instantiated, it automatically derives the local timezone from the provided latitude and longitude coordinates and calculates the corresponding UTC time, accounting for historical daylight savings time.

Note: This class only supports C.E. dates (year > 0).

import { Origin } from './Origin';

const origin = new Origin({
  year: 2023,
  month: 6, // 0 = January, 11 = December
  date: 15,
  hour: 14,
  minute: 30,
  second: 0,
  latitude: 34.0522,
  longitude: -118.2437
});

The package provides two primary classes for working with natal horoscopes: Origin and Horoscope. You can import them directly from the package entrypoint.

import { Origin, Horoscope } from 'circular-natal-horoscope-js';

Once an Origin instance is created, it provides several derived properties used for astronomical calculations:

• timezone: The timezone object derived from the latitude and longitude.
• localTime: A moment-timezone object representing the local time.
• localTimeFormatted: A string representation of the local time.
• utcTime: A moment-timezone object representing the UTC time.
• utcTimeFormatted: A string representation of the UTC time.
• julianDate: The calculated Julian Date based on the UTC time.
• localSiderealTime: The calculated Local Sidereal Time based on the Julian Date and longitude.