@thi.ng/color 5.6.2 → 5.6.4

package/color-range.js

@@ -14,247 +14,178 @@ import { isBlack } from "./is-black.js";
 import { isGray } from "./is-gray.js";
 import { isWhite } from "./is-white.js";
 import { lch } from "./lch/lch.js";
-/**
- * Preset {@link ColorRange}s for use with {@link colorsFromRange},
- * {@link colorsFromTheme} etc.
- */
-export const COLOR_RANGES = {
-    light: {
-        c: [[0.3, 0.7]],
-        l: [[0.9, 1]],
-        b: [[0.35, 0.5]],
-        w: [[0.6, 1]],
-    },
-    dark: {
-        c: [[0.7, 1]],
-        l: [[0.15, 0.4]],
-        b: [[0, 0.4]],
-        w: [[0.4, 0.6]],
-    },
-    bright: {
-        c: [[0.75, 0.95]],
-        l: [[0.8, 1]],
-    },
-    weak: {
-        c: [[0.15, 0.3]],
-        l: [[0.7, 1]],
-        b: [[0.4, 0.6]],
-        w: [[0.8, 1]],
-    },
-    neutral: {
-        c: [[0.25, 0.35]],
-        l: [[0.3, 0.7]],
-        b: [[0.25, 0.4]],
-        w: [[0.9, 1]],
-    },
-    fresh: {
-        c: [[0.4, 0.8]],
-        l: [[0.8, 1]],
-        b: [[0.05, 0.3]],
-        w: [[0.8, 1]],
-    },
-    soft: {
-        c: [[0.2, 0.3]],
-        l: [[0.6, 0.9]],
-        b: [[0.05, 0.15]],
-        w: [[0.6, 0.9]],
-    },
-    hard: {
-        c: [[0.85, 0.95]],
-        l: [[0.4, 1]],
-    },
-    warm: {
-        c: [[0.6, 0.9]],
-        l: [[0.4, 0.9]],
-        b: [[0.2, 0.3]],
-        w: [[0.8, 1]],
-    },
-    cool: {
-        c: [[0.05, 0.2]],
-        l: [[0.9, 1]],
-        b: [[0, 0.95]],
-        w: [[0.95, 1]],
-    },
-    intense: {
-        c: [[0.9, 1]],
-        l: [
-            [0.2, 0.35],
-            [0.8, 1],
-        ],
-    },
+const COLOR_RANGES = {
+  light: {
+    c: [[0.3, 0.7]],
+    l: [[0.9, 1]],
+    b: [[0.35, 0.5]],
+    w: [[0.6, 1]]
+  },
+  dark: {
+    c: [[0.7, 1]],
+    l: [[0.15, 0.4]],
+    b: [[0, 0.4]],
+    w: [[0.4, 0.6]]
+  },
+  bright: {
+    c: [[0.75, 0.95]],
+    l: [[0.8, 1]]
+  },
+  weak: {
+    c: [[0.15, 0.3]],
+    l: [[0.7, 1]],
+    b: [[0.4, 0.6]],
+    w: [[0.8, 1]]
+  },
+  neutral: {
+    c: [[0.25, 0.35]],
+    l: [[0.3, 0.7]],
+    b: [[0.25, 0.4]],
+    w: [[0.9, 1]]
+  },
+  fresh: {
+    c: [[0.4, 0.8]],
+    l: [[0.8, 1]],
+    b: [[0.05, 0.3]],
+    w: [[0.8, 1]]
+  },
+  soft: {
+    c: [[0.2, 0.3]],
+    l: [[0.6, 0.9]],
+    b: [[0.05, 0.15]],
+    w: [[0.6, 0.9]]
+  },
+  hard: {
+    c: [[0.85, 0.95]],
+    l: [[0.4, 1]]
+  },
+  warm: {
+    c: [[0.6, 0.9]],
+    l: [[0.4, 0.9]],
+    b: [[0.2, 0.3]],
+    w: [[0.8, 1]]
+  },
+  cool: {
+    c: [[0.05, 0.2]],
+    l: [[0.9, 1]],
+    b: [[0, 0.95]],
+    w: [[0.95, 1]]
+  },
+  intense: {
+    c: [[0.9, 1]],
+    l: [
+      [0.2, 0.35],
+      [0.8, 1]
+    ]
+  }
 };
 const FULL = [[0, 1]];
 const DEFAULT_RANGE = {
-    h: FULL,
-    c: FULL,
-    l: FULL,
-    b: FULL,
-    w: FULL,
-    a: [[1, 1]],
+  h: FULL,
+  c: FULL,
+  l: FULL,
+  b: FULL,
+  w: FULL,
+  a: [[1, 1]]
 };
 const DEFAULT_OPTS = {
-    num: Infinity,
-    variance: 0.025,
-    eps: 1e-3,
-    rnd: SYSTEM,
+  num: Infinity,
+  variance: 0.025,
+  eps: 1e-3,
+  rnd: SYSTEM
 };
 const $rnd = (ranges, rnd) => rnd.minmax(...ranges[rnd.int() % ranges.length]);
-/**
- * Takes a {@link ColorRange} and options to produce a single new result color.
- * This color is randomized within the channel limits of the given `range`
- * descriptor. If a `base` color is provided (via {@link ColorRangeOpts}), its
- * hue is used as bias and the `variance` option defines the max. -/+ normalized
- * hue shift of the result color.
- *
- * @remarks
- * If the base color is a shade of gray (incl. black & white), the result will
- * be another gray and is based on the range's black and white point sub-ranges.
- *
- * The alpha channel of the result color will only be randomized (based on
- * `range.a` settings) iff no `base` color was provided. If `base` is given, the
- * result will used the same alpha.
- *
- * A custom PRNG can be defined via the `rnd` option (default: `Math.random`).
- *
- * @param range -
- * @param opts -
- */
-export const colorFromRange = (range, opts) => {
-    range = {
-        ...DEFAULT_RANGE,
-        ...(isString(range) ? COLOR_RANGES[range] : range),
-    };
-    const { base, variance, rnd, eps } = { ...DEFAULT_OPTS, ...opts };
-    let h;
-    let c;
-    let l;
-    let a;
-    if (base) {
-        const col = lch(base);
-        h = col[2];
-        a = __ensureAlpha(col[3]);
-        if (isBlack(col, eps)) {
-            c = 0;
-            l = $rnd(range.b, rnd);
-        }
-        else if (isWhite(col, eps)) {
-            c = 0;
-            l = $rnd(range.w, rnd);
-        }
-        else if (isGray(col, eps)) {
-            c = 0;
-            l = $rnd(coin(rnd) ? range.b : range.w, rnd);
-        }
-        else {
-            h = fract(h + rnd.norm(variance));
-        }
+const colorFromRange = (range, opts) => {
+  range = {
+    ...DEFAULT_RANGE,
+    ...isString(range) ? COLOR_RANGES[range] : range
+  };
+  const { base, variance, rnd, eps } = { ...DEFAULT_OPTS, ...opts };
+  let h;
+  let c;
+  let l;
+  let a;
+  if (base) {
+    const col = lch(base);
+    h = col[2];
+    a = __ensureAlpha(col[3]);
+    if (isBlack(col, eps)) {
+      c = 0;
+      l = $rnd(range.b, rnd);
+    } else if (isWhite(col, eps)) {
+      c = 0;
+      l = $rnd(range.w, rnd);
+    } else if (isGray(col, eps)) {
+      c = 0;
+      l = $rnd(coin(rnd) ? range.b : range.w, rnd);
+    } else {
+      h = fract(h + rnd.norm(variance));
     }
-    else {
-        h = $rnd(range.h, rnd);
-        a = $rnd(range.a, rnd);
-    }
-    return lch([
-        l != undefined ? l : $rnd(range.l, rnd),
-        c !== undefined ? c : $rnd(range.c, rnd),
-        h,
-        a,
-    ]);
+  } else {
+    h = $rnd(range.h, rnd);
+    a = $rnd(range.a, rnd);
+  }
+  return lch([
+    l != void 0 ? l : $rnd(range.l, rnd),
+    c !== void 0 ? c : $rnd(range.c, rnd),
+    h,
+    a
+  ]);
 };
-/**
- * Generator version of {@link colorFromRange}, by default yielding an infinite
- * sequence of random colors based on given range, base color (optional) and
- * other opts. Use `num` option to limit number of results.
- *
- * @param range -
- * @param opts -
- */
-export function* colorsFromRange(range, opts = {}) {
-    let num = opts.num != undefined ? opts.num : Infinity;
-    while (num-- > 0)
-        yield colorFromRange(range, opts);
+function* colorsFromRange(range, opts = {}) {
+  let num = opts.num != void 0 ? opts.num : Infinity;
+  while (num-- > 0)
+    yield colorFromRange(range, opts);
 }
-/** @internal */
 const compileThemePart = (part, opts) => {
-    let spec;
-    if (isArray(part)) {
-        spec = themePartFromTuple(part);
-    }
-    else if (isString(part)) {
-        spec = themePartFromString(part);
-    }
-    else {
-        spec = { ...part };
-        spec.weight == null && (spec.weight = 1);
-    }
-    isString(spec.range) && (spec.range = COLOR_RANGES[spec.range]);
-    isString(spec.base) && (spec.base = lch(parseCss(spec.base)));
-    if (spec.base !== undefined) {
-        opts = { ...opts, base: spec.base };
-    }
-    return { spec, opts };
+  let spec;
+  if (isArray(part)) {
+    spec = themePartFromTuple(part);
+  } else if (isString(part)) {
+    spec = themePartFromString(part);
+  } else {
+    spec = { ...part };
+    spec.weight == null && (spec.weight = 1);
+  }
+  isString(spec.range) && (spec.range = COLOR_RANGES[spec.range]);
+  isString(spec.base) && (spec.base = lch(parseCss(spec.base)));
+  if (spec.base !== void 0) {
+    opts = { ...opts, base: spec.base };
+  }
+  return { spec, opts };
 };
-/** @internal */
 const themePartFromTuple = (part) => {
-    let weight;
-    const [range, ...xs] = part;
-    if (isNumber(peek(xs))) {
-        weight = peek(xs);
-        xs.pop();
-    }
-    else {
-        weight = 1;
-    }
-    return ((xs.length === 1
-        ? { range, base: xs[0], weight }
-        : xs.length === 0
-            ? COLOR_RANGES[range]
-                ? { range, weight }
-                : { base: range, weight }
-            : illegalArgs(`invalid theme part: "${part}"`)));
+  let weight;
+  const [range, ...xs] = part;
+  if (isNumber(peek(xs))) {
+    weight = peek(xs);
+    xs.pop();
+  } else {
+    weight = 1;
+  }
+  return xs.length === 1 ? { range, base: xs[0], weight } : xs.length === 0 ? COLOR_RANGES[range] ? { range, weight } : { base: range, weight } : illegalArgs(`invalid theme part: "${part}"`);
 };
-/** @internal */
-const themePartFromString = (part) => ((COLOR_RANGES[part]
-    ? { range: part, weight: 1 }
-    : { base: part, weight: 1 }));
-/**
- * Probabilistic color theme generator. Yield randomized colors based on given
- * weighted set of theme part specs.
- *
- * @remarks
- * Each theme part is a tuple of either:
- *
- * - `[range, color, weight?]`
- * - `[range, weight?]`
- * - `[color, weight?]`
- *
- * `range` can be either a {@link ColorRange} or the name of a
- * {@link COLOR_RANGES} preset. Likewise, `color` can be a color instance or CSS
- * color name. The `weight` of each part defines the relative
- * importance/probability of this theme part, compared to others. Default weight
- * is 1.0.
- *
- * @example
- * ```ts
- * [...colorsFromTheme(
- *   [["cool", "aliceblue"], ["bright", "orange", 0.25], ["hotpink", 0.1]],
- *   { num: 10 }
- * )]
- * ```
- *
- * @param parts -
- * @param opts -
- */
-export function* colorsFromTheme(parts, opts = {}) {
-    let { num, variance, rnd } = { ...DEFAULT_OPTS, ...opts };
-    const theme = parts.map((p) => compileThemePart(p, opts));
-    const choice = weightedRandom(theme, theme.map((x) => x.spec.weight), rnd);
-    while (--num >= 0) {
-        const { spec, opts } = choice();
-        if (spec.range) {
-            yield colorFromRange(spec.range, opts);
-        }
-        else if (spec.base) {
-            yield analog(lch(), lch(spec.base), variance, rnd);
-        }
+const themePartFromString = (part) => COLOR_RANGES[part] ? { range: part, weight: 1 } : { base: part, weight: 1 };
+function* colorsFromTheme(parts, opts = {}) {
+  let { num, variance, rnd } = { ...DEFAULT_OPTS, ...opts };
+  const theme = parts.map((p) => compileThemePart(p, opts));
+  const choice = weightedRandom(
+    theme,
+    theme.map((x) => x.spec.weight),
+    rnd
+  );
+  while (--num >= 0) {
+    const { spec, opts: opts2 } = choice();
+    if (spec.range) {
+      yield colorFromRange(spec.range, opts2);
+    } else if (spec.base) {
+      yield analog(lch(), lch(spec.base), variance, rnd);
     }
+  }
 }
+export {
+  COLOR_RANGES,
+  colorFromRange,
+  colorsFromRange,
+  colorsFromTheme
+};

package/color.js

@@ -17,33 +17,34 @@ import { xyzD50 } from "./xyz/xyz50.js";
 import { xyzD65 } from "./xyz/xyz65.js";
 import { ycc } from "./ycc/ycc.js";
 const FACTORIES = {
-    argb32,
-    abgr32,
-    hcy,
-    hsi,
-    hsl,
-    hsv,
-    lab50: labD50,
-    lab65: labD65,
-    lch,
-    oklab,
-    oklch,
-    rgb,
-    srgb,
-    xyy,
-    xyz50: xyzD50,
-    xyz65: xyzD65,
-    ycc,
+  argb32,
+  abgr32,
+  hcy,
+  hsi,
+  hsl,
+  hsv,
+  lab50: labD50,
+  lab65: labD65,
+  lch,
+  oklab,
+  oklch,
+  rgb,
+  srgb,
+  xyy,
+  xyz50: xyzD50,
+  xyz65: xyzD65,
+  ycc
 };
-export function color(src, buf, idx, stride) {
-    if (isString(src))
-        return buf
-            ? FACTORIES[src](buf, idx, stride)
-            : color(parseCss(src));
-    if (buf) {
-        const res = FACTORIES[src.mode](buf, idx, stride);
-        res.set(src.deref());
-        return res;
-    }
-    return FACTORIES[src.mode](src.deref());
+function color(src, buf, idx, stride) {
+  if (isString(src))
+    return buf ? FACTORIES[src](buf, idx, stride) : color(parseCss(src));
+  if (buf) {
+    const res = FACTORIES[src.mode](buf, idx, stride);
+    res.set(src.deref());
+    return res;
+  }
+  return FACTORIES[src.mode](src.deref());
 }
+export {
+  color
+};

package/contrast.js

@@ -1,20 +1,10 @@
 import { luminanceRgb } from "./luminance-rgb.js";
 import { rgb } from "./rgb/rgb.js";
-/**
- * Computes the WCAG 2.0 contrast ratio of the two given colors (order is
- * irrelevant). Contrast ratios can range from 1 to 21.
- *
- * @remarks
- * For accessibility guideline conformance, the visual presentation of text must
- * have a minimum contrast ratio of at least 4.5 (with some exceptions).
- *
- * Reference: https://www.w3.org/TR/WCAG20/#contrast-ratiodef
- *
- * @param a
- * @param b
- */
-export const contrast = (a, b) => {
-    const lumA = luminanceRgb(rgb(a)) + 0.05;
-    const lumB = luminanceRgb(rgb(b)) + 0.05;
-    return lumA > lumB ? lumA / lumB : lumB / lumA;
+const contrast = (a, b) => {
+  const lumA = luminanceRgb(rgb(a)) + 0.05;
+  const lumB = luminanceRgb(rgb(b)) + 0.05;
+  return lumA > lumB ? lumA / lumB : lumB / lumA;
+};
+export {
+  contrast
 };

package/convert.js

@@ -1,46 +1,25 @@
 import { isArray } from "@thi.ng/checks/is-array";
 import { assert } from "@thi.ng/errors/assert";
 import { unsupported } from "@thi.ng/errors/unsupported";
-export const CONVERSIONS = {};
-/**
- * Registers conversions for given {@link ColorSpec}. Called by
- * {@link defColor}.
- *
- * @param spec -
- *
- * @internal
- */
-export const defConversions = (mode, spec) => {
-    for (let id in spec) {
-        const val = spec[id];
-        if (isArray(val)) {
-            const [a, b, c, d] = val;
-            spec[id] =
-                val.length === 2
-                    ? (out, src) => b(out, a(out, src))
-                    : val.length === 3
-                        ? (out, src) => c(out, b(out, a(out, src)))
-                        : (out, src) => d(out, c(out, b(out, a(out, src))));
-        }
+const CONVERSIONS = {};
+const defConversions = (mode, spec) => {
+  for (let id in spec) {
+    const val = spec[id];
+    if (isArray(val)) {
+      const [a, b, c, d] = val;
+      spec[id] = val.length === 2 ? (out, src) => b(out, a(out, src)) : val.length === 3 ? (out, src) => c(out, b(out, a(out, src))) : (out, src) => d(out, c(out, b(out, a(out, src))));
     }
-    CONVERSIONS[mode] = { ...CONVERSIONS[mode], ...spec };
+  }
+  CONVERSIONS[mode] = { ...CONVERSIONS[mode], ...spec };
 };
-/**
- * Converts a (raw, untyped) color from one mode to another and writes result
- * into `out` (or if null, back into `src`).
- *
- * @param res
- * @param src
- * @param destMode
- * @param srcMode
- */
-export const convert = (res, src, destMode, srcMode) => {
-    const spec = CONVERSIONS[destMode];
-    assert(!!spec, `no conversions available for ${destMode}`);
-    let $convert = spec[srcMode];
-    return $convert
-        ? $convert(res, src)
-        : CONVERSIONS.rgb[srcMode]
-            ? spec.rgb(res, CONVERSIONS.rgb[srcMode]([], src))
-            : unsupported(`can't convert: ${srcMode} -> ${destMode}`);
+const convert = (res, src, destMode, srcMode) => {
+  const spec = CONVERSIONS[destMode];
+  assert(!!spec, `no conversions available for ${destMode}`);
+  let $convert = spec[srcMode];
+  return $convert ? $convert(res, src) : CONVERSIONS.rgb[srcMode] ? spec.rgb(res, CONVERSIONS.rgb[srcMode]([], src)) : unsupported(`can't convert: ${srcMode} -> ${destMode}`);
+};
+export {
+  CONVERSIONS,
+  convert,
+  defConversions
 };