colorsort-js 1.0.0

package/dist/types/src/spectral-edit.d.ts

@@ -0,0 +1,53 @@
+import { Vector3 } from './vector.ts';
+export interface SpectralProcessingOptions {
+    eq?: {
+        lowGain: number;
+        midGain: number;
+        highGain: number;
+    };
+    dc?: number;
+    compression?: {
+        threshold: number;
+        ratio: number;
+        attack: number;
+        release: number;
+    };
+    exciter?: {
+        amount: number;
+        frequency: number;
+    };
+    phaseShift?: number;
+    reverb?: {
+        decay: number;
+        mix: number;
+    };
+    stereoWidth?: number;
+    distortion?: {
+        amount: number;
+        type: 'soft' | 'hard' | 'tube';
+    };
+    combFilter?: {
+        frequency: number;
+        feedback: number;
+        mix: number;
+    };
+    spectralBlur?: {
+        amount: number;
+    };
+    spectralGate?: {
+        threshold: number;
+        ratio: number;
+    };
+    partialExtraction?: {
+        fundamental: number;
+        harmonics: number;
+        bandwidth: number;
+    };
+    lightnessSmoothing?: number;
+}
+export declare function applySpectralProcessing(labColors: Vector3[], options?: SpectralProcessingOptions): {
+    colors: Vector3[];
+    resampled: Vector3[];
+    processed: Vector3[];
+    spectrum: any[][];
+};

package/dist/types/src/statistics.d.ts

@@ -0,0 +1,12 @@
+export declare function variance(arr: number[]): number;
+export declare function mean(arr: number[]): number;
+export declare function energy(magnitudes: number[]): number;
+export declare function highFreqRatio(magnitudes: number[]): number;
+export declare function round2(x: number): number;
+export declare function round3(x: number): number;
+export declare function round4(x: number): number;
+/**
+ * Interpolate NaN values in a signal using surrounding valid values
+ * This prevents false discontinuities in FFT when achromatic colors produce NaN
+ */
+export declare function interpolateNaNs(signal: number[]): number[];

package/dist/types/src/type-detect.d.ts

@@ -0,0 +1,16 @@
+import { TypeVariances } from './type-variances.ts';
+import { Vector3 } from './vector.ts';
+export type PaletteType = {
+    Kl: number;
+    Kc: number;
+    Kh: number;
+    type: string;
+    data: TypeVariances & {
+        lightnessRange: number;
+        chromaRange: number;
+        hueSpread: number;
+    };
+};
+export declare function detectPaletteType(lchColors: Vector3[]): PaletteType;
+export declare function calculateHueSpread(hues: number[]): number;
+export declare function lchColorsHueSpread(lchColors: Vector3[]): number;

package/dist/types/src/type-relative.d.ts

@@ -0,0 +1,2 @@
+import { Vector3 } from './vector.ts';
+export declare function relativeDifference(palette: Vector3[]): number[];

package/dist/types/src/type-variances.d.ts

@@ -0,0 +1,19 @@
+import { Vector3 } from './vector.ts';
+export type TypeVariances = {
+    L: number;
+    C: number;
+    H: number;
+    meanL: number;
+    meanC: number;
+    meanH: number;
+};
+export declare function calculateVariances(lchColors: Vector3[]): TypeVariances;
+export declare function calculateAdaptiveWeights(variances: {
+    L: number;
+    C: number;
+    H: number;
+}): {
+    Kl: number;
+    Kc: number;
+    Kh: number;
+};

package/dist/types/src/uni-neighbors.d.ts

@@ -0,0 +1,6 @@
+import { ColorHelper } from './method-runner.ts';
+import { Vector3 } from './vector.ts';
+export type ColorCompare = (a: Vector3, b: Vector3) => number;
+export declare function closest(data: Vector3[], compareColors: ColorCompare): [Vector3, Vector3];
+export declare function closestList(data: Vector3[], compareColors: ColorCompare): [Vector3, Vector3][];
+export declare function inlinest(data: Vector3[], helper: ColorHelper): [Vector3, Vector3];

package/dist/types/src/uni-tsp.d.ts

@@ -0,0 +1,2 @@
+import { Distance } from './method-runner.ts';
+export declare function tspVectors<T>(colors: T[], distance: Distance<T>): T[];

package/dist/types/src/vector.d.ts

@@ -0,0 +1,15 @@
+export type Vector3 = [number, number, number];
+export type Vector4 = [number, number, number, number];
+export declare function distance(a: Vector3, b: Vector3): number;
+export declare function distance12(a: Vector3, b: Vector3): number;
+export declare function distance4(a: Vector4, b: Vector4): number;
+export declare function distanceRadial0(a: Vector3, b: Vector3): number;
+export declare function distanceRadial2(a: Vector3, b: Vector3): number;
+export declare function normalize(v: Vector3): Vector3;
+export declare function subtract(a: Vector3, b: Vector3): Vector3;
+export declare function add(a: Vector3, b: Vector3): Vector3;
+export declare function dot(a: Vector3, b: Vector3): number;
+export declare function centroid(colors: Vector3[]): Vector3;
+export declare function compareColors(a: Vector3, b: Vector3): number;
+export declare function compareColorsH(a: Vector3, b: Vector3): number;
+export declare function compareColors210(a: Vector3, b: Vector3): number;

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "colorsort-js",
+  "description": "Various color sorting methods",
+  "version": "1.0.0",
+  "author": {
+    "name": "Jan Forst",
+    "email": "ensonador@gmail.com"
+  },
+  "bugs": "https://github.com/darosh/colorsort-js/issues",
+  "dependencies": {},
+  "devDependencies": {
+    "@types/chroma-js": "^3.1.2",
+    "@types/culori": "^4.0.1",
+    "@types/debug": "^4.1.12",
+    "@types/js-levenshtein": "^1.1.3",
+    "@types/node": "^25.0.3",
+    "chroma-js": "^3.2.0",
+    "colord": "2.9.3",
+    "colorgram": "^0.2.0",
+    "colorjs.io": "^0.6.0",
+    "commons-math-interpolation": "^2.2.4",
+    "culori": "^4.0.2",
+    "fft.js": "^4.0.4",
+    "js-levenshtein": "^1.1.6",
+    "ml-kmeans": "^7.0.0",
+    "poline": "^0.13.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/types/src/index.ts",
+      "import": "./dist/colorsort.js",
+      "require": "./dist/colorsort.umd.js"
+    },
+    "./trained.json": "./dist/trained.json"
+  },
+  "files": [
+    "dist/"
+  ],
+  "homepage": "https://github.com/darosh/colorsort-js",
+  "keywords": [
+    "color",
+    "sorting"
+  ],
+  "license": "MIT",
+  "main": "./dist/colorsort.js",
+  "private": false,
+  "repository": "https://github.com/darosh/colorsort-js.git",
+  "type": "module",
+  "types": "./dist/types/src/index.ts",
+  "scripts": {
+    "bench": "deno --allow-write scripts/bench.js",
+    "build": "tsc && vite build",
+    "postbuild": "cp ../colorsort-data-trained/dist/trained.json ./dist/trained.json",
+    "dev": "vite build --watch",
+    "lint": "tsc && oxlint ./src --fix && oxfmt ./src",
+    "range": "deno --allow-write scripts/range.js",
+    "test": "deno run -A npm:vitest run --bail=1",
+    "test:methods": "deno run -A npm:vitest run ./tests/methods.test.js",
+    "test:ramp": "deno run -A npm:vitest run ./tests/ramp.test.ts"
+  }
+}