math 0.0.3 → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright © 2026 Isaac Mason
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,197 @@
+# math
+
+math is a collection of math helpers for graphics and simulations.
+
+- **High performance**: allocation-free, monomorphic, benchmarked
+- **Tiny**: mean and lean, tree-shakable, only pay for what you use
+- **Portable**: interops with WebGL, WebGPU, Wasm, your favourite renderer, more.
+- **Data-oriented**: data-in, data-out functions over caller-owned data, without owning the data lifecycle.
+
+```sh
+> npm install math@canary
+```
+
+## What's inside
+
+| Import | Description | Contents |
+| --- | --- | --- |
+| [`math`](API.md#api-math) | Vectors, quaternions, euler angles & matrices | [`vec2`](API.md#api-math-vec2) [`vec3`](API.md#api-math-vec3) [`vec4`](API.md#api-math-vec4) [`euler`](API.md#api-math-euler) [`quat`](API.md#api-math-quat) [`quat2`](API.md#api-math-quat2) [`mat2`](API.md#api-math-mat2) [`mat2d`](API.md#api-math-mat2d) [`mat3`](API.md#api-math-mat3) [`mat4`](API.md#api-math-mat4) [`spherical`](API.md#api-math-spherical) [`polar`](API.md#api-math-polar) [`EPSILON`](API.md#epsilon) [`round`](API.md#round) [`equals`](API.md#equals) [`fade`](API.md#fade) [`lerp`](API.md#lerp) [`lagrange`](API.md#lagrange) [`binomial`](API.md#binomial) [`clamp`](API.md#clamp) [`repeat`](API.md#repeat) [`remap`](API.md#remap) [`remapClamp`](API.md#remapclamp) [`DEGREES_TO_RADIANS`](API.md#degrees_to_radians) [`RADIANS_TO_DEGREES`](API.md#radians_to_degrees) [`degreesToRadians`](API.md#degreestoradians) [`radiansToDegrees`](API.md#radianstodegrees) [`wrapAngle`](API.md#wrapangle) [`deltaAngle`](API.md#deltaangle) |
+| [`math/shapes`](API.md#api-math-shapes) | Shape primitives & spatial queries | [`box2`](API.md#api-math-shapes-box2) [`box3`](API.md#api-math-shapes-box3) [`obb3`](API.md#api-math-shapes-obb3) [`plane3`](API.md#api-math-shapes-plane3) [`sphere`](API.md#api-math-shapes-sphere) [`circle`](API.md#api-math-shapes-circle) [`segment2`](API.md#api-math-shapes-segment2) [`polygon2`](API.md#api-math-shapes-polygon2) [`triangle2`](API.md#api-math-shapes-triangle2) [`triangle3`](API.md#api-math-shapes-triangle3) [`raycast3`](API.md#api-math-shapes-raycast3) [`frustum`](API.md#api-math-shapes-frustum) |
+| [`math/geometry`](API.md#api-math-geometry) | Geometric algorithms | [`circumcircle`](API.md#circumcircle) [`decomposePolygon2Quick`](API.md#decomposepolygon2quick) [`decomposePolygon2Quality`](API.md#decomposepolygon2quality) [`triangulatePolygon2`](API.md#triangulatepolygon2) [`quickhull2`](API.md#quickhull2) [`quickhull3`](API.md#quickhull3) |
+| [`math/time`](API.md#api-math-time) | Easing & spring animation | [`easing`](API.md#api-math-time-easing) [`spring`](API.md#api-math-time-spring) [`spring2`](API.md#api-math-time-spring2) [`spring3`](API.md#api-math-time-spring3) [`spring4`](API.md#api-math-time-spring4) |
+| [`math/random`](API.md#api-math-random) | Seeded random number generators | [`isaac32`](API.md#api-math-random-isaac32) [`isaac64`](API.md#api-math-random-isaac64) [`mulberry32`](API.md#api-math-random-mulberry32) [`random`](API.md#api-math-random-random) |
+| [`math/noise`](API.md#api-math-noise) | Perlin, simplex & worley noise, plus fractal helpers | [`perlin2d`](API.md#api-math-noise-perlin2d) [`perlin3d`](API.md#api-math-noise-perlin3d) [`simplex2d`](API.md#api-math-noise-simplex2d) [`simplex3d`](API.md#api-math-noise-simplex3d) [`simplex4d`](API.md#api-math-noise-simplex4d) [`worley2d`](API.md#api-math-noise-worley2d) [`worley3d`](API.md#api-math-noise-worley3d) [`fbm`](API.md#fbm) [`ridged`](API.md#ridged) [`billow`](API.md#billow) [`domainWarp2`](API.md#domainwarp2) [`domainWarp3`](API.md#domainwarp3) [`curl2`](API.md#curl2) [`curl3`](API.md#curl3) |
+| [`math/color`](API.md#api-math-color) | Color & colorspace utilities | [`color`](API.md#api-math-color-color) [`colorspace`](API.md#api-math-color-colorspace) [`hsl`](API.md#api-math-color-hsl) |
+| [`math/ik`](API.md#api-math-ik) | Inverse kinematics | [`fabrik2`](API.md#api-math-ik-fabrik2) [`fabrik3`](API.md#api-math-ik-fabrik3) |
+
+
+## Quick Start
+
+```ts
+import { type Vec3, vec3 } from 'math';
+
+// math types are plain arrays — the constructors just return literals:
+const a: Vec3 = [1, 2, 3]; // a plain-array literal
+const b = vec3.fromValues(1, 2, 3); // the same as `a`
+const out = vec3.create(); // returns [0, 0, 0]
+
+// functions write into their first argument, so nothing is allocated:
+vec3.add(out, a, b); // out = [2, 4, 6]
+vec3.normalize(out, out); // aliasing an argument is fine
+```
+
+The library is grouped by domain behind subpath entrypoints. All APIs are highly tree-shakeable, only pay for what you use:
+
+```ts
+import { mat4, quat, vec3 } from 'math'; // core: vectors, quats, matrices
+import { simplex3d } from 'math/noise'; // perlin / simplex noise
+import { mulberry32 } from 'math/random'; // seeded rng
+import { easing, spring } from 'math/time'; // easings & springs
+import { fabrik2, fabrik3 } from 'math/ik'; // inverse kinematics
+// also: math/color, math/geometry, math/shapes — import only what you use
+```
+
+## Examples
+
+<table>
+  <tr>
+    <td align="center">
+      <a href="https://pmndrs.github.io/math/examples/#example-look-at">
+        <img src="./examples/public/screenshots/example-look-at.png" width="180" height="120" style="object-fit:cover;"/><br/>
+        Look At
+      </a>
+    </td>
+    <td align="center">
+      <a href="https://pmndrs.github.io/math/examples/#example-fibonacci-sphere">
+        <img src="./examples/public/screenshots/example-fibonacci-sphere.png" width="180" height="120" style="object-fit:cover;"/><br/>
+        Fibonacci Sphere
+      </a>
+    </td>
+    <td align="center">
+      <a href="https://pmndrs.github.io/math/examples/#example-contains-point">
+        <img src="./examples/public/screenshots/example-contains-point.png" width="180" height="120" style="object-fit:cover;"/><br/>
+        Contains Point
+      </a>
+    </td>
+  </tr>
+  <tr>
+    <td align="center">
+      <a href="https://pmndrs.github.io/math/examples/#example-convex-hull-3d">
+        <img src="./examples/public/screenshots/example-convex-hull-3d.png" width="180" height="120" style="object-fit:cover;"/><br/>
+        Convex Hull 3D
+      </a>
+    </td>
+    <td align="center">
+      <a href="https://pmndrs.github.io/math/examples/#example-convex-hull-2d">
+        <img src="./examples/public/screenshots/example-convex-hull-2d.png" width="180" height="120" style="object-fit:cover;"/><br/>
+        Convex Hull 2D
+      </a>
+    </td>
+    <td align="center">
+      <a href="https://pmndrs.github.io/math/examples/#example-polygon2-decomposition">
+        <img src="./examples/public/screenshots/example-polygon2-decomposition.png" width="180" height="120" style="object-fit:cover;"/><br/>
+        Polygon2 Decomposition
+      </a>
+    </td>
+  </tr>
+  <tr>
+    <td align="center">
+      <a href="https://pmndrs.github.io/math/examples/#example-polygon2-triangulation">
+        <img src="./examples/public/screenshots/example-polygon2-triangulation.png" width="180" height="120" style="object-fit:cover;"/><br/>
+        Polygon2 Triangulation
+      </a>
+    </td>
+    <td align="center">
+      <a href="https://pmndrs.github.io/math/examples/#example-circumcircle">
+        <img src="./examples/public/screenshots/example-circumcircle.png" width="180" height="120" style="object-fit:cover;"/><br/>
+        Circumcircle
+      </a>
+    </td>
+    <td align="center">
+      <a href="https://pmndrs.github.io/math/examples/#example-fabrik-2d">
+        <img src="./examples/public/screenshots/example-fabrik-2d.png" width="180" height="120" style="object-fit:cover;"/><br/>
+        FABRIK 2D
+      </a>
+    </td>
+  </tr>
+  <tr>
+    <td align="center">
+      <a href="https://pmndrs.github.io/math/examples/#example-fabrik-2d-snek">
+        <img src="./examples/public/screenshots/example-fabrik-2d-snek.png" width="180" height="120" style="object-fit:cover;"/><br/>
+        FABRIK 2D Snek
+      </a>
+    </td>
+    <td align="center">
+      <a href="https://pmndrs.github.io/math/examples/#example-fabrik-3d">
+        <img src="./examples/public/screenshots/example-fabrik-3d.png" width="180" height="120" style="object-fit:cover;"/><br/>
+        FABRIK 3D
+      </a>
+    </td>
+    <td align="center">
+      <a href="https://pmndrs.github.io/math/examples/#example-flow-field">
+        <img src="./examples/public/screenshots/example-flow-field.png" width="180" height="120" style="object-fit:cover;"/><br/>
+        Flow Field
+      </a>
+    </td>
+  </tr>
+  <tr>
+    <td align="center">
+      <a href="https://pmndrs.github.io/math/examples/#example-color-wheel">
+        <img src="./examples/public/screenshots/example-color-wheel.png" width="180" height="120" style="object-fit:cover;"/><br/>
+        Color Wheel
+      </a>
+    </td>
+    <td align="center">
+      <a href="https://pmndrs.github.io/math/examples/#example-ridged-noise-voxel-terrain">
+        <img src="./examples/public/screenshots/example-ridged-noise-voxel-terrain.png" width="180" height="120" style="object-fit:cover;"/><br/>
+        Ridged Noise Voxel Terrain
+      </a>
+    </td>
+    <td align="center">
+      <a href="https://pmndrs.github.io/math/examples/#example-simplex-4d-looping-noise">
+        <img src="./examples/public/screenshots/example-simplex-4d-looping-noise.png" width="180" height="120" style="object-fit:cover;"/><br/>
+        Simplex 4D Looping Noise
+      </a>
+    </td>
+  </tr>
+  <tr>
+    <td align="center">
+      <a href="https://pmndrs.github.io/math/examples/#example-simplex-2d-noise-terrain">
+        <img src="./examples/public/screenshots/example-simplex-2d-noise-terrain.png" width="180" height="120" style="object-fit:cover;"/><br/>
+        Simplex 2D Noise Terrain
+      </a>
+    </td>
+    <td align="center">
+      <a href="https://pmndrs.github.io/math/examples/#example-quaternion-slerp">
+        <img src="./examples/public/screenshots/example-quaternion-slerp.png" width="180" height="120" style="object-fit:cover;"/><br/>
+        Quaternion Slerp
+      </a>
+    </td>
+    <td align="center">
+      <a href="https://pmndrs.github.io/math/examples/#example-spring">
+        <img src="./examples/public/screenshots/example-spring.png" width="180" height="120" style="object-fit:cover;"/><br/>
+        Spring
+      </a>
+    </td>
+  </tr>
+  <tr>
+    <td align="center">
+      <a href="https://pmndrs.github.io/math/examples/#example-easing">
+        <img src="./examples/public/screenshots/example-easing.png" width="180" height="120" style="object-fit:cover;"/><br/>
+        Easing
+      </a>
+    </td>
+  </tr>
+</table>
+
+## Documentation
+
+- **[API.md](./API.md)** — every export with its signature and a one-line description, grouped by module. Flat and greppable, so it's easy to search or hand to an AI coding assistant.
+- **[Online API docs](https://pmndrs.github.io/math/docs/)** — the full typedoc reference, with search and cross-links.
+- **[What's inside](#whats-inside)** — jump straight to a module or namespace.
+
+## Acknowledgements:
+
+- The vec*, quat*, mat* code started life as a port of mathcat, which started as a TypeScript port of glMatrix (https://glmatrix.net/)
+- The simplex noise is adapted from https://github.com/josephg/noisejs
+- Thank you [@kaleb](https://github.com/kaleb) for the npm package name!

package/dist/color/color.js

@@ -0,0 +1,136 @@
+import { srgbToLinear, linearToSrgb } from './colorspace.js';
+export { fromColorInput, setFromColorInput } from './parse.js';
+
+/** Create a new Color initialized to black [0, 0, 0]. */
+function create() {
+    return [0, 0, 0];
+}
+/** Create a new Color with the given linear r, g, b values. */
+function fromValues(r, g, b) {
+    return [r, g, b];
+}
+/** Create a new Color that is a copy of `c`. */
+function clone(c) {
+    return [c[0], c[1], c[2]];
+}
+/** Copy the values from `src` into `out`. Returns `out`. */
+function copy(out, src) {
+    out[0] = src[0];
+    out[1] = src[1];
+    out[2] = src[2];
+    return out;
+}
+/** Set the linear r, g, b components of `out` directly. Returns `out`. */
+function set(out, r, g, b) {
+    out[0] = r;
+    out[1] = g;
+    out[2] = b;
+    return out;
+}
+/** Set all three channels of `out` to the same linear value `s` (a gray). Returns `out`. */
+function setScalar(out, s) {
+    out[0] = s;
+    out[1] = s;
+    out[2] = s;
+    return out;
+}
+/**
+ * Set `out` from an sRGB gamma-encoded [r, g, b] array with values in [0, 1].
+ * Converts from sRGB gamma space to linear. Returns `out`.
+ */
+function setFromSRGB(out, srgb) {
+    out[0] = srgbToLinear(srgb[0]);
+    out[1] = srgbToLinear(srgb[1]);
+    out[2] = srgbToLinear(srgb[2]);
+    return out;
+}
+/** Create a new Color from an sRGB gamma-encoded [r, g, b] array with values in [0, 1]. */
+function fromSRGB(srgb) {
+    return setFromSRGB(create(), srgb);
+}
+/** Write the sRGB gamma-encoded [r, g, b] of a linear Color into `out` (values [0, 1]). */
+function toSRGB(out, c) {
+    out[0] = linearToSrgb(c[0]);
+    out[1] = linearToSrgb(c[1]);
+    out[2] = linearToSrgb(c[2]);
+    return out;
+}
+/** Create a CSS `rgb(...)` string in sRGB gamma space (for HTML/canvas use). */
+function toCSS(c) {
+    return `rgb(${to255(c[0])}, ${to255(c[1])}, ${to255(c[2])})`;
+}
+/** Convert to a 0xRRGGBB integer in sRGB gamma space. */
+function toHex(c) {
+    return (to255(c[0]) << 16) | (to255(c[1]) << 8) | to255(c[2]);
+}
+/** Convert to a 6-digit sRGB hex string without a leading '#', e.g. 'ff8800'. */
+function toHexString(c) {
+    return toHex(c).toString(16).padStart(6, '0');
+}
+/** Add `a + b` component-wise into `out`. Returns `out`. */
+function add(out, a, b) {
+    out[0] = a[0] + b[0];
+    out[1] = a[1] + b[1];
+    out[2] = a[2] + b[2];
+    return out;
+}
+/** Add scalar `s` to each channel of `a` into `out`. Returns `out`. */
+function addScalar(out, a, s) {
+    out[0] = a[0] + s;
+    out[1] = a[1] + s;
+    out[2] = a[2] + s;
+    return out;
+}
+/** Subtract `a - b` component-wise into `out`. Returns `out`. */
+function sub(out, a, b) {
+    out[0] = a[0] - b[0];
+    out[1] = a[1] - b[1];
+    out[2] = a[2] - b[2];
+    return out;
+}
+/** Multiply `a * b` component-wise into `out` (tinting). Returns `out`. */
+function multiply(out, a, b) {
+    out[0] = a[0] * b[0];
+    out[1] = a[1] * b[1];
+    out[2] = a[2] * b[2];
+    return out;
+}
+/** Scale each channel of `a` by `s` into `out` (brightness). Returns `out`. */
+function multiplyScalar(out, a, s) {
+    out[0] = a[0] * s;
+    out[1] = a[1] * s;
+    out[2] = a[2] * s;
+    return out;
+}
+/** Linearly interpolate from `a` to `b` by `t` into `out` (physically-correct blend). Returns `out`. */
+function lerp(out, a, b, t) {
+    out[0] = a[0] + (b[0] - a[0]) * t;
+    out[1] = a[1] + (b[1] - a[1]) * t;
+    out[2] = a[2] + (b[2] - a[2]) * t;
+    return out;
+}
+/** Clamp each channel of `c` to [0, 1] into `out`. Returns `out`. */
+function clamp(out, c) {
+    out[0] = clamp01(c[0]);
+    out[1] = clamp01(c[1]);
+    out[2] = clamp01(c[2]);
+    return out;
+}
+/** Whether `a` and `b` are equal, within an optional per-channel `epsilon` (default exact). */
+function equals(a, b, epsilon = 0) {
+    return Math.abs(a[0] - b[0]) <= epsilon && Math.abs(a[1] - b[1]) <= epsilon && Math.abs(a[2] - b[2]) <= epsilon;
+}
+/** Relative luminance in [0, 1] (Rec. 709 weights, on linear light). */
+function luminance(c) {
+    return 0.2126 * c[0] + 0.7152 * c[1] + 0.0722 * c[2];
+}
+function clamp01(x) {
+    return x < 0 ? 0 : x > 1 ? 1 : x;
+}
+/** linear channel -> clamped sRGB byte [0, 255]. */
+function to255(c) {
+    return Math.max(0, Math.min(255, Math.round(linearToSrgb(c) * 255)));
+}
+
+export { add, addScalar, clamp, clone, copy, create, equals, fromSRGB, fromValues, lerp, luminance, multiply, multiplyScalar, set, setFromSRGB, setScalar, sub, toCSS, toHex, toHexString, toSRGB };
+//# sourceMappingURL=color.js.map

package/dist/color/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sources":["../../src/color/color.ts"],"sourcesContent":["import { linearToSrgb, srgbToLinear } from './colorspace';\n\nexport * from './parse';\n\n/** A linear-sRGB color: [r, g, b] floats in [0, 1]. */\nexport type Color = [r: number, g: number, b: number];\n\n/** Accepted input types for creating or parsing a Color. */\nexport type ColorInput =\n    | string // '#f00', '#ff0000', 'red', 'rgb(255,0,0)', 'hsl(0,100%,50%)'\n    | number // 0xff0000 integer (sRGB gamma)\n    | [number, number, number]; // [r, g, b] linear floats [0, 1]\n\n/** Create a new Color initialized to black [0, 0, 0]. */\nexport function create(): Color {\n    return [0, 0, 0];\n}\n\n/** Create a new Color with the given linear r, g, b values. */\nexport function fromValues(r: number, g: number, b: number): Color {\n    return [r, g, b];\n}\n\n/** Create a new Color that is a copy of `c`. */\nexport function clone(c: Color): Color {\n    return [c[0], c[1], c[2]];\n}\n\n/** Copy the values from `src` into `out`. Returns `out`. */\nexport function copy(out: Color, src: Color): Color {\n    out[0] = src[0];\n    out[1] = src[1];\n    out[2] = src[2];\n    return out;\n}\n\n/** Set the linear r, g, b components of `out` directly. Returns `out`. */\nexport function set(out: Color, r: number, g: number, b: number): Color {\n    out[0] = r;\n    out[1] = g;\n    out[2] = b;\n    return out;\n}\n\n/** Set all three channels of `out` to the same linear value `s` (a gray). Returns `out`. */\nexport function setScalar(out: Color, s: number): Color {\n    out[0] = s;\n    out[1] = s;\n    out[2] = s;\n    return out;\n}\n\n/**\n * Set `out` from an sRGB gamma-encoded [r, g, b] array with values in [0, 1].\n * Converts from sRGB gamma space to linear. Returns `out`.\n */\nexport function setFromSRGB(out: Color, srgb: [number, number, number]): Color {\n    out[0] = srgbToLinear(srgb[0]);\n    out[1] = srgbToLinear(srgb[1]);\n    out[2] = srgbToLinear(srgb[2]);\n    return out;\n}\n\n/** Create a new Color from an sRGB gamma-encoded [r, g, b] array with values in [0, 1]. */\nexport function fromSRGB(srgb: [number, number, number]): Color {\n    return setFromSRGB(create(), srgb);\n}\n\n/** Write the sRGB gamma-encoded [r, g, b] of a linear Color into `out` (values [0, 1]). */\nexport function toSRGB(out: [number, number, number], c: Color): [number, number, number] {\n    out[0] = linearToSrgb(c[0]);\n    out[1] = linearToSrgb(c[1]);\n    out[2] = linearToSrgb(c[2]);\n    return out;\n}\n\n/** Create a CSS `rgb(...)` string in sRGB gamma space (for HTML/canvas use). */\nexport function toCSS(c: Color): string {\n    return `rgb(${to255(c[0])}, ${to255(c[1])}, ${to255(c[2])})`;\n}\n\n/** Convert to a 0xRRGGBB integer in sRGB gamma space. */\nexport function toHex(c: Color): number {\n    return (to255(c[0]) << 16) | (to255(c[1]) << 8) | to255(c[2]);\n}\n\n/** Convert to a 6-digit sRGB hex string without a leading '#', e.g. 'ff8800'. */\nexport function toHexString(c: Color): string {\n    return toHex(c).toString(16).padStart(6, '0');\n}\n\n/** Add `a + b` component-wise into `out`. Returns `out`. */\nexport function add(out: Color, a: Color, b: Color): Color {\n    out[0] = a[0] + b[0];\n    out[1] = a[1] + b[1];\n    out[2] = a[2] + b[2];\n    return out;\n}\n\n/** Add scalar `s` to each channel of `a` into `out`. Returns `out`. */\nexport function addScalar(out: Color, a: Color, s: number): Color {\n    out[0] = a[0] + s;\n    out[1] = a[1] + s;\n    out[2] = a[2] + s;\n    return out;\n}\n\n/** Subtract `a - b` component-wise into `out`. Returns `out`. */\nexport function sub(out: Color, a: Color, b: Color): Color {\n    out[0] = a[0] - b[0];\n    out[1] = a[1] - b[1];\n    out[2] = a[2] - b[2];\n    return out;\n}\n\n/** Multiply `a * b` component-wise into `out` (tinting). Returns `out`. */\nexport function multiply(out: Color, a: Color, b: Color): Color {\n    out[0] = a[0] * b[0];\n    out[1] = a[1] * b[1];\n    out[2] = a[2] * b[2];\n    return out;\n}\n\n/** Scale each channel of `a` by `s` into `out` (brightness). Returns `out`. */\nexport function multiplyScalar(out: Color, a: Color, s: number): Color {\n    out[0] = a[0] * s;\n    out[1] = a[1] * s;\n    out[2] = a[2] * s;\n    return out;\n}\n\n/** Linearly interpolate from `a` to `b` by `t` into `out` (physically-correct blend). Returns `out`. */\nexport function lerp(out: Color, a: Color, b: Color, t: number): Color {\n    out[0] = a[0] + (b[0] - a[0]) * t;\n    out[1] = a[1] + (b[1] - a[1]) * t;\n    out[2] = a[2] + (b[2] - a[2]) * t;\n    return out;\n}\n\n/** Clamp each channel of `c` to [0, 1] into `out`. Returns `out`. */\nexport function clamp(out: Color, c: Color): Color {\n    out[0] = clamp01(c[0]);\n    out[1] = clamp01(c[1]);\n    out[2] = clamp01(c[2]);\n    return out;\n}\n\n/** Whether `a` and `b` are equal, within an optional per-channel `epsilon` (default exact). */\nexport function equals(a: Color, b: Color, epsilon = 0): boolean {\n    return Math.abs(a[0] - b[0]) <= epsilon && Math.abs(a[1] - b[1]) <= epsilon && Math.abs(a[2] - b[2]) <= epsilon;\n}\n\n/** Relative luminance in [0, 1] (Rec. 709 weights, on linear light). */\nexport function luminance(c: Color): number {\n    return 0.2126 * c[0] + 0.7152 * c[1] + 0.0722 * c[2];\n}\n\nfunction clamp01(x: number): number {\n    return x < 0 ? 0 : x > 1 ? 1 : x;\n}\n\n/** linear channel -> clamped sRGB byte [0, 255]. */\nfunction to255(c: number): number {\n    return Math.max(0, Math.min(255, Math.round(linearToSrgb(c) * 255)));\n}\n"],"names":[],"mappings":"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"}

package/dist/color/colorspace.js

@@ -0,0 +1,43 @@
+// Color-space conversions (pure functions — no global working-space state).
+//
+// math's Color is stored in linear sRGB. Two kinds of conversion live here:
+//   - transfer functions: encode/decode a channel's gamma (sRGB <-> linear)
+//   - gamut conversions:   move between primaries (linear sRGB <-> linear Display-P3)
+// Display-P3 uses the same sRGB transfer curve, so only the primaries differ.
+/** Convert a single sRGB gamma-encoded channel [0, 1] to linear light [0, 1]. */
+function srgbToLinear(c) {
+    return c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+}
+/** Convert a single linear light channel [0, 1] to sRGB gamma-encoded [0, 1]. */
+function linearToSrgb(c) {
+    return c <= 0.0031308 ? 12.92 * c : 1.055 * c ** (1 / 2.4) - 0.055;
+}
+/**
+ * Convert a linear-sRGB Color to linear Display-P3 primaries, into `out`. Returns `out`.
+ * (Both spaces share the sRGB transfer curve; this changes only the primaries.)
+ */
+function linearSrgbToLinearDisplayP3(out, c) {
+    const r = c[0];
+    const g = c[1];
+    const b = c[2];
+    out[0] = 0.8224621 * r + 0.177538 * g;
+    out[1] = 0.0331941 * r + 0.9668058 * g;
+    out[2] = 0.0170827 * r + 0.0723974 * g + 0.9105199 * b;
+    return out;
+}
+/**
+ * Convert a linear Display-P3 Color to linear-sRGB primaries, into `out`. Returns `out`.
+ * Colors outside the sRGB gamut yield channels outside [0, 1] — clamp if needed.
+ */
+function linearDisplayP3ToLinearSrgb(out, c) {
+    const r = c[0];
+    const g = c[1];
+    const b = c[2];
+    out[0] = 1.2249401 * r - 0.2249404 * g;
+    out[1] = -0.0420569 * r + 1.0420571 * g;
+    out[2] = -0.0196376 * r - 0.0786361 * g + 1.0982735 * b;
+    return out;
+}
+
+export { linearDisplayP3ToLinearSrgb, linearSrgbToLinearDisplayP3, linearToSrgb, srgbToLinear };
+//# sourceMappingURL=colorspace.js.map

package/dist/color/colorspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorspace.js","sources":["../../src/color/colorspace.ts"],"sourcesContent":["import type { Color } from './color';\n\n// Color-space conversions (pure functions — no global working-space state).\n//\n// math's Color is stored in linear sRGB. Two kinds of conversion live here:\n//   - transfer functions: encode/decode a channel's gamma (sRGB <-> linear)\n//   - gamut conversions:   move between primaries (linear sRGB <-> linear Display-P3)\n// Display-P3 uses the same sRGB transfer curve, so only the primaries differ.\n\n/** Convert a single sRGB gamma-encoded channel [0, 1] to linear light [0, 1]. */\nexport function srgbToLinear(c: number): number {\n    return c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;\n}\n\n/** Convert a single linear light channel [0, 1] to sRGB gamma-encoded [0, 1]. */\nexport function linearToSrgb(c: number): number {\n    return c <= 0.0031308 ? 12.92 * c : 1.055 * c ** (1 / 2.4) - 0.055;\n}\n\n/**\n * Convert a linear-sRGB Color to linear Display-P3 primaries, into `out`. Returns `out`.\n * (Both spaces share the sRGB transfer curve; this changes only the primaries.)\n */\nexport function linearSrgbToLinearDisplayP3(out: Color, c: Color): Color {\n    const r = c[0];\n    const g = c[1];\n    const b = c[2];\n    out[0] = 0.8224621 * r + 0.177538 * g;\n    out[1] = 0.0331941 * r + 0.9668058 * g;\n    out[2] = 0.0170827 * r + 0.0723974 * g + 0.9105199 * b;\n    return out;\n}\n\n/**\n * Convert a linear Display-P3 Color to linear-sRGB primaries, into `out`. Returns `out`.\n * Colors outside the sRGB gamut yield channels outside [0, 1] — clamp if needed.\n */\nexport function linearDisplayP3ToLinearSrgb(out: Color, c: Color): Color {\n    const r = c[0];\n    const g = c[1];\n    const b = c[2];\n    out[0] = 1.2249401 * r - 0.2249404 * g;\n    out[1] = -0.0420569 * r + 1.0420571 * g;\n    out[2] = -0.0196376 * r - 0.0786361 * g + 1.0982735 * b;\n    return out;\n}\n"],"names":[],"mappings":"AAEA;AACA;AACA;AACA;AACA;AACA;AAEA;AACM,SAAU,YAAY,CAAC,CAAS,EAAA;IAClC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,KAAK,KAAK,GAAG;AAClE;AAEA;AACM,SAAU,YAAY,CAAC,CAAS,EAAA;IAClC,OAAO,CAAC,IAAI,SAAS,GAAG,KAAK,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,KAAK;AACtE;AAEA;;;AAGG;AACG,SAAU,2BAA2B,CAAC,GAAU,EAAE,CAAQ,EAAA;AAC5D,IAAA,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACd,IAAA,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACd,IAAA,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACd,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,CAAC,GAAG,QAAQ,GAAG,CAAC;IACrC,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC;AACtC,IAAA,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC;AACtD,IAAA,OAAO,GAAG;AACd;AAEA;;;AAGG;AACG,SAAU,2BAA2B,CAAC,GAAU,EAAE,CAAQ,EAAA;AAC5D,IAAA,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACd,IAAA,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACd,IAAA,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACd,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC;AACtC,IAAA,GAAG,CAAC,CAAC,CAAC,GAAG,UAAU,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC;AACvC,IAAA,GAAG,CAAC,CAAC,CAAC,GAAG,UAAU,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC;AACvD,IAAA,OAAO,GAAG;AACd;;;;"}

package/dist/color/hsl.js

@@ -0,0 +1,123 @@
+import { linearToSrgb, srgbToLinear } from './colorspace.js';
+
+/** Create a new HSL initialized to [0, 0, 0] (black). */
+function create() {
+    return [0, 0, 0];
+}
+/** Create a new HSL with the given h, s, l values (all in [0, 1]). */
+function fromValues(h, s, l) {
+    return [h, s, l];
+}
+/** Create a new HSL that is a copy of `a`. */
+function clone(a) {
+    return [a[0], a[1], a[2]];
+}
+/** Copy the values from `src` into `out`. Returns `out`. */
+function copy(out, src) {
+    out[0] = src[0];
+    out[1] = src[1];
+    out[2] = src[2];
+    return out;
+}
+/** Set the h, s, l components of `out` directly. Returns `out`. */
+function set(out, h, s, l) {
+    out[0] = h;
+    out[1] = s;
+    out[2] = l;
+    return out;
+}
+/** Write the HSL of a linear Color into `out`. Returns `out`. */
+function fromColor(out, c) {
+    // linear -> sRGB gamma; HSL is defined on gamma-encoded sRGB
+    const r = linearToSrgb(c[0]);
+    const g = linearToSrgb(c[1]);
+    const b = linearToSrgb(c[2]);
+    const max = Math.max(r, g, b);
+    const min = Math.min(r, g, b);
+    const l = (max + min) / 2;
+    let h = 0;
+    let s = 0;
+    if (max !== min) {
+        const d = max - min;
+        s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+        if (max === r)
+            h = (g - b) / d + (g < b ? 6 : 0);
+        else if (max === g)
+            h = (b - r) / d + 2;
+        else
+            h = (r - g) / d + 4;
+        h /= 6;
+    }
+    out[0] = h;
+    out[1] = s;
+    out[2] = l;
+    return out;
+}
+/** Write the linear Color of an HSL into `out`. Returns `out`. */
+function toColor(out, a) {
+    const h = a[0];
+    const s = a[1];
+    const l = a[2];
+    if (s === 0) {
+        const v = srgbToLinear(l);
+        out[0] = v;
+        out[1] = v;
+        out[2] = v;
+        return out;
+    }
+    const q = l < 0.5 ? l * (1 + s) : l + s - l * s;
+    const p = 2 * l - q;
+    out[0] = srgbToLinear(hue(p, q, h + 1 / 3));
+    out[1] = srgbToLinear(hue(p, q, h));
+    out[2] = srgbToLinear(hue(p, q, h - 1 / 3));
+    return out;
+}
+/**
+ * Interpolate from `a` to `b` by `t` into `out`, taking the shortest path around
+ * the hue wheel (so e.g. 350°→10° passes through 0°, not all the way back).
+ * Returns `out`.
+ */
+function lerp(out, a, b, t) {
+    let dh = b[0] - a[0];
+    if (dh > 0.5)
+        dh -= 1;
+    else if (dh < -0.5)
+        dh += 1;
+    let h = a[0] + dh * t;
+    h -= Math.floor(h); // wrap into [0, 1)
+    out[0] = h;
+    out[1] = a[1] + (b[1] - a[1]) * t;
+    out[2] = a[2] + (b[2] - a[2]) * t;
+    return out;
+}
+/**
+ * Offset `a` by (dh, ds, dl) into `out`: hue wraps into [0, 1), saturation and
+ * lightness are clamped to [0, 1]. Returns `out`.
+ */
+function offset(out, a, dh, ds, dl) {
+    let h = a[0] + dh;
+    h -= Math.floor(h);
+    out[0] = h;
+    out[1] = clamp01(a[1] + ds);
+    out[2] = clamp01(a[2] + dl);
+    return out;
+}
+function clamp01(x) {
+    return x < 0 ? 0 : x > 1 ? 1 : x;
+}
+function hue(p, q, t) {
+    if (t < 0)
+        t += 1;
+    if (t > 1)
+        t -= 1;
+    if (t < 1 / 6)
+        return p + (q - p) * 6 * t;
+    if (t < 1 / 2)
+        return q;
+    if (t < 2 / 3)
+        return p + (q - p) * (2 / 3 - t) * 6;
+    return p;
+}
+
+export { clone, copy, create, fromColor, fromValues, lerp, offset, set, toColor };
+//# sourceMappingURL=hsl.js.map

package/dist/color/hsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hsl.js","sources":["../../src/color/hsl.ts"],"sourcesContent":["import type { Color } from './color';\nimport { linearToSrgb, srgbToLinear } from './colorspace';\n\n/** A hue-saturation-lightness color: [h, s, l], all in [0, 1] (hue wraps). */\nexport type HSL = [hue: number, saturation: number, lightness: number];\n\n/** Create a new HSL initialized to [0, 0, 0] (black). */\nexport function create(): HSL {\n    return [0, 0, 0];\n}\n\n/** Create a new HSL with the given h, s, l values (all in [0, 1]). */\nexport function fromValues(h: number, s: number, l: number): HSL {\n    return [h, s, l];\n}\n\n/** Create a new HSL that is a copy of `a`. */\nexport function clone(a: HSL): HSL {\n    return [a[0], a[1], a[2]];\n}\n\n/** Copy the values from `src` into `out`. Returns `out`. */\nexport function copy(out: HSL, src: HSL): HSL {\n    out[0] = src[0];\n    out[1] = src[1];\n    out[2] = src[2];\n    return out;\n}\n\n/** Set the h, s, l components of `out` directly. Returns `out`. */\nexport function set(out: HSL, h: number, s: number, l: number): HSL {\n    out[0] = h;\n    out[1] = s;\n    out[2] = l;\n    return out;\n}\n\n/** Write the HSL of a linear Color into `out`. Returns `out`. */\nexport function fromColor(out: HSL, c: Color): HSL {\n    // linear -> sRGB gamma; HSL is defined on gamma-encoded sRGB\n    const r = linearToSrgb(c[0]);\n    const g = linearToSrgb(c[1]);\n    const b = linearToSrgb(c[2]);\n\n    const max = Math.max(r, g, b);\n    const min = Math.min(r, g, b);\n    const l = (max + min) / 2;\n\n    let h = 0;\n    let s = 0;\n    if (max !== min) {\n        const d = max - min;\n        s = l > 0.5 ? d / (2 - max - min) : d / (max + min);\n        if (max === r) h = (g - b) / d + (g < b ? 6 : 0);\n        else if (max === g) h = (b - r) / d + 2;\n        else h = (r - g) / d + 4;\n        h /= 6;\n    }\n\n    out[0] = h;\n    out[1] = s;\n    out[2] = l;\n    return out;\n}\n\n/** Write the linear Color of an HSL into `out`. Returns `out`. */\nexport function toColor(out: Color, a: HSL): Color {\n    const h = a[0];\n    const s = a[1];\n    const l = a[2];\n\n    if (s === 0) {\n        const v = srgbToLinear(l);\n        out[0] = v;\n        out[1] = v;\n        out[2] = v;\n        return out;\n    }\n\n    const q = l < 0.5 ? l * (1 + s) : l + s - l * s;\n    const p = 2 * l - q;\n    out[0] = srgbToLinear(hue(p, q, h + 1 / 3));\n    out[1] = srgbToLinear(hue(p, q, h));\n    out[2] = srgbToLinear(hue(p, q, h - 1 / 3));\n    return out;\n}\n\n/**\n * Interpolate from `a` to `b` by `t` into `out`, taking the shortest path around\n * the hue wheel (so e.g. 350°→10° passes through 0°, not all the way back).\n * Returns `out`.\n */\nexport function lerp(out: HSL, a: HSL, b: HSL, t: number): HSL {\n    let dh = b[0] - a[0];\n    if (dh > 0.5) dh -= 1;\n    else if (dh < -0.5) dh += 1;\n\n    let h = a[0] + dh * t;\n    h -= Math.floor(h); // wrap into [0, 1)\n\n    out[0] = h;\n    out[1] = a[1] + (b[1] - a[1]) * t;\n    out[2] = a[2] + (b[2] - a[2]) * t;\n    return out;\n}\n\n/**\n * Offset `a` by (dh, ds, dl) into `out`: hue wraps into [0, 1), saturation and\n * lightness are clamped to [0, 1]. Returns `out`.\n */\nexport function offset(out: HSL, a: HSL, dh: number, ds: number, dl: number): HSL {\n    let h = a[0] + dh;\n    h -= Math.floor(h);\n    out[0] = h;\n    out[1] = clamp01(a[1] + ds);\n    out[2] = clamp01(a[2] + dl);\n    return out;\n}\n\nfunction clamp01(x: number): number {\n    return x < 0 ? 0 : x > 1 ? 1 : x;\n}\n\nfunction hue(p: number, q: number, t: number): number {\n    if (t < 0) t += 1;\n    if (t > 1) t -= 1;\n    if (t < 1 / 6) return p + (q - p) * 6 * t;\n    if (t < 1 / 2) return q;\n    if (t < 2 / 3) return p + (q - p) * (2 / 3 - t) * 6;\n    return p;\n}\n"],"names":[],"mappings":"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"}

package/dist/color/index.js

@@ -0,0 +1,7 @@
+import * as color from './color.js';
+export { color };
+import * as colorspace from './colorspace.js';
+export { colorspace };
+import * as hsl from './hsl.js';
+export { hsl };
+//# sourceMappingURL=index.js.map

package/dist/color/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}