@oh-my-pi/pi-utils 18.8.8 → 18.8.9

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [18.8.9] - 2026-10-10
+
+### Added
+
+- Added `hueDistance`, the angular distance between two OKLCH hues
+
 ## [18.8.8] - 2026-10-10
 
 ### Fixed

package/dist/types/color.d.ts

@@ -111,6 +111,8 @@ export declare function oklchCusp(h: number): {
     l: number;
     c: number;
 };
+/** Angular distance between two hues in degrees (0–180), wrapping at 360. */
+export declare function hueDistance(a: number, b: number): number;
 /**
  * Convert OKLCH to a CSS hex string, gamut-mapping by chroma reduction.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-utils",
-	"version": "18.8.8",
+	"version": "18.8.9",
 	"description": "Shared utilities for pi packages",
 	"keywords": [
 		"cli",
@@ -57,7 +57,7 @@
 		"fmt": "oxfmt --no-error-on-unmatched-pattern 'src/**/*.{ts,tsx}' '{test,bench,examples,scripts}/**/*.ts' '*.ts'"
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-natives": "18.8.8"
+		"@oh-my-pi/pi-natives": "18.8.9"
 	},
 	"devDependencies": {
 		"@types/bun": "^1.3.14"

package/src/color.ts

@@ -399,6 +399,12 @@ export function oklchCusp(h: number): { l: number; c: number } {
 	return { l: lCusp, c: lCusp * sCusp };
 }
 
+/** Angular distance between two hues in degrees (0–180), wrapping at 360. */
+export function hueDistance(a: number, b: number): number {
+	const d = Math.abs(a - b) % 360;
+	return Math.min(d, 360 - d);
+}
+
 /** Slack allowed on linear channels before a color counts as out of sRGB gamut. */
 const GAMUT_EPSILON = 1e-4;