color-elements 0.0.1 → 0.0.3

package/lib/colorjs.io/src/util.js

@@ -1,254 +0,0 @@
-/**
- * Various utility functions
- */
-
-export {default as multiplyMatrices} from "./multiply-matrices.js";
-
-/**
- * Check if a value is a string (including a String object)
- * @param {*} str - Value to check
- * @returns {boolean}
- */
-export function isString (str) {
-	return type(str) === "string";
-}
-
-/**
- * Determine the internal JavaScript [[Class]] of an object.
- * @param {*} o - Value to check
- * @returns {string}
- */
-export function type (o) {
-	let str = Object.prototype.toString.call(o);
-
-	return (str.match(/^\[object\s+(.*?)\]$/)[1] || "").toLowerCase();
-}
-
-export function serializeNumber (n, {precision, unit }) {
-	if (isNone(n)) {
-		return "none";
-	}
-
-	return toPrecision(n, precision) + (unit ?? "");
-}
-
-/**
- * Check if a value corresponds to a none argument
- * @param {*} n - Value to check
- * @returns {boolean}
- */
-export function isNone (n) {
-	return Number.isNaN(n) || (n instanceof Number && n?.none);
-}
-
-/**
- * Replace none values with 0
- */
-export function skipNone (n) {
-	return isNone(n) ? 0 : n;
-}
-
-/**
- * Round a number to a certain number of significant digits
- * @param {number} n - The number to round
- * @param {number} precision - Number of significant digits
- */
-export function toPrecision (n, precision) {
-	if (n === 0) {
-		return 0;
-	}
-	let integer = ~~n;
-	let digits = 0;
-	if (integer && precision) {
-		digits = ~~Math.log10(Math.abs(integer)) + 1;
-	}
-	const multiplier = 10.0 ** (precision - digits);
-	return Math.floor(n * multiplier + 0.5) / multiplier;
-}
-
-const angleFactor = {
-	deg: 1,
-	grad: 0.9,
-	rad: 180 / Math.PI,
-	turn: 360,
-};
-
-/**
-* Parse a CSS function, regardless of its name and arguments
-* @param String str String to parse
-* @return {{name, args, rawArgs}}
-*/
-export function parseFunction (str) {
-	if (!str) {
-		return;
-	}
-
-	str = str.trim();
-
-	const isFunctionRegex = /^([a-z]+)\((.+?)\)$/i;
-	const isNumberRegex = /^-?[\d.]+$/;
-	const unitValueRegex = /%|deg|g?rad|turn$/;
-	const singleArgument = /\/?\s*(none|[-\w.]+(?:%|deg|g?rad|turn)?)/g;
-	let parts = str.match(isFunctionRegex);
-
-	if (parts) {
-		// It is a function, parse args
-		let args = [];
-		parts[2].replace(singleArgument, ($0, rawArg) => {
-			let match = rawArg.match(unitValueRegex);
-			let arg = rawArg;
-
-			if (match) {
-				let unit = match[0];
-				// Drop unit from value
-				let unitlessArg = arg.slice(0, -unit.length);
-
-				if (unit === "%") {
-					// Convert percentages to 0-1 numbers
-					arg = new Number(unitlessArg / 100);
-					arg.type = "<percentage>";
-				}
-				else {
-					// Multiply angle by appropriate factor for its unit
-					arg = new Number(unitlessArg * angleFactor[unit]);
-					arg.type = "<angle>";
-					arg.unit = unit;
-				}
-			}
-			else if (isNumberRegex.test(arg)) {
-				// Convert numerical args to numbers
-				arg = new Number(arg);
-				arg.type = "<number>";
-			}
-			else if (arg === "none") {
-				arg = new Number(NaN);
-				arg.none = true;
-			}
-
-			if ($0.startsWith("/")) {
-				// It's alpha
-				arg = arg instanceof Number ? arg : new Number(arg);
-				arg.alpha = true;
-			}
-
-			if (typeof arg === "object" && arg instanceof Number) {
-				arg.raw = rawArg;
-			}
-
-			args.push(arg);
-		});
-
-		return {
-			name: parts[1].toLowerCase(),
-			rawName: parts[1],
-			rawArgs: parts[2],
-			// An argument could be (as of css-color-4):
-			// a number, percentage, degrees (hue), ident (in color())
-			args,
-		};
-	}
-}
-
-export function last (arr) {
-	return arr[arr.length - 1];
-}
-
-export function interpolate (start, end, p) {
-	if (isNaN(start)) {
-		return end;
-	}
-
-	if (isNaN(end)) {
-		return start;
-	}
-
-	return start + (end - start) * p;
-}
-
-export function interpolateInv (start, end, value) {
-	return (value - start) / (end - start);
-}
-
-export function mapRange (from, to, value) {
-	return interpolate(to[0], to[1], interpolateInv(from[0], from[1], value));
-}
-
-export function parseCoordGrammar (coordGrammars) {
-	return coordGrammars.map(coordGrammar => {
-		return coordGrammar.split("|").map(type => {
-			type = type.trim();
-			let range = type.match(/^(<[a-z]+>)\[(-?[.\d]+),\s*(-?[.\d]+)\]?$/);
-
-			if (range) {
-				let ret = new String(range[1]);
-				ret.range = [+range[2], +range[3]];
-				return ret;
-			}
-
-			return type;
-		});
-	});
-}
-
-/**
- * Clamp value between the minimum and maximum
- * @param {number} min minimum value to return
- * @param {number} val the value to return if it is between min and max
- * @param {number} max maximum value to return
- * @returns number
- */
-export function clamp (min, val, max) {
-	return Math.max(Math.min(max, val), min);
-}
-
-/**
- * Copy sign of one value to another.
- * @param {number} - to number to copy sign to
- * @param {number} - from number to copy sign from
- * @returns number
- */
-export function copySign (to, from) {
-	return Math.sign(to) === Math.sign(from) ? to : -to;
-}
-
-/**
- * Perform pow on a signed number and copy sign to result
- * @param {number} - base the base number
- * @param {number} - exp the exponent
- * @returns number
- */
-export function spow (base, exp) {
-	return copySign(Math.abs(base) ** exp, base);
-}
-
-/**
- * Perform a divide, but return zero if the numerator is zero
- * @param {number} n - the numerator
- * @param {number} d - the denominator
- * @returns number
- */
-export function zdiv (n, d) {
-	return (d === 0) ? 0 : n / d;
-}
-
-/**
- * Perform a bisect on a sorted list and locate the insertion point for
- * a value in arr to maintain sorted order.
- * @param {number[]} arr - array of sorted numbers
- * @param {number} value - value to find insertion point for
- * @param {number} lo - used to specify a the low end of a subset of the list
- * @param {number} hi - used to specify a the high end of a subset of the list
- * @returns number
- */
-export function bisectLeft (arr, value, lo = 0, hi = arr.length) {
-	while (lo < hi) {
-		const mid = (lo + hi) >> 1;
-		if (arr[mid] < value) {
-			lo = mid + 1;
-		}
-		else {
-			hi = mid;
-		}
-	}
-	return lo;
-}

