Skip to Content

Overview

The Trajectonomics packages and how they fit together.

Trajectonomics is built from small TypeScript packages. The three released ones are pure: data in, data out, no I/O, no clock and no unseeded randomness. You can adopt one package without adopting the others.

The packages

PackagePublished asWhat it gives you
sim-core@trajectonomics/simA deterministic projection of a personal-finance plan over time
ledger-core@trajectonomics/ledgerDouble-entry bookkeeping that cannot hold an unbalanced transaction
tax-core@trajectonomics/taxStatutory income tax for Thailand and the United States
design-systemnot releasedDesign tokens, Themes and components for Trajectonomics interfaces

How they fit together

  • Project what is planned. sim-core takes a Baseline of balances and a Scenario of Flows, and returns a Projection over a Timeline. It knows nothing about tax, so nothing forces an application to use tax-core.
  • Record what happened. ledger-core records Postings in a Chart of Accounts and answers Balance, Net Worth, P&L and Trial Balance questions. It never edits history: a correction adds a Reversal or an Amendment.
  • Compute the statutory amount. tax-core turns a jurisdiction-specific filing input into a Tax Result, with a Breakdown that shows how each figure was reached. Thailand and the United States are separate subpath exports, so an application bundles only the package it imports.
  • Build the interface. design-system will supply tokens, Themes and components for Trajectonomics interfaces; it has no published release yet.

The CLI is what Operators install and run. The released packages’ pages link their decisions on GitHub instead of copying them here.