Open-source calculation and data engineering

Build with transparent BMITDEE engines

Deterministic health calculations, an explainable adaptive TDEE engine, accessible Web Components, public test vectors, and a dependency-free command-line interface.

Try the playground Read documentation

The GitHub-ready source repository is included with this release. Publish it, then add its URL in /developers/config.js.

calculate-tdee.js

import { calculateTDEE } from "@bmitdee/core";

const result = calculateTDEE({
  sex: "male",
  age: 35,
  heightCm: 178,
  weightKg: 82,
  activityMultiplier: 1.55
});

console.log(result.value);
// 2731.88 kcal/day

16committed automated tests

9 groupspublic calculation vectors

0 requestsnetwork calls from SDK packages

MITopen-source software license

Package portfolio

One calculation source, several ways to use it

Package versions evolve independently from the BMITDEE website. Stable formulas can remain compatible while experimental adaptive methods improve.

@bmitdee/core v1.0.0 stable

Calculation Core

BMI, BMR, TDEE, macros, healthy-weight ranges, calorie deficits, unit conversion, and formula comparison.

API reference Run example

@bmitdee/adaptive v0.1.0 experimental

Adaptive TDEE Engine

Longitudinal trend estimation, missing-data coverage, robust outlier screening, deterministic intervals, and synthetic scenarios.

Methodology Run sample

@bmitdee/elements v0.1.0 experimental

Web Components

Six accessible, framework-independent calculator components that run locally and expose results through custom events.

Live gallery Install

@bmitdee/cli v0.1.0

Command-line interface

Run core and adaptive calculations from JSON files or stdin in scripts, CI, and reproducible workflows.

Commands

test-vectors public JSON

Validation library

Formula examples, boundary cases, conversions, macro presets, and synthetic adaptive scenarios.

Run in browser

bmitdee-js source bundle

GitHub-ready monorepo

README, license, citation, security policy, contribution guide, Actions workflows, docs, examples, tests, and release automation.

Download source ZIP Publish guide

Engineering principles

Auditable behavior instead of hidden calculator logic

{ }

Structured results

Outputs name the package, package version, formula, formula version, units, assumptions, warnings, and inputs used.

✓

Testable by design

Committed JSON vectors and synthetic scenarios make formula changes visible and reproducible.

↔

Browser and Node.js

Dependency-free ES modules work in modern browsers, server-side JavaScript, static demos, and build pipelines.

◌

Privacy-first packages

The SDK makes no network requests. User inputs remain with the host application unless that application explicitly sends them elsewhere.

Start with a working example

Inspect inputs, outputs, formula metadata, and adaptive warnings

The playground executes the same committed modules available in the downloadable repository.

Open API Playground

Release downloads

Use the complete repository or one focused package

Artifact	Version	Use	Download
`bmitdee-js`	0.1.0	Complete GitHub-ready monorepo	ZIP
`@bmitdee/core`	1.0.0	Deterministic calculation package	ZIP
`@bmitdee/adaptive`	0.1.0	Adaptive engine and synthetic generator	ZIP
`@bmitdee/elements`	0.1.0	Accessible Web Components	ZIP
`test-vectors`	2026-07-11	JSON validation library	ZIP

SHA-256 checksums are available in SHA256SUMS.txt.