package/lib/colorjs.io/src/variations.js

@@ -1,14 +0,0 @@
-import ColorSpace from "./space.js";
-import set from "./set.js";
-
-export function lighten (color, amount = .25) {
-	let space = ColorSpace.get("oklch", "lch");
-	let lightness = [space, "l"];
-	return set(color, lightness, l => l * (1 + amount));
-}
-
-export function darken (color, amount = .25) {
-	let space = ColorSpace.get("oklch", "lch");
-	let lightness = [space, "l"];
-	return set(color, lightness, l => l * (1 - amount));
-}

package/lib/colorjs.io/types/index.d.cts

@@ -1,4 +0,0 @@
-// Definitions by: Adam Thompson-Sharpe <https://github.com/MysteryBlokHed>
-// Minimum TypeScript Version: 4.1
-export { default } from "./index.js";
-export * from "./index.js";

package/lib/colorjs.io/types/index.d.ts

@@ -1,42 +0,0 @@
-// Definitions by: Adam Thompson-Sharpe <https://github.com/MysteryBlokHed>
-// Minimum TypeScript Version: 4.1
-export { default } from "./src/index.js";
-
-export type {
-	ColorConstructor,
-	ColorObject,
-	ColorTypes,
-	Coords,
-	DefineFunctionCode,
-	DefineFunctionOptions,
-	DefineFunctionHybrid,
-	PlainColorObject,
-	SpaceAccessor,
-	ToColorPrototype,
-} from "./src/color.js";
-
-export type { White } from "./src/adapt.js";
-
-export type { CAT } from "./src/CATs.js";
-
-export type { Display } from "./src/display.js";
-
-export type {
-	Range,
-	RangeOptions,
-	MixOptions,
-	StepsOptions,
-} from "./src/interpolation.js";
-
-export type { Options as ParseOptions } from "./src/parse.js";
-
-export type { RGBOptions } from "./src/rgbspace.js";
-
-export type { Options as SerializeOptions } from "./src/serialize.js";
-
-export type {
-	Format as SpaceFormat,
-	CoordMeta,
-	Ref,
-	Options as SpaceOptions,
-} from "./src/space.js";

