@magmacomputing/tempo-plugin-astro

This is a premium plugin for the Tempo library that provides precise astronomical events (Equinoxes and Solstices) and maps them to traditional season names based on hemisphere.

Installation

npm install @magmacomputing/tempo-plugin-astro

Note: This plugin requires @magmacomputing/tempo version 3.0.0 or higher.

Usage

import { Tempo } from '@magmacomputing/tempo';
import { AstroTerm } from '@magmacomputing/tempo-plugin-astro';

// A valid premium license token is required to use this plugin
// Pass the plugin to `Tempo.init` to ensure it registers securely alongside the license.
Tempo.init({ 
  license: 'YOUR_LICENSE_TOKEN',
  plugins: [AstroTerm] 
});

const t = new Tempo('2026-03-20');

// Get the Astronomical Event mapping
console.log(t.term.astro);
// Output: 'Vernal'

Response Payload

When resolving the term, the plugin intelligently returns the correct astronomical event and its corresponding traditional season based on your configured hemisphere (sphere):

{
  key: 'Vernal',     // Flips to 'Autumnal' if sphere is set to 'south'
  season: 'Spring',  // Flips to 'Autumn' if sphere is set to 'south'
  sphere: 'north',   // Flips to 'south' if sphere is set to 'south'
  event: 'Equinox',
  group: 'astronomy',
  year: 2026,
  month: 3,
  // ...
}

Did you know? t.term.astronomy.season returns the Astronomical season calculated by the precise timing of solstices and equinoxes. This will often differ from t.term.season in the core library, which uses standard Meteorological/Civil calendar boundaries (e.g., 1st of the month).

Licensing

This is a Premium plugin. Usage requires an active, cryptographically signed Tempo license token with the astro scope enabled.

For commercial licensing options, please contact Magma Computing.