manim-web 0.15.0 → 0.16.0

package/dist/utils/oklab.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Oklab and Oklch perceptual color interpolation.
+ *
+ * manim-web interpolates colors in the stored sRGB space (see
+ * {@link interpolateColor} in `./color`). That space is not perceptually
+ * uniform, so a straight blend of two saturated colors passes through a muddy,
+ * desaturated midpoint. Oklab is a perceptually-uniform color space by Björn
+ * Ottosson; its polar form Oklch separates lightness, chroma and hue. A blend
+ * in either space keeps the midpoint bright and vivid.
+ *
+ * This module is opt-in. The default interpolation space does not change.
+ * manim-web still models a color as a `#rrggbb` hex string, so the public
+ * helpers here take and return hex strings, matching `interpolateColor`.
+ *
+ * The math follows Björn Ottosson's reference implementation:
+ * - sRGB companding (gamma) to and from linear light.
+ * - The two 3x3 matrices between linear sRGB and the LMS cone responses.
+ * - The cube-root nonlinearity on the LMS values.
+ * See https://bottosson.github.io/posts/oklab/ for the source matrices.
+ */
+/**
+ * An Oklab color as `[L, a, b]`.
+ *
+ * `L` is perceptual lightness in 0.0..1.0. `a` is the green-red axis and `b` is
+ * the blue-yellow axis; both are roughly in -0.4..0.4 for in-gamut sRGB colors.
+ */
+export type Oklab = [number, number, number];
+/**
+ * An Oklch color as `[L, C, h]`, the polar form of Oklab.
+ *
+ * `L` is perceptual lightness in 0.0..1.0. `C` is chroma (>= 0). `h` is hue in
+ * degrees, in 0.0..360.0.
+ */
+export type Oklch = [number, number, number];
+/** Convert a color (hex string) to Oklab `[L, a, b]`. */
+export declare function colorToOklab(color: string): Oklab;
+/**
+ * Convert an Oklab `[L, a, b]` array to a color (hex string).
+ *
+ * Channels that fall outside the sRGB gamut are clamped to 0..255.
+ */
+export declare function oklabToColor(lab: Oklab): string;
+/** Convert an Oklab `[L, a, b]` array to Oklch `[L, C, h]` (hue in degrees). */
+export declare function oklabToOklch(lab: Oklab): Oklch;
+/** Convert an Oklch `[L, C, h]` array (hue in degrees) to Oklab `[L, a, b]`. */
+export declare function oklchToOklab(lch: Oklch): Oklab;
+/** Convert a color (hex string) to Oklch `[L, C, h]` (hue in degrees). */
+export declare function colorToOklch(color: string): Oklch;
+/**
+ * Convert an Oklch `[L, C, h]` array (hue in degrees) to a color (hex string).
+ *
+ * Channels that fall outside the sRGB gamut are clamped to 0..255.
+ */
+export declare function oklchToColor(lch: Oklch): string;
+/**
+ * Interpolate two colors in Oklab space and return the result as a hex string.
+ *
+ * This is the perceptual counterpart of {@link interpolateColor}. `alpha` of
+ * 0.0 yields `color1`, 1.0 yields `color2`. The midpoint stays bright and
+ * vivid instead of passing through a muddy linear-RGB blend.
+ */
+export declare function interpolateColorOklab(color1: string, color2: string, alpha: number): string;
+/**
+ * Interpolate two colors in Oklch space and return the result as a hex string.
+ *
+ * This blends lightness and chroma linearly, and hue along the shortest arc of
+ * the color circle. `alpha` of 0.0 yields `color1`, 1.0 yields `color2`. The
+ * result tracks a natural hue sweep, so a red-to-green blend stays saturated
+ * through orange instead of graying out.
+ *
+ * When one endpoint is achromatic (chroma near 0), its hue is undefined, so the
+ * hue of the other endpoint is used to avoid an arbitrary sweep.
+ */
+export declare function interpolateColorOklch(color1: string, color2: string, alpha: number): string;
+//# sourceMappingURL=oklab.d.ts.map

package/dist/utils/oklab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oklab.d.ts","sourceRoot":"","sources":["../../src/utils/oklab.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAyBH;;;;;GAKG;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AA0D7C,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAIjD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,KAAK,GAAG,MAAM,CAQ/C;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,GAAG,EAAE,KAAK,GAAG,KAAK,CAQ9C;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,GAAG,EAAE,KAAK,GAAG,KAAK,CAI9C;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,KAAK,GAAG,MAAM,CAE/C;AAOD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI3F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAsB3F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "manim-web",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Manim-like mathematical animation library for the web",
   "type": "module",
   "main": "dist/index.js",