package/lib/colorjs.io/types/src/CATs.d.ts

@@ -1,13 +0,0 @@
-import { White } from "./adapt.js";
-
-export interface CAT {
-	id: string;
-	toCone_M: number[][];
-	fromCone_M: number[][];
-}
-
-export const CATs: Record<string, CAT>;
-
-export function defineCAT (cat: CAT): void;
-
-export function adapt (W1: White, W2: White, id?: string): number[];

package/lib/colorjs.io/types/src/adapt.d.ts

@@ -1,12 +0,0 @@
-export type White = [number, number, number];
-
-export const WHITES: Record<string, White>;
-
-export function getWhite (name: string | White): White;
-
-export default function adapt (
-	w1: White,
-	w2: White,
-	xyz: [number, number, number],
-	options?: { method?: string | undefined }
-): void;

package/lib/colorjs.io/types/src/angles.d.ts

@@ -1,7 +0,0 @@
-/** Constrain an angle to 360 degrees */
-export function constrain (angle: number): number;
-
-export function adjust (
-	arc: "raw" | "increasing" | "decreasing" | "longer" | "shorter",
-	angles: [number, number]
-): [number, number];

package/lib/colorjs.io/types/src/chromaticity.d.ts

@@ -1,7 +0,0 @@
-import Color, { ColorTypes } from "./color.js";
-
-export function uv (color: ColorTypes): [number, number];
-
-export function xy (color: ColorTypes): [number, number];
-
-export function register (color: typeof Color): void;

package/lib/colorjs.io/types/src/clone.d.ts

@@ -1,3 +0,0 @@
-import { PlainColorObject } from "./color.js";
-
-export default function clone (color: PlainColorObject): PlainColorObject;

package/lib/colorjs.io/types/src/color.d.ts

