Tolerance

Tolerance is a small module with an important job: it turns a user-facing 0-1 slider into a perceptual threshold that works well for OKLab matching.

import { toleranceToThreshold } from "colorscope/tolerance";

Function

toleranceToThreshold

function toleranceToThreshold(tolerance: number): number

The mapping is intentionally non-linear so the strict end of the slider has more control.

toleranceToThreshold(0);    // 0.02
toleranceToThreshold(0.45); // 0.089...
toleranceToThreshold(1);    // 0.18

Why it exists

Raw distance thresholds are too technical for most users. A tolerance slider is much easier to reason about, but it still needs to map back to values that mean something in perceptual color space.

Rough interpretation:

• ~0.02: almost identical
• ~0.05: close / same family
• ~0.10: related but looser
• ~0.15+: broad browsing

Typical usage

import { computeSearchTarget } from "colorscope/search";
import { toleranceToThreshold } from "colorscope/tolerance";

const target = computeSearchTarget({ state });
const threshold = toleranceToThreshold(uiTolerance);