# @thi.ng/math > Assorted common math functions & utilities Latest version **5.15.17** (published 2026-08-25) · Apache-2.0 license · 19.4K weekly downloads ## Install ```sh npm install @thi.ng/math pnpm add @thi.ng/math yarn add @thi.ng/math bun add @thi.ng/math ``` ## Health **Score 80/100 (A)** — status: active. Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score. ## Facts | | | |---|---| | Version | 5.15.17 | | Published | 2026-08-25 | | First published | 2018-10-17 | | Weekly downloads | 19.4K | | License | Apache-2.0 | | TypeScript types | bundled | | Module format | ESM | | Node | >=18 | | Dependencies | 1 | | Unpacked size | 95.7 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Author | Karsten Schmidt | | Maintainers | thi.ng | | Keywords | animation, bezier, cubic, easing, hermite, interpolation, interval, math, prime, quadratic, smoothmax, smoothstep, solver, trigonometry, typescript | ## Links - npm: https://www.npmjs.com/package/@thi.ng/math - Repository: https://codeberg.org/thi.ng/umbrella - Homepage: https://thi.ng/math - Funding: https://github.com/sponsors/postspectacular - npm.io page: https://npm.io/package/@thi.ng/math ## Dependencies (1) - [@thi.ng/api](https://npm.io/package/@thi.ng/api.md) ^8.12.28 ## Alternatives - [@openai/codex-sdk](https://npm.io/package/@openai/codex-sdk.md) — 731.4K weekly downloads - [babel-plugin-transform-react-jsx](https://npm.io/package/babel-plugin-transform-react-jsx.md) — 565.0K weekly downloads - [babel-helper-remove-or-void](https://npm.io/package/babel-helper-remove-or-void.md) — 508.5K weekly downloads - [@pnpm/store-controller-types](https://npm.io/package/@pnpm/store-controller-types.md) — 186.9K weekly downloads - [react-native-signature-canvas](https://npm.io/package/react-native-signature-canvas.md) — 155.6K weekly downloads ## Recent versions - 5.15.17 (latest) — 2026-08-25 - 5.15.16 — 2026-07-02 - 5.15.15 — 2026-06-05 - 5.15.14 — 2026-05-23 - 5.15.13 — 2026-05-20 - 5.15.11 — 2026-05-11 - 5.15.10 — 2026-05-08 - 5.15.9 — 2026-04-26 - 5.15.8 — 2026-04-18 - 5.15.7 — 2026-04-02 - 5.15.6 — 2026-03-19 - 5.15.5 — 2026-03-07 - 5.15.4 — 2026-03-07 - 5.15.3 — 2026-02-07 - 5.15.2 — 2026-01-23 - … 193 more at https://npm.io/package/@thi.ng/math/versions ## README # ![@thi.ng/math](https://codeberg.org/thi.ng/umbrella/media/branch/develop/assets/banners/thing-math.svg?3abd517f) [![npm version](https://img.shields.io/npm/v/@thi.ng/math.svg)](https://www.npmjs.com/package/@thi.ng/math) ![npm downloads](https://img.shields.io/npm/dm/@thi.ng/math.svg) [![Mastodon Follow](https://img.shields.io/mastodon/follow/109331703950160316?domain=https%3A%2F%2Fmastodon.thi.ng&style=social)](https://mastodon.thi.ng/@toxi) > [!NOTE] > This is one of 217 standalone projects. LLM-free, human-made and > cared for software, maintained as part of the > [@thi.ng/umbrella](https://codeberg.org/thi.ng/umbrella/) ecosystem and > anti-framework. > > 🚀 Please help me to work full-time on these projects by [sponsoring > me](https://codeberg.org/thi.ng/umbrella/src/branch/develop/CONTRIBUTING.md#donations). > Thank you! ❤️ For the Clojure version, please visit: [thi.ng/math-clj](https://thi.ng/math-clj) - [About](#about) - [Status](#status) - [Breaking changes in v4.0.0](#breaking-changes-in-v400) - [Installation](#installation) - [Dependencies](#dependencies) - [Usage examples](#usage-examples) - [API](#api) - [Authors](#authors) - [License](#license) ## About Assorted common math functions & utilities. Partially ported from Clojure version [thi.ng/math-clj](https://github.com/thi-ng/math), [c.thi.ng](https://github.com/thi-ng/c-thing) and [thi.ng/vexed-generation](https://github.com/thi-ng/vexed-generation). ## Status **STABLE** - used in production [Search or submit any issues for this package](https://codeberg.org/thi.ng/umbrella/issues?q=%5Bmath%5D) ### Breaking changes in v4.0.0 The introduction of several [standard libc math functions](https://www.cplusplus.com/reference/cmath/) causes a behavior change of the existing `fmod()` function... - rename `fmod()` => `mod()` to align w/ GLSL counterpart - add new `fmod()` w/ standard libc behavior (same as JS % op) - add `remainder()` w/ standard libc behavior ## Installation ```bash yarn add @thi.ng/math ``` ESM import: ```ts import * as math from "@thi.ng/math"; ``` Browser ESM import: ```html ``` [JSDelivr documentation](https://www.jsdelivr.com/) For Node.js REPL: ```js const math = await import("@thi.ng/math"); ``` Package sizes (brotli'd, pre-treeshake): ESM: 5.48 KB ## Dependencies - [@thi.ng/api](https://codeberg.org/thi.ng/umbrella/src/branch/develop/packages/api) Note: @thi.ng/api is in _most_ cases a type-only import (not used at runtime) ## Usage examples 13 projects in this repo's [/examples](https://codeberg.org/thi.ng/umbrella/src/branch/develop/examples) directory are using this package: | Screenshot | Description | Live demo | Source | |:-----------------------------------------------------------------------------------------------------------------------------|:-----------------------------------------------------------------------|:------------------------------------------------------------|:-------------------------------------------------------------------------------------------------| | | Basic 2D boid simulation and spatial indexing neighbor lookups | [Demo](https://demo.thi.ng/umbrella/boid-basics/) | [Source](https://codeberg.org/thi.ng/umbrella/src/branch/develop/examples/boid-basics) | | | Basic crypto-currency candle chart with multiple moving averages plots | [Demo](https://demo.thi.ng/umbrella/crypto-chart/) | [Source](https://codeberg.org/thi.ng/umbrella/src/branch/develop/examples/crypto-chart) | | | Fisheye menu list component for thi.ng/rdom | [Demo](https://demo.thi.ng/umbrella/fisheye-menu/) | [Source](https://codeberg.org/thi.ng/umbrella/src/branch/develop/examples/fisheye-menu) | | | 2D Bezier curve-guided particle system | [Demo](https://demo.thi.ng/umbrella/hdom-canvas-particles/) | [Source](https://codeberg.org/thi.ng/umbrella/src/branch/develop/examples/hdom-canvas-particles) | | | Animated sine plasma effect visualized using contour lines | [Demo](https://demo.thi.ng/umbrella/iso-plasma/) | [Source](https://codeberg.org/thi.ng/umbrella/src/branch/develop/examples/iso-plasma) | | | Worker based, interactive Mandelbrot visualization | [Demo](https://demo.thi.ng/umbrella/mandelbrot/) | [Source](https://codeberg.org/thi.ng/umbrella/src/branch/develop/examples/mandelbrot) | | | Animated, iterative polygon subdivisions & visualization | [Demo](https://demo.thi.ng/umbrella/poly-subdiv/) | [Source](https://codeberg.org/thi.ng/umbrella/src/branch/develop/examples/poly-subdiv) | | | Unison wavetable synth with waveform editor | [Demo](https://demo.thi.ng/umbrella/ramp-synth/) | [Source](https://codeberg.org/thi.ng/umbrella/src/branch/develop/examples/ramp-synth) | | | 2D scenegraph & shape picking | [Demo](https://demo.thi.ng/umbrella/scenegraph/) | [Source](https://codeberg.org/thi.ng/umbrella/src/branch/develop/examples/scenegraph) | | | 2D scenegraph & image map based geometry manipulation | [Demo](https://demo.thi.ng/umbrella/scenegraph-image/) | [Source](https://codeberg.org/thi.ng/umbrella/src/branch/develop/examples/scenegraph-image) | | | Simplistic SVG bar chart component | [Demo](https://demo.thi.ng/umbrella/svg-barchart/) | [Source](https://codeberg.org/thi.ng/umbrella/src/branch/develop/examples/svg-barchart) | | | SVG path parsing & dynamic resampling | [Demo](https://demo.thi.ng/umbrella/svg-resample/) | [Source](https://codeberg.org/thi.ng/umbrella/src/branch/develop/examples/svg-resample) | | | Interactive ridge-line plot | [Demo](https://demo.thi.ng/umbrella/viz-ridge-lines/) | [Source](https://codeberg.org/thi.ng/umbrella/src/branch/develop/examples/viz-ridge-lines) | ## API [Generated API docs](https://docs.thi.ng/umbrella/math/) TODO ## Authors - [Karsten Schmidt](https://thi.ng) (Main author) - [@nkint](https://github.com/nkint) If this project contributes to an academic publication, please cite it as: ```bibtex @misc{thing-math, title = "@thi.ng/math", author = "Karsten Schmidt and others", note = "https://thi.ng/math", year = 2013 } ``` ## License © 2013 - 2026 Karsten Schmidt // Apache License 2.0 --- _Source: https://npm.io/package/@thi.ng/math · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._