@@ -1,160 +0,0 @@
-import { WHITES } from "./adapt.js";
-import defaults from "./defaults.js";
-import hooks from "./hooks.js";
-import * as util from "./util.js";
-import ColorSpace, { Ref } from "./space.js";
-import SpaceAccessors from "./space-coord-accessors.js";
-
-import {
-	to as toFn,
-	parse,
-	serialize,
-	inGamut as inGamutFn,
-	toGamut as toGamutFn,
-	distance as distanceFn,
-	equals as equalsFn,
-	get,
-	getAll as getAllFn,
-	setAll as setAllFn,
-	display,
-} from "./index-fn.js";
-
-export type { SpaceAccessor } from "./space-coord-accessors.js";
-
-export type Coords = [number, number, number];
-
-export interface ColorObject {
-	spaceId?: string | ColorSpace | undefined;
-	space?: string | ColorSpace | undefined;
-	coords: Coords;
-	alpha?: number | undefined;
-}
-
-export interface PlainColorObject {
-	space: ColorSpace;
-	coords: Coords;
-	alpha: number;
-}
-
-export interface ColorConstructor {
-	spaceId: string;
-	coords: Coords;
-	alpha: number | undefined;
-}
-
-export type ColorTypes = ColorObject | ColorConstructor | string | PlainColorObject;
-
-export type DefineFunctionCode = (...args: any[]) => any;
-
-export interface DefineFunctionOptions {
-	instance?: boolean | undefined;
-	returns?: "color" | "function<color>" | "array<color>" | undefined;
-}
-
-export type DefineFunctionHybrid = DefineFunctionCode & DefineFunctionOptions;
-
-/** Remove the first element of an array type */
-type RemoveFirstElement<T extends any[]> = T extends [any, ...infer R]
-	? R
-	: T[number][];
-
-/** Convert a function to a prototype for Color */
-export type ToColorPrototype<T extends (...args: any[]) => any> = T extends (
-	color: Color,
-	...args: infer A
-) => infer R
-	? T extends { returns: "color" }
-		? (...args: A) => Color
-		: (...args: A) => R
-	: never;
-
-/** Convert a function to a Color namespace property (returning a Color) */
-export type ToColorNamespace<T extends (...args: any[]) => any> = T extends (
-	...args: infer A
-) => infer R
-	? T extends { returns: "color" }
-		? (...args: A) => Color
-		: (...args: A) => R
-	: never;
-
-declare namespace Color {
-	// Functions defined using Color.defineFunctions
-	export const getAll: ToColorNamespace<typeof getAllFn>;
-	export const setAll: ToColorNamespace<typeof setAllFn>;
-	export const to: ToColorNamespace<typeof toFn>;
-	export const equals: ToColorNamespace<typeof equalsFn>;
-	export const inGamut: ToColorNamespace<typeof inGamutFn>;
-	export const toGamut: ToColorNamespace<typeof toGamutFn>;
-	export const distance: ToColorNamespace<typeof distanceFn>;
-	// `get` is defined below as a static method on the Class,
-	// and `toString` is intentionally not overridden for the namespace
-
-	export { util, hooks, WHITES, ColorSpace as Space, parse, defaults };
-	export const spaces: typeof ColorSpace["registry"];
-
-	// Must be manually defined due to overloads
-	// These should always match the signature of the original function
-	export function set (color: ColorTypes, prop: Ref, value: number | ((coord: number) => number)): Color;
-	export function set (color: ColorTypes, props: Record<string, number | ((coord: number) => number)>): Color;
-}
-
-declare class Color extends SpaceAccessors implements PlainColorObject {
-	constructor (color: ColorTypes);
-	constructor (space: string | ColorSpace, coords: Coords, alpha?: number);
-
-	// These signatures should always be the same as the constructor
-	static get (color: ColorTypes): Color;
-	static get (
-		space: string | ColorSpace,
-		coords: Coords,
-		alpha: number
-	): Color;
-
-	static defineFunction (name: string, code: DefineFunctionHybrid): void;
-	static defineFunction (
-		name: string,
-		code: DefineFunctionCode,
-		options: DefineFunctionOptions
-	): void;
-
-	static defineFunctions (objects: Record<string, DefineFunctionHybrid>): void;
-
-	static extend (
-		exports:
-		| { register: (color: typeof Color) => void }
-		| Record<string, DefineFunctionHybrid>
-	): void;
-
-	get space (): ColorSpace;
-	get spaceId (): string;
-
-	alpha: number;
-	coords: Coords;
-
-	clone (): this;
-
-	// Copy parameter types from display function, except for the first one
-	display (
-		...args: RemoveFirstElement<Parameters<typeof display>>
-	): string & { color: Color };
-
-	toJSON (): ColorConstructor;
-
-	// Functions defined using Color.defineFunctions
-	get: ToColorPrototype<typeof get>;
-	getAll: ToColorPrototype<typeof getAllFn>;
-	setAll: ToColorPrototype<typeof setAllFn>;
-	to: ToColorPrototype<typeof toFn>;
-	equals: ToColorPrototype<typeof equalsFn>;
-	inGamut: ToColorPrototype<typeof inGamutFn>;
-	toGamut: ToColorPrototype<typeof toGamutFn>;
-	distance: ToColorPrototype<typeof distanceFn>;
-	toString: ToColorPrototype<typeof serialize>;
-
-	// Must be manually defined due to overloads
-	// These should always match the signature of the original function
-	set (prop: Ref, value: number | ((coord: number) => number)): Color;
-	set (props: Record<string, number | ((coord: number) => number)>): Color;
-}
-
-export default Color;

package/lib/colorjs.io/types/src/contrast/APCA.d.ts

@@ -1,5 +0,0 @@
-import { ColorTypes } from "../color.js";
-export default function (
-	background: ColorTypes,
-	forgeround: ColorTypes
-): number;

package/lib/colorjs.io/types/src/contrast/Lstar.d.ts

@@ -1,5 +0,0 @@
-import { ColorTypes } from "../color.js";
-export default function (
-	background: ColorTypes,
-	forgeround: ColorTypes
-): number;

package/lib/colorjs.io/types/src/contrast/Michelson.d.ts

@@ -1,5 +0,0 @@
-import { ColorTypes } from "../color.js";
-export default function (
-	background: ColorTypes,
-	forgeround: ColorTypes
-): number;

package/lib/colorjs.io/types/src/contrast/WCAG21.d.ts

@@ -1,5 +0,0 @@
-import { ColorTypes } from "../color.js";
-export default function (
-	background: ColorTypes,
-	forgeround: ColorTypes
-): number;

package/lib/colorjs.io/types/src/contrast/Weber.d.ts

@@ -1,5 +0,0 @@
-import { ColorTypes } from "../color.js";
-export default function (
-	background: ColorTypes,
-	forgeround: ColorTypes
-): number;

package/lib/colorjs.io/types/src/contrast/deltaPhi.d.ts

@@ -1,5 +0,0 @@
-import { ColorTypes } from "../color.js";
-export default function (
-	background: ColorTypes,
-	forgeround: ColorTypes
-): number;

package/lib/colorjs.io/types/src/contrast/index.d.ts

@@ -1,11 +0,0 @@
-export type Algorithms =
-	keyof typeof import("./index.js") extends `contrast${infer Alg}`
-		? Alg
-		: string;
-
-export { default as contrastWCAG21 } from "./WCAG21.js";
-export { default as contrastAPCA } from "./APCA.js";
-export { default as contrastMichelson } from "./Michelson.js";
-export { default as contrastWeber } from "./Weber.js";
-export { default as contrastLstar } from "./Lstar.js";
-export { default as contrastDeltaPhi } from "./deltaPhi.js";

package/lib/colorjs.io/types/src/contrast.d.ts

@@ -1,12 +0,0 @@
-import { ColorTypes } from "./color.js";
-import { Algorithms } from "./contrast/index.js";
-
-/**
- * @param options Algorithm to use as well as any other options to pass to the contrast function
- * @throws {TypeError} Unknown or unspecified algorithm
- */
-export default function contrast (
-	background: ColorTypes,
-	foreground: ColorTypes,
-	options: Algorithms | ({ algorithm: Algorithms } & Record<string, any>)
-): number;

package/lib/colorjs.io/types/src/defaults.d.ts

@@ -1,2 +0,0 @@
-declare const _default: Record<string, any>;
-export default _default;

package/lib/colorjs.io/types/src/deltaE/deltaE2000.d.ts

@@ -1,11 +0,0 @@
-import { ColorTypes } from "../color.js";
-
-export default function (
-	color: ColorTypes,
-	sample: ColorTypes,
-	options?: {
-		kL?: number | undefined;
-		kC?: number | undefined;
-		kH?: number | undefined;
-	}
-): number;

package/lib/colorjs.io/types/src/deltaE/deltaE76.d.ts

@@ -1,5 +0,0 @@
-import { ColorTypes } from "../color.js";
-export default function (
-	color: ColorTypes,
-	sample: ColorTypes
-): number;

package/lib/colorjs.io/types/src/deltaE/deltaECMC.d.ts

@@ -1,9 +0,0 @@
-import { ColorTypes } from "../color.js";
-export default function (
-	color: ColorTypes,
-	sample: ColorTypes,
-	options?: {
-		l?: number | undefined;
-		c?: number | undefined;
-	}
-): number;

package/lib/colorjs.io/types/src/deltaE/deltaEHCT.d.ts

@@ -1,5 +0,0 @@
-import { ColorTypes } from "../color.js";
-export default function (
-	color: ColorTypes,
-	sample: ColorTypes
-): number;

package/lib/colorjs.io/types/src/deltaE/deltaEITP.d.ts

@@ -1,5 +0,0 @@
-import { ColorTypes } from "../color.js";
-export default function (
-	color: ColorTypes,
-	sample: ColorTypes
-): number;

package/lib/colorjs.io/types/src/deltaE/deltaEJz.d.ts

@@ -1,5 +0,0 @@
-import { ColorTypes } from "../color.js";
-export default function (
-	color: ColorTypes,
-	sample: ColorTypes
-): number;

package/lib/colorjs.io/types/src/deltaE/deltaEOK.d.ts

@@ -1,5 +0,0 @@
-import { ColorTypes } from "../color.js";
-export default function (
-	color: ColorTypes,
-	sample: ColorTypes
-): number;

package/lib/colorjs.io/types/src/deltaE/index.d.ts

@@ -1,14 +0,0 @@
-export { default as deltaE76 } from "./deltaE76.js";
-export { default as deltaECMC } from "./deltaECMC.js";
-export { default as deltaE2000 } from "./deltaE2000.js";
-export { default as deltaEJz } from "./deltaEJz.js";
-export { default as deltaEITP } from "./deltaEITP.js";
-export { default as deltaEOK } from "./deltaEOK.js";
-export { default as deltaEHCT } from "./deltaEHCT.js";
-
-declare const deltaEMethods: Omit<typeof import("./index.js"), "default">;
-export default deltaEMethods;
-
-export type Methods = keyof typeof deltaEMethods extends `deltaE${infer Method}`
-	? Method
-	: string;

package/lib/colorjs.io/types/src/deltaE.d.ts

@@ -1,12 +0,0 @@
-import { ColorTypes } from "./color.js";
-import { Methods } from "./deltaE/index.js";
-
-/**
- * @param options deltaE method to use as well as any other options to pass to the deltaE function
- * @throws {TypeError} Unknown or unspecified method
- */
-export default function deltaE (
-	color1: ColorTypes,
-	color2: ColorTypes,
-	options: Methods | ({ method: Methods } & Record<string, any>)
-): number;