@wistia/kaleidoscope 0.0.0-beta.1e8dd2d4.d35c078

package/README.md

@@ -0,0 +1,31 @@
+# @wistia/kaleidoscope
+
+TODO: describe what this package does.
+
+## Installation
+
+```sh
+yarn add @wistia/kaleidoscope
+```
+
+## Development
+
+This package lives in the [vhs monorepo](https://github.com/wistia/vhs). From the repo root:
+
+```sh
+yarn vp run @wistia/kaleidoscope#build   # build once
+yarn workspace @wistia/kaleidoscope build:watch   # rebuild on change, pushes to yalc consumers
+yarn workspace @wistia/kaleidoscope test:watch
+```
+
+## Releasing
+
+Add a changeset describing your change, then merge. The release PR opened on `main` publishes to npm when merged.
+
+```sh
+yarn changeset
+```
+
+## License
+
+Unlicensed — Copyright (c) Wistia, Inc. and its affiliates. All rights reserved.

package/dist/index.d.ts

@@ -0,0 +1,147 @@
+
+//#region src/types.d.ts
+/** Red, green and blue channels, each in the 0–255 range. */
+type RgbTuple = [red: number, green: number, blue: number];
+/** Red, green and blue channels (0–255) plus an alpha channel (0–1). */
+type RgbaTuple = [red: number, green: number, blue: number, alpha: number];
+/** RGB channels (0–255) with an optional alpha channel (0–1). */
+type ColorTuple = [red: number, green: number, blue: number, alpha?: number];
+/** Any object carrying RGB channels (0–255) and an optional alpha channel (0–1). */
+type RgbaObject = {
+  readonly a?: number;
+  readonly b: number;
+  readonly g: number;
+  readonly r: number;
+};
+/**
+ * Anything that can be read as a color:
+ *
+ * - a hex string — `#rgb`, `#rgba`, `#rrggbb`, `#rrggbbaa` (the `#` is optional)
+ * - an `rgb()`/`rgba()` string in either legacy comma syntax (`rgb(41, 73, 229)`) or
+ *   modern space syntax (`rgb(41 73 229 / 50%)`), with numbers or percentages
+ * - an `[r, g, b]` or `[r, g, b, a]` tuple
+ * - an object with `r`, `g`, `b` and optionally `a` — including another `Color`
+ *
+ * CSS named colors (`red`, `transparent`, …) are not supported.
+ */
+type ColorInput = Color | ColorTuple | RgbaObject | string;
+/** Hue (0–360), saturation (0–100) and lightness (0–100). */
+type Hsl = {
+  readonly hue: number;
+  readonly lightness: number;
+  readonly saturation: number;
+};
+/**
+ * CIELAB: perceptual lightness (0–100), plus the green–red (`a`) and blue–yellow (`b`)
+ * axes, which are unbounded but in practice fall within ±128.
+ */
+type Lab = {
+  readonly a: number;
+  readonly b: number;
+  readonly lightness: number;
+};
+/**
+ * The color space a blend interpolates through.
+ *
+ * - `lab` — perceptually uniform; the most even-looking scales, at the cost of some speed
+ * - `lrgb` — linear RGB; avoids the muddy midpoints of naive RGB blending
+ * - `rgb` — naive channel-wise RGB; fastest, and what CSS `color-mix()` does in sRGB
+ */
+type InterpolationMode = "lab" | "lrgb" | "rgb";
+//#endregion
+//#region src/Color.d.ts
+/**
+ * An immutable sRGB color with transformation methods like lighten, darken, tint, shade.
+ * Also includes methods to calculate contrast ratio against another color, relative luminance, etc.
+ *
+ * @example
+ * ```ts
+ * new Color('#2949e5').shade(0.8).toHex();     // '#0a1339'
+ * new Color('#2949e5').withAlpha(0.5).toRgba(); // 'rgba(41, 73, 229, 0.5)'
+ * new Color('#2949e5').contrast('#ffffff');     // 6.6
+ * ```
+ */
+declare class Color {
+  /**
+   * Read `input` into a color, returning `null` when it cannot be parsed.
+   */
+  static parse(input: ColorInput): Color | null;
+  static fromHsl(hsl: Hsl, alpha?: number): Color;
+  static fromLab(lab: Lab, alpha?: number): Color;
+  /** Red channel, 0–255. Kept unrounded so that chained operations don't accumulate error. */
+  readonly r: number;
+  /** Green channel, 0–255. Kept unrounded so that chained operations don't accumulate error. */
+  readonly g: number;
+  /** Blue channel, 0–255. Kept unrounded so that chained operations don't accumulate error. */
+  readonly b: number;
+  /** Alpha channel, 0–1. */
+  readonly a: number;
+  /**
+   * @param input - any supported color representation. Input that cannot be read as a
+   *   color resolves to brand blue rather than failing, so a malformed value degrades to
+   *   a usable color instead of interrupting a render.
+   */
+  constructor(input: ColorInput);
+  /** `#rrggbb`. Alpha is dropped — use {@link Color.toHexWithAlpha} to keep it. */
+  toHex(): string;
+  /** `#rrggbbaa`. */
+  toHexWithAlpha(): string;
+  /** `rgb(41, 73, 229)`. */
+  toRgb(): string;
+  /** `rgba(41, 73, 229, 0.5)`. */
+  toRgba(): string;
+  /** Rounded channels, ready to hand to another color library. */
+  toRgbaTuple(): RgbaTuple;
+  toHsl(): Hsl;
+  toLab(): Lab;
+  /** Hex when fully opaque, `rgba()` otherwise, so the alpha is never silently lost. */
+  toString(): string;
+  /**
+   * WCAG relative luminance, from 0 (black) to 1 (white). Alpha is ignored — luminance
+   * is only meaningful once a color has been composited onto a background.
+   */
+  luminance(): number;
+  /**
+   * WCAG contrast ratio against `other`, from 1 (identical) to 21 (black on white),
+   * reported to one decimal place.
+   *
+   * @see {@link colorContrastRatiosByShape} for the ratio each kind of content needs
+   */
+  contrast(other: ColorInput): number;
+  /**
+   * Raise perceptual lightness. Each unit of `amount` moves the color 18 points up the
+   * Lab lightness axis, which stays visually even across hues in a way that nudging RGB
+   * channels does not.
+   */
+  lighten(amount?: number): Color;
+  /** Lower perceptual lightness. The inverse of {@link Color.lighten}. */
+  darken(amount?: number): Color;
+  /** Mix `ratio` (0–1) of white in. */
+  tint(ratio: number, mode?: InterpolationMode): Color;
+  /** Mix `ratio` (0–1) of black in. */
+  shade(ratio: number, mode?: InterpolationMode): Color;
+  /**
+   * Mix towards `other`, where `ratio` 0 keeps this color and 1 returns `other`. Alpha is
+   * always interpolated linearly, whichever `mode` the channels travel through.
+   */
+  blend(other: ColorInput, ratio?: number, mode?: InterpolationMode): Color;
+  /** Replace the alpha channel with `alpha` (0–1). */
+  withAlpha(alpha: number): Color;
+  /**
+   * Replace HSL lightness with `lightness` (0–100), leaving hue and saturation alone.
+   * Use this to hit an absolute lightness; use {@link Color.lighten} to step relative to
+   * where the color already is.
+   */
+  withLightness(lightness: number): Color;
+}
+//#endregion
+//#region src/colorContrastRatiosByShape.d.ts
+declare const colorContrastRatiosByShape: {
+  nonText: number;
+  largeText: number;
+  paragraphText: number;
+  smallText: number;
+};
+//#endregion
+export { Color, type ColorInput, type ColorTuple, type Hsl, type InterpolationMode, type Lab, type RgbTuple, type RgbaObject, type RgbaTuple, colorContrastRatiosByShape };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/Color.ts","../src/colorContrastRatiosByShape.ts"],"mappings":";;;KAIY,YAAY,aAAa,eAAe;;KAGxC,aAAa,aAAa,eAAe,cAAc;;KAGvD,cAAc,aAAa,eAAe,cAAc;;KAGxD;WACD;WACA;WACA;WACA;;;;;;;;;;;;;KAcC,aAAa,QAAQ,aAAa;;KAGlC;WACD;WACA;WACA;;;;;;KAOC;WACD;WACA;WACA;;;;;;;;;KAUC;;;;;;;;;;;;;;cCTC;;;;SAIJ,MAAM,OAAO,aAAa;SAK1B,QAAQ,KAAK,KAAK,iBAAY;SAK9B,QAAQ,KAAK,KAAK,iBAAY;;WAM5B;;WAGA;;WAGA;;WAGA;;;;;;EAOT,YAAY,OAAO;;EASnB;;EAKA;;EAKA;;EAKA;;EAKA,eAAe;EAIf,SAAS;EAIT,SAAS;;EAKT;;;;;EAQA;;;;;;;EAUA,SAAS,OAAO;;;;;;EAahB,QAAQ,kBAAa;;EAMrB,OAAO,kBAAa;;EAKpB,KAAK,eAAe,OAAM,oBAAiD;;EAK3E,MAAM,eAAe,OAAM,oBAAiD;;;;;EAQ5E,MACE,OAAO,YACP,gBACA,OAAM,oBACL;;EA4BH,UAAU,gBAAgB;;;;;;EAS1B,cAAc,oBAAoB;;;;cC9NvB;EACX;EACA;EACA;EACA"}

package/dist/index.js

@@ -0,0 +1,449 @@
+
+/*
+ * @license @wistia/kaleidoscope v0.0.0-beta.1e8dd2d4.d35c078
+ *
+ * Copyright (c) 2026, Wistia, Inc. and its affiliates.
+ *
+ * This source code is unlicensed, all rights reserved.
+ */
+
+//#region src/private/clamp.ts
+/** Restrict `value` to the inclusive range between `min` and `max`. */
+const clamp = (value, min, max) => Math.min(Math.max(value, min), max);
+//#endregion
+//#region src/private/colorSpace.ts
+const D65_WHITE_POINT = {
+	x: .95047,
+	y: 1,
+	z: 1.08883
+};
+const LAB_EPSILON = 216 / 24389;
+const LAB_KAPPA = 24389 / 27;
+const LAB_LINEAR_LIGHTNESS_THRESHOLD = 8;
+/** Gamma-decode a 0–255 sRGB channel into linear light. */
+const linearize = (channel) => {
+	const normalized = channel / 255;
+	return normalized <= .04045 ? normalized / 12.92 : ((normalized + .055) / 1.055) ** 2.4;
+};
+/**
+* Gamma-encode linear light back into a 0–255 sRGB channel. The sign is carried through
+* the exponent so that out-of-gamut Lab values produce a negative channel rather than NaN.
+* Inverse of linearize.
+*/
+const compand = (linear) => {
+	const magnitude = Math.abs(linear);
+	return (magnitude <= .0031308 ? magnitude * 12.92 : 1.055 * magnitude ** (1 / 2.4) - .055) * Math.sign(linear) * 255;
+};
+const pivot = (value) => value > LAB_EPSILON ? Math.cbrt(value) : (LAB_KAPPA * value + 16) / 116;
+const hueToChannel = (start, end, givenHue) => {
+	let hue = givenHue;
+	if (hue < 0) hue += 1;
+	if (hue > 1) hue -= 1;
+	if (hue < 1 / 6) return start + (end - start) * 6 * hue;
+	if (hue < 1 / 2) return end;
+	if (hue < 2 / 3) return start + (end - start) * (2 / 3 - hue) * 6;
+	return start;
+};
+/**
+* WCAG relative luminance (0–1).
+*
+* @see https://www.w3.org/WAI/GL/wiki/Relative_luminance
+*/
+const relativeLuminance = (red, green, blue) => .2126 * linearize(red) + .7152 * linearize(green) + .0722 * linearize(blue);
+const rgbToHsl = (red, green, blue) => {
+	const r = red / 255;
+	const g = green / 255;
+	const b = blue / 255;
+	const max = Math.max(r, g, b);
+	const min = Math.min(r, g, b);
+	const lightness = (max + min) / 2;
+	const delta = max - min;
+	if (delta === 0) return {
+		hue: 0,
+		lightness: lightness * 100,
+		saturation: 0
+	};
+	const saturation = lightness > .5 ? delta / (2 - max - min) : delta / (max + min);
+	let hue;
+	if (max === r) hue = (g - b) / delta + (g < b ? 6 : 0);
+	else if (max === g) hue = (b - r) / delta + 2;
+	else hue = (r - g) / delta + 4;
+	return {
+		hue: hue / 6 * 360,
+		lightness: lightness * 100,
+		saturation: saturation * 100
+	};
+};
+const hslToRgb = ({ hue, lightness, saturation }) => {
+	const h = hue / 360;
+	const s = saturation / 100;
+	const l = lightness / 100;
+	const end = l < .5 ? l * (1 + s) : l + s - l * s;
+	const start = 2 * l - end;
+	return [
+		hueToChannel(start, end, h + 1 / 3) * 255,
+		hueToChannel(start, end, h) * 255,
+		hueToChannel(start, end, h - 1 / 3) * 255
+	];
+};
+const rgbToLab = (red, green, blue) => {
+	const r = linearize(red);
+	const g = linearize(green);
+	const b = linearize(blue);
+	const x = (.4124564 * r + .3575761 * g + .1804375 * b) / D65_WHITE_POINT.x;
+	const y = (.2126729 * r + .7151522 * g + .072175 * b) / D65_WHITE_POINT.y;
+	const z = (.0193339 * r + .119192 * g + .9503041 * b) / D65_WHITE_POINT.z;
+	const fx = pivot(x);
+	const fy = pivot(y);
+	const fz = pivot(z);
+	return {
+		a: 500 * (fx - fy),
+		b: 200 * (fy - fz),
+		lightness: 116 * fy - 16
+	};
+};
+const labToRgb = ({ a, b, lightness }) => {
+	const fy = (lightness + 16) / 116;
+	const fx = fy + a / 500;
+	const fz = fy - b / 200;
+	const x = (fx ** 3 > LAB_EPSILON ? fx ** 3 : (116 * fx - 16) / LAB_KAPPA) * D65_WHITE_POINT.x;
+	const y = (lightness > LAB_LINEAR_LIGHTNESS_THRESHOLD ? fy ** 3 : lightness / LAB_KAPPA) * D65_WHITE_POINT.y;
+	const z = (fz ** 3 > LAB_EPSILON ? fz ** 3 : (116 * fz - 16) / LAB_KAPPA) * D65_WHITE_POINT.z;
+	return [
+		compand(3.2404542 * x - 1.5371385 * y - .4985314 * z),
+		compand(-.969266 * x + 1.8760108 * y + .041556 * z),
+		compand(.0556434 * x - .2040259 * y + 1.0572252 * z)
+	];
+};
+//#endregion
+//#region src/private/parseColor.ts
+const HEX_PATTERN = /^#?([\da-f]{3,4}|[\da-f]{6}|[\da-f]{8})$/i;
+const RGB_FUNCTION_PATTERN = /^rgba?\(([^)]*)\)$/i;
+const NUMBER_PATTERN = /^[+-]?(?:\d+\.?\d*|\.\d+)$/;
+const PERCENTAGE_PATTERN = /^[+-]?(?:\d+\.?\d*|\.\d+)%$/;
+const SEPARATOR_PATTERN = /[\s,]+/;
+const MAX_CHANNEL = 255;
+const HEX_RADIX$1 = 16;
+const toChannel = (value) => clamp(value, 0, MAX_CHANNEL);
+const toAlpha = (value) => clamp(value, 0, 1);
+/**
+* Read a numeric token, where a percentage is taken as a fraction of `percentageOf`. A
+* channel is `128` or `50%` (of 255); an alpha is `0.5` or `50%` (of 1).
+*/
+const parseNumericToken = (token, percentageOf) => {
+	if (token === void 0) return null;
+	if (PERCENTAGE_PATTERN.test(token)) return Number(token.slice(0, -1)) / 100 * percentageOf;
+	if (NUMBER_PATTERN.test(token)) return Number(token);
+	return null;
+};
+const parseChannelToken = (token) => {
+	const value = parseNumericToken(token, MAX_CHANNEL);
+	return value === null ? null : toChannel(value);
+};
+const parseAlphaToken = (token) => {
+	const value = parseNumericToken(token, 1);
+	return value === null ? null : toAlpha(value);
+};
+const parseHex = (value) => {
+	const digits = HEX_PATTERN.exec(value)?.[1];
+	if (digits === void 0) return null;
+	const expanded = digits.length <= 4 ? digits.replaceAll(/./g, "$&$&") : digits;
+	return [
+		Number.parseInt(expanded.slice(0, 2), HEX_RADIX$1),
+		Number.parseInt(expanded.slice(2, 4), HEX_RADIX$1),
+		Number.parseInt(expanded.slice(4, 6), HEX_RADIX$1),
+		expanded.length === 8 ? Number.parseInt(expanded.slice(6, 8), HEX_RADIX$1) / MAX_CHANNEL : 1
+	];
+};
+const parseRgbFunction = (value) => {
+	const body = RGB_FUNCTION_PATTERN.exec(value)?.[1];
+	if (body === void 0) return null;
+	const [channelSource, alphaSource, ...extraSources] = body.split("/");
+	if (channelSource === void 0 || extraSources.length > 0) return null;
+	const tokens = channelSource.trim().split(SEPARATOR_PATTERN).filter(Boolean);
+	const alphaTokens = (alphaSource ?? "").trim().split(SEPARATOR_PATTERN).filter(Boolean);
+	if (alphaTokens.length > 1) return null;
+	const [redToken, greenToken, blueToken, legacyAlphaToken, ...extraTokens] = tokens;
+	if (extraTokens.length > 0) return null;
+	if (alphaSource !== void 0 && legacyAlphaToken !== void 0) return null;
+	const red = parseChannelToken(redToken);
+	const green = parseChannelToken(greenToken);
+	const blue = parseChannelToken(blueToken);
+	if (red === null || green === null || blue === null) return null;
+	const alphaToken = alphaTokens[0] ?? legacyAlphaToken;
+	if (alphaToken === void 0) return [
+		red,
+		green,
+		blue,
+		1
+	];
+	const alpha = parseAlphaToken(alphaToken);
+	return alpha === null ? null : [
+		red,
+		green,
+		blue,
+		alpha
+	];
+};
+/**
+* Read any supported color representation into RGBA channels, or `null` when the input
+* is not a color this package understands.
+*/
+const parseColor = (input) => {
+	if (typeof input === "string") {
+		const trimmed = input.trim();
+		return parseHex(trimmed) ?? parseRgbFunction(trimmed);
+	}
+	if (Array.isArray(input)) {
+		const [red, green, blue, alpha = 1] = input;
+		if (![
+			red,
+			green,
+			blue,
+			alpha
+		].every((value) => Number.isFinite(value))) return null;
+		return [
+			toChannel(red),
+			toChannel(green),
+			toChannel(blue),
+			toAlpha(alpha)
+		];
+	}
+	const { r, g, b, a = 1 } = input;
+	if (![
+		r,
+		g,
+		b,
+		a
+	].every((value) => Number.isFinite(value))) return null;
+	return [
+		toChannel(r),
+		toChannel(g),
+		toChannel(b),
+		toAlpha(a)
+	];
+};
+//#endregion
+//#region src/Color.ts
+const HEX_RADIX = 16;
+/** Lab lightness covered by one unit of `lighten()`/`darken()` */
+const LAB_LIGHTNESS_STEP = 18;
+const DEFAULT_INTERPOLATION_MODE = "lrgb";
+const WHITE = "#ffffff";
+const BLACK = "#000000";
+/** Wistia brand blue (`#2949e5`) — what an unreadable input resolves to. */
+const FALLBACK_CHANNELS = [
+	41,
+	73,
+	229,
+	1
+];
+const toHexPair = (channel) => Math.round(channel).toString(HEX_RADIX).padStart(2, "0");
+/**
+* Truncated rather than rounded, so a ratio can never climb across a WCAG threshold on
+* its way to one decimal — 4.4501 reports as 4.4, not as a passing 4.5.
+*/
+const truncateToTenth = (ratio) => Math.floor(ratio * 10) / 10;
+const interpolate = (from, to, ratio) => from + (to - from) * ratio;
+/**
+* Interpolate through linear light rather than gamma-encoded sRGB, which keeps blends
+* between saturated colors from sagging through a muddy midpoint.
+*/
+const interpolateLinear = (from, to, ratio) => Math.sqrt(from ** 2 * (1 - ratio) + to ** 2 * ratio);
+/**
+* An immutable sRGB color with transformation methods like lighten, darken, tint, shade.
+* Also includes methods to calculate contrast ratio against another color, relative luminance, etc.
+*
+* @example
+* ```ts
+* new Color('#2949e5').shade(0.8).toHex();     // '#0a1339'
+* new Color('#2949e5').withAlpha(0.5).toRgba(); // 'rgba(41, 73, 229, 0.5)'
+* new Color('#2949e5').contrast('#ffffff');     // 6.6
+* ```
+*/
+var Color = class Color {
+	/**
+	* Read `input` into a color, returning `null` when it cannot be parsed.
+	*/
+	static parse(input) {
+		const channels = parseColor(input);
+		return channels === null ? null : new Color(channels);
+	}
+	static fromHsl(hsl, alpha = 1) {
+		const [red, green, blue] = hslToRgb(hsl);
+		return new Color([
+			red,
+			green,
+			blue,
+			alpha
+		]);
+	}
+	static fromLab(lab, alpha = 1) {
+		const [red, green, blue] = labToRgb(lab);
+		return new Color([
+			red,
+			green,
+			blue,
+			alpha
+		]);
+	}
+	/** Red channel, 0–255. Kept unrounded so that chained operations don't accumulate error. */
+	r;
+	/** Green channel, 0–255. Kept unrounded so that chained operations don't accumulate error. */
+	g;
+	/** Blue channel, 0–255. Kept unrounded so that chained operations don't accumulate error. */
+	b;
+	/** Alpha channel, 0–1. */
+	a;
+	/**
+	* @param input - any supported color representation. Input that cannot be read as a
+	*   color resolves to brand blue rather than failing, so a malformed value degrades to
+	*   a usable color instead of interrupting a render.
+	*/
+	constructor(input) {
+		const [red, green, blue, alpha] = parseColor(input) ?? FALLBACK_CHANNELS;
+		this.r = red;
+		this.g = green;
+		this.b = blue;
+		this.a = alpha;
+	}
+	/** `#rrggbb`. Alpha is dropped — use {@link Color.toHexWithAlpha} to keep it. */
+	toHex() {
+		return `#${toHexPair(this.r)}${toHexPair(this.g)}${toHexPair(this.b)}`;
+	}
+	/** `#rrggbbaa`. */
+	toHexWithAlpha() {
+		return `${this.toHex()}${toHexPair(this.a * 255)}`;
+	}
+	/** `rgb(41, 73, 229)`. */
+	toRgb() {
+		return `rgb(${Math.round(this.r)}, ${Math.round(this.g)}, ${Math.round(this.b)})`;
+	}
+	/** `rgba(41, 73, 229, 0.5)`. */
+	toRgba() {
+		return `rgba(${Math.round(this.r)}, ${Math.round(this.g)}, ${Math.round(this.b)}, ${this.a})`;
+	}
+	/** Rounded channels, ready to hand to another color library. */
+	toRgbaTuple() {
+		return [
+			Math.round(this.r),
+			Math.round(this.g),
+			Math.round(this.b),
+			this.a
+		];
+	}
+	toHsl() {
+		return rgbToHsl(this.r, this.g, this.b);
+	}
+	toLab() {
+		return rgbToLab(this.r, this.g, this.b);
+	}
+	/** Hex when fully opaque, `rgba()` otherwise, so the alpha is never silently lost. */
+	toString() {
+		return this.a === 1 ? this.toHex() : this.toRgba();
+	}
+	/**
+	* WCAG relative luminance, from 0 (black) to 1 (white). Alpha is ignored — luminance
+	* is only meaningful once a color has been composited onto a background.
+	*/
+	luminance() {
+		return relativeLuminance(this.r, this.g, this.b);
+	}
+	/**
+	* WCAG contrast ratio against `other`, from 1 (identical) to 21 (black on white),
+	* reported to one decimal place.
+	*
+	* @see {@link colorContrastRatiosByShape} for the ratio each kind of content needs
+	*/
+	contrast(other) {
+		const ownLuminance = this.luminance();
+		const otherLuminance = new Color(other).luminance();
+		const lighter = Math.max(ownLuminance, otherLuminance);
+		const darker = Math.min(ownLuminance, otherLuminance);
+		return truncateToTenth((lighter + .05) / (darker + .05));
+	}
+	/**
+	* Raise perceptual lightness. Each unit of `amount` moves the color 18 points up the
+	* Lab lightness axis, which stays visually even across hues in a way that nudging RGB
+	* channels does not.
+	*/
+	lighten(amount = 1) {
+		const { a, b, lightness } = this.toLab();
+		return Color.fromLab({
+			a,
+			b,
+			lightness: lightness + LAB_LIGHTNESS_STEP * amount
+		}, this.a);
+	}
+	/** Lower perceptual lightness. The inverse of {@link Color.lighten}. */
+	darken(amount = 1) {
+		return this.lighten(-amount);
+	}
+	/** Mix `ratio` (0–1) of white in. */
+	tint(ratio, mode = DEFAULT_INTERPOLATION_MODE) {
+		return this.blend(WHITE, ratio, mode);
+	}
+	/** Mix `ratio` (0–1) of black in. */
+	shade(ratio, mode = DEFAULT_INTERPOLATION_MODE) {
+		return this.blend(BLACK, ratio, mode);
+	}
+	/**
+	* Mix towards `other`, where `ratio` 0 keeps this color and 1 returns `other`. Alpha is
+	* always interpolated linearly, whichever `mode` the channels travel through.
+	*/
+	blend(other, ratio = .5, mode = DEFAULT_INTERPOLATION_MODE) {
+		const target = new Color(other);
+		const amount = clamp(ratio, 0, 1);
+		const alpha = interpolate(this.a, target.a, amount);
+		if (mode === "lab") {
+			const from = this.toLab();
+			const to = target.toLab();
+			return Color.fromLab({
+				a: interpolate(from.a, to.a, amount),
+				b: interpolate(from.b, to.b, amount),
+				lightness: interpolate(from.lightness, to.lightness, amount)
+			}, alpha);
+		}
+		const blendChannel = mode === "lrgb" ? interpolateLinear : interpolate;
+		return new Color([
+			blendChannel(this.r, target.r, amount),
+			blendChannel(this.g, target.g, amount),
+			blendChannel(this.b, target.b, amount),
+			alpha
+		]);
+	}
+	/** Replace the alpha channel with `alpha` (0–1). */
+	withAlpha(alpha) {
+		return new Color([
+			this.r,
+			this.g,
+			this.b,
+			alpha
+		]);
+	}
+	/**
+	* Replace HSL lightness with `lightness` (0–100), leaving hue and saturation alone.
+	* Use this to hit an absolute lightness; use {@link Color.lighten} to step relative to
+	* where the color already is.
+	*/
+	withLightness(lightness) {
+		const { hue, saturation } = this.toHsl();
+		return Color.fromHsl({
+			hue,
+			lightness: clamp(lightness, 0, 100),
+			saturation
+		}, this.a);
+	}
+};
+//#endregion
+//#region src/colorContrastRatiosByShape.ts
+const colorContrastRatiosByShape = {
+	nonText: 3,
+	largeText: 3,
+	paragraphText: 4.5,
+	smallText: 5.5
+};
+//#endregion
+export { Color, colorContrastRatiosByShape };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["HEX_RADIX"],"sources":["../src/private/clamp.ts","../src/private/colorSpace.ts","../src/private/parseColor.ts","../src/Color.ts","../src/colorContrastRatiosByShape.ts"],"sourcesContent":["/** Restrict `value` to the inclusive range between `min` and `max`. */\nexport const clamp = (value: number, min: number, max: number): number =>\n  Math.min(Math.max(value, min), max);\n","// oxlint-disable id-length -- single-letter names mirror the color-space formulas\nimport type { Hsl, Lab, RgbTuple } from '../types';\n\nconst D65_WHITE_POINT = { x: 0.95047, y: 1, z: 1.08883 };\n\n// CIE standard constants: 216/24389 and 24389/27. Their product, 8, is the L* below\n// which the Lab transfer function stays linear.\nconst LAB_EPSILON = 216 / 24389;\nconst LAB_KAPPA = 24389 / 27;\nconst LAB_LINEAR_LIGHTNESS_THRESHOLD = 8;\n\n/** Gamma-decode a 0–255 sRGB channel into linear light. */\nconst linearize = (channel: number): number => {\n  const normalized = channel / 255;\n  return normalized <= 0.04045 ? normalized / 12.92 : ((normalized + 0.055) / 1.055) ** 2.4;\n};\n\n/**\n * Gamma-encode linear light back into a 0–255 sRGB channel. The sign is carried through\n * the exponent so that out-of-gamut Lab values produce a negative channel rather than NaN.\n * Inverse of linearize.\n */\nconst compand = (linear: number): number => {\n  const magnitude = Math.abs(linear);\n  const encoded =\n    magnitude <= 0.0031308 ? magnitude * 12.92 : 1.055 * magnitude ** (1 / 2.4) - 0.055;\n  return encoded * Math.sign(linear) * 255;\n};\n\nconst pivot = (value: number): number =>\n  value > LAB_EPSILON ? Math.cbrt(value) : (LAB_KAPPA * value + 16) / 116;\n\nconst hueToChannel = (start: number, end: number, givenHue: number): number => {\n  let hue = givenHue;\n  if (hue < 0) {\n    hue += 1;\n  }\n  if (hue > 1) {\n    hue -= 1;\n  }\n  if (hue < 1 / 6) {\n    return start + (end - start) * 6 * hue;\n  }\n  if (hue < 1 / 2) {\n    return end;\n  }\n  if (hue < 2 / 3) {\n    return start + (end - start) * (2 / 3 - hue) * 6;\n  }\n  return start;\n};\n\n/**\n * WCAG relative luminance (0–1).\n *\n * @see https://www.w3.org/WAI/GL/wiki/Relative_luminance\n */\nexport const relativeLuminance = (red: number, green: number, blue: number): number =>\n  0.2126 * linearize(red) + 0.7152 * linearize(green) + 0.0722 * linearize(blue);\n\nexport const rgbToHsl = (red: number, green: number, blue: number): Hsl => {\n  const r = red / 255;\n  const g = green / 255;\n  const b = blue / 255;\n  const max = Math.max(r, g, b);\n  const min = Math.min(r, g, b);\n  const lightness = (max + min) / 2;\n  const delta = max - min;\n\n  if (delta === 0) {\n    return { hue: 0, lightness: lightness * 100, saturation: 0 };\n  }\n\n  const saturation = lightness > 0.5 ? delta / (2 - max - min) : delta / (max + min);\n\n  let hue: number;\n  if (max === r) {\n    hue = (g - b) / delta + (g < b ? 6 : 0);\n  } else if (max === g) {\n    hue = (b - r) / delta + 2;\n  } else {\n    hue = (r - g) / delta + 4;\n  }\n\n  return { hue: (hue / 6) * 360, lightness: lightness * 100, saturation: saturation * 100 };\n};\n\nexport const hslToRgb = ({ hue, lightness, saturation }: Hsl): RgbTuple => {\n  const h = hue / 360;\n  const s = saturation / 100;\n  const l = lightness / 100;\n  const end = l < 0.5 ? l * (1 + s) : l + s - l * s;\n  const start = 2 * l - end;\n\n  return [\n    hueToChannel(start, end, h + 1 / 3) * 255,\n    hueToChannel(start, end, h) * 255,\n    hueToChannel(start, end, h - 1 / 3) * 255,\n  ];\n};\n\nexport const rgbToLab = (red: number, green: number, blue: number): Lab => {\n  const r = linearize(red);\n  const g = linearize(green);\n  const b = linearize(blue);\n\n  const x = (0.4124564 * r + 0.3575761 * g + 0.1804375 * b) / D65_WHITE_POINT.x;\n  const y = (0.2126729 * r + 0.7151522 * g + 0.072175 * b) / D65_WHITE_POINT.y;\n  const z = (0.0193339 * r + 0.119192 * g + 0.9503041 * b) / D65_WHITE_POINT.z;\n\n  const fx = pivot(x);\n  const fy = pivot(y);\n  const fz = pivot(z);\n\n  return { a: 500 * (fx - fy), b: 200 * (fy - fz), lightness: 116 * fy - 16 };\n};\n\nexport const labToRgb = ({ a, b, lightness }: Lab): RgbTuple => {\n  const fy = (lightness + 16) / 116;\n  const fx = fy + a / 500;\n  const fz = fy - b / 200;\n\n  const x = (fx ** 3 > LAB_EPSILON ? fx ** 3 : (116 * fx - 16) / LAB_KAPPA) * D65_WHITE_POINT.x;\n  const y =\n    (lightness > LAB_LINEAR_LIGHTNESS_THRESHOLD ? fy ** 3 : lightness / LAB_KAPPA) *\n    D65_WHITE_POINT.y;\n  const z = (fz ** 3 > LAB_EPSILON ? fz ** 3 : (116 * fz - 16) / LAB_KAPPA) * D65_WHITE_POINT.z;\n\n  return [\n    compand(3.2404542 * x - 1.5371385 * y - 0.4985314 * z),\n    compand(-0.969266 * x + 1.8760108 * y + 0.041556 * z),\n    compand(0.0556434 * x - 0.2040259 * y + 1.0572252 * z),\n  ];\n};\n","// oxlint-disable id-length -- r/g/b/a are the canonical names for color channels\nimport type { ColorInput, RgbaTuple } from '../types';\nimport { clamp } from './clamp';\n\nconst HEX_PATTERN = /^#?([\\da-f]{3,4}|[\\da-f]{6}|[\\da-f]{8})$/i;\nconst RGB_FUNCTION_PATTERN = /^rgba?\\(([^)]*)\\)$/i;\nconst NUMBER_PATTERN = /^[+-]?(?:\\d+\\.?\\d*|\\.\\d+)$/;\nconst PERCENTAGE_PATTERN = /^[+-]?(?:\\d+\\.?\\d*|\\.\\d+)%$/;\nconst SEPARATOR_PATTERN = /[\\s,]+/;\n\nconst MAX_CHANNEL = 255;\nconst HEX_RADIX = 16;\n\nconst toChannel = (value: number): number => clamp(value, 0, MAX_CHANNEL);\nconst toAlpha = (value: number): number => clamp(value, 0, 1);\n\n/**\n * Read a numeric token, where a percentage is taken as a fraction of `percentageOf`. A\n * channel is `128` or `50%` (of 255); an alpha is `0.5` or `50%` (of 1).\n */\nconst parseNumericToken = (token: string | undefined, percentageOf: number): number | null => {\n  if (token === undefined) {\n    return null;\n  }\n  if (PERCENTAGE_PATTERN.test(token)) {\n    return (Number(token.slice(0, -1)) / 100) * percentageOf;\n  }\n  if (NUMBER_PATTERN.test(token)) {\n    return Number(token);\n  }\n  return null;\n};\n\nconst parseChannelToken = (token: string | undefined): number | null => {\n  const value = parseNumericToken(token, MAX_CHANNEL);\n  return value === null ? null : toChannel(value);\n};\n\nconst parseAlphaToken = (token: string | undefined): number | null => {\n  const value = parseNumericToken(token, 1);\n  return value === null ? null : toAlpha(value);\n};\n\nconst parseHex = (value: string): RgbaTuple | null => {\n  const match = HEX_PATTERN.exec(value);\n  const digits = match?.[1];\n  if (digits === undefined) {\n    return null;\n  }\n\n  // #rgb and #rgba are shorthand for each digit repeated: #1a2 -> #11aa22\n  const expanded = digits.length <= 4 ? digits.replaceAll(/./g, '$&$&') : digits;\n\n  return [\n    Number.parseInt(expanded.slice(0, 2), HEX_RADIX),\n    Number.parseInt(expanded.slice(2, 4), HEX_RADIX),\n    Number.parseInt(expanded.slice(4, 6), HEX_RADIX),\n    expanded.length === 8 ? Number.parseInt(expanded.slice(6, 8), HEX_RADIX) / MAX_CHANNEL : 1,\n  ];\n};\n\nconst parseRgbFunction = (value: string): RgbaTuple | null => {\n  const match = RGB_FUNCTION_PATTERN.exec(value);\n  const body = match?.[1];\n  if (body === undefined) {\n    return null;\n  }\n\n  // Modern syntax puts alpha behind a slash: rgb(41 73 229 / 50%)\n  const [channelSource, alphaSource, ...extraSources] = body.split('/');\n  if (channelSource === undefined || extraSources.length > 0) {\n    return null;\n  }\n\n  const tokens = channelSource.trim().split(SEPARATOR_PATTERN).filter(Boolean);\n  const alphaTokens = (alphaSource ?? '').trim().split(SEPARATOR_PATTERN).filter(Boolean);\n  if (alphaTokens.length > 1) {\n    return null;\n  }\n\n  const [redToken, greenToken, blueToken, legacyAlphaToken, ...extraTokens] = tokens;\n  if (extraTokens.length > 0) {\n    return null;\n  }\n  if (alphaSource !== undefined && legacyAlphaToken !== undefined) {\n    return null;\n  }\n\n  const red = parseChannelToken(redToken);\n  const green = parseChannelToken(greenToken);\n  const blue = parseChannelToken(blueToken);\n  if (red === null || green === null || blue === null) {\n    return null;\n  }\n\n  const alphaToken = alphaTokens[0] ?? legacyAlphaToken;\n  if (alphaToken === undefined) {\n    return [red, green, blue, 1];\n  }\n\n  const alpha = parseAlphaToken(alphaToken);\n  return alpha === null ? null : [red, green, blue, alpha];\n};\n\n/**\n * Read any supported color representation into RGBA channels, or `null` when the input\n * is not a color this package understands.\n */\nexport const parseColor = (input: ColorInput): RgbaTuple | null => {\n  if (typeof input === 'string') {\n    const trimmed = input.trim();\n    return parseHex(trimmed) ?? parseRgbFunction(trimmed);\n  }\n\n  if (Array.isArray(input)) {\n    const [red, green, blue, alpha = 1] = input;\n    if (![red, green, blue, alpha].every((value) => Number.isFinite(value))) {\n      return null;\n    }\n    return [toChannel(red), toChannel(green), toChannel(blue), toAlpha(alpha)];\n  }\n\n  const { r, g, b, a = 1 } = input;\n  if (![r, g, b, a].every((value) => Number.isFinite(value))) {\n    return null;\n  }\n  return [toChannel(r), toChannel(g), toChannel(b), toAlpha(a)];\n};\n","import type { ColorInput, Hsl, InterpolationMode, Lab, RgbaTuple } from './types';\n// oxlint-disable id-length -- r/g/b/a are the canonical names for color channels\nimport { clamp } from './private/clamp';\nimport { hslToRgb, labToRgb, relativeLuminance, rgbToHsl, rgbToLab } from './private/colorSpace';\nimport { parseColor } from './private/parseColor';\n\nconst HEX_RADIX = 16;\n\n/** Lab lightness covered by one unit of `lighten()`/`darken()` */\nconst LAB_LIGHTNESS_STEP = 18;\n\nconst DEFAULT_INTERPOLATION_MODE: InterpolationMode = 'lrgb';\n\nconst WHITE = '#ffffff';\nconst BLACK = '#000000';\n\n/** Wistia brand blue (`#2949e5`) — what an unreadable input resolves to. */\nconst FALLBACK_CHANNELS: RgbaTuple = [41, 73, 229, 1];\n\nconst toHexPair = (channel: number): string =>\n  Math.round(channel).toString(HEX_RADIX).padStart(2, '0');\n\n/**\n * Truncated rather than rounded, so a ratio can never climb across a WCAG threshold on\n * its way to one decimal — 4.4501 reports as 4.4, not as a passing 4.5.\n */\nconst truncateToTenth = (ratio: number): number => Math.floor(ratio * 10) / 10;\n\nconst interpolate = (from: number, to: number, ratio: number): number => from + (to - from) * ratio;\n\n/**\n * Interpolate through linear light rather than gamma-encoded sRGB, which keeps blends\n * between saturated colors from sagging through a muddy midpoint.\n */\nconst interpolateLinear = (from: number, to: number, ratio: number): number =>\n  Math.sqrt(from ** 2 * (1 - ratio) + to ** 2 * ratio);\n\n/**\n * An immutable sRGB color with transformation methods like lighten, darken, tint, shade.\n * Also includes methods to calculate contrast ratio against another color, relative luminance, etc.\n *\n * @example\n * ```ts\n * new Color('#2949e5').shade(0.8).toHex();     // '#0a1339'\n * new Color('#2949e5').withAlpha(0.5).toRgba(); // 'rgba(41, 73, 229, 0.5)'\n * new Color('#2949e5').contrast('#ffffff');     // 6.6\n * ```\n */\nexport class Color {\n  /**\n   * Read `input` into a color, returning `null` when it cannot be parsed.\n   */\n  static parse(input: ColorInput): Color | null {\n    const channels = parseColor(input);\n    return channels === null ? null : new Color(channels);\n  }\n\n  static fromHsl(hsl: Hsl, alpha = 1): Color {\n    const [red, green, blue] = hslToRgb(hsl);\n    return new Color([red, green, blue, alpha]);\n  }\n\n  static fromLab(lab: Lab, alpha = 1): Color {\n    const [red, green, blue] = labToRgb(lab);\n    return new Color([red, green, blue, alpha]);\n  }\n\n  /** Red channel, 0–255. Kept unrounded so that chained operations don't accumulate error. */\n  readonly r: number;\n\n  /** Green channel, 0–255. Kept unrounded so that chained operations don't accumulate error. */\n  readonly g: number;\n\n  /** Blue channel, 0–255. Kept unrounded so that chained operations don't accumulate error. */\n  readonly b: number;\n\n  /** Alpha channel, 0–1. */\n  readonly a: number;\n\n  /**\n   * @param input - any supported color representation. Input that cannot be read as a\n   *   color resolves to brand blue rather than failing, so a malformed value degrades to\n   *   a usable color instead of interrupting a render.\n   */\n  constructor(input: ColorInput) {\n    const [red, green, blue, alpha] = parseColor(input) ?? FALLBACK_CHANNELS;\n    this.r = red;\n    this.g = green;\n    this.b = blue;\n    this.a = alpha;\n  }\n\n  /** `#rrggbb`. Alpha is dropped — use {@link Color.toHexWithAlpha} to keep it. */\n  toHex(): string {\n    return `#${toHexPair(this.r)}${toHexPair(this.g)}${toHexPair(this.b)}`;\n  }\n\n  /** `#rrggbbaa`. */\n  toHexWithAlpha(): string {\n    return `${this.toHex()}${toHexPair(this.a * 255)}`;\n  }\n\n  /** `rgb(41, 73, 229)`. */\n  toRgb(): string {\n    return `rgb(${Math.round(this.r)}, ${Math.round(this.g)}, ${Math.round(this.b)})`;\n  }\n\n  /** `rgba(41, 73, 229, 0.5)`. */\n  toRgba(): string {\n    return `rgba(${Math.round(this.r)}, ${Math.round(this.g)}, ${Math.round(this.b)}, ${this.a})`;\n  }\n\n  /** Rounded channels, ready to hand to another color library. */\n  toRgbaTuple(): RgbaTuple {\n    return [Math.round(this.r), Math.round(this.g), Math.round(this.b), this.a];\n  }\n\n  toHsl(): Hsl {\n    return rgbToHsl(this.r, this.g, this.b);\n  }\n\n  toLab(): Lab {\n    return rgbToLab(this.r, this.g, this.b);\n  }\n\n  /** Hex when fully opaque, `rgba()` otherwise, so the alpha is never silently lost. */\n  toString(): string {\n    return this.a === 1 ? this.toHex() : this.toRgba();\n  }\n\n  /**\n   * WCAG relative luminance, from 0 (black) to 1 (white). Alpha is ignored — luminance\n   * is only meaningful once a color has been composited onto a background.\n   */\n  luminance(): number {\n    return relativeLuminance(this.r, this.g, this.b);\n  }\n\n  /**\n   * WCAG contrast ratio against `other`, from 1 (identical) to 21 (black on white),\n   * reported to one decimal place.\n   *\n   * @see {@link colorContrastRatiosByShape} for the ratio each kind of content needs\n   */\n  contrast(other: ColorInput): number {\n    const ownLuminance = this.luminance();\n    const otherLuminance = new Color(other).luminance();\n    const lighter = Math.max(ownLuminance, otherLuminance);\n    const darker = Math.min(ownLuminance, otherLuminance);\n    return truncateToTenth((lighter + 0.05) / (darker + 0.05));\n  }\n\n  /**\n   * Raise perceptual lightness. Each unit of `amount` moves the color 18 points up the\n   * Lab lightness axis, which stays visually even across hues in a way that nudging RGB\n   * channels does not.\n   */\n  lighten(amount = 1): Color {\n    const { a, b, lightness } = this.toLab();\n    return Color.fromLab({ a, b, lightness: lightness + LAB_LIGHTNESS_STEP * amount }, this.a);\n  }\n\n  /** Lower perceptual lightness. The inverse of {@link Color.lighten}. */\n  darken(amount = 1): Color {\n    return this.lighten(-amount);\n  }\n\n  /** Mix `ratio` (0–1) of white in. */\n  tint(ratio: number, mode: InterpolationMode = DEFAULT_INTERPOLATION_MODE): Color {\n    return this.blend(WHITE, ratio, mode);\n  }\n\n  /** Mix `ratio` (0–1) of black in. */\n  shade(ratio: number, mode: InterpolationMode = DEFAULT_INTERPOLATION_MODE): Color {\n    return this.blend(BLACK, ratio, mode);\n  }\n\n  /**\n   * Mix towards `other`, where `ratio` 0 keeps this color and 1 returns `other`. Alpha is\n   * always interpolated linearly, whichever `mode` the channels travel through.\n   */\n  blend(\n    other: ColorInput,\n    ratio = 0.5,\n    mode: InterpolationMode = DEFAULT_INTERPOLATION_MODE,\n  ): Color {\n    const target = new Color(other);\n    const amount = clamp(ratio, 0, 1);\n    const alpha = interpolate(this.a, target.a, amount);\n\n    if (mode === 'lab') {\n      const from = this.toLab();\n      const to = target.toLab();\n      return Color.fromLab(\n        {\n          a: interpolate(from.a, to.a, amount),\n          b: interpolate(from.b, to.b, amount),\n          lightness: interpolate(from.lightness, to.lightness, amount),\n        },\n        alpha,\n      );\n    }\n\n    const blendChannel = mode === 'lrgb' ? interpolateLinear : interpolate;\n    return new Color([\n      blendChannel(this.r, target.r, amount),\n      blendChannel(this.g, target.g, amount),\n      blendChannel(this.b, target.b, amount),\n      alpha,\n    ]);\n  }\n\n  /** Replace the alpha channel with `alpha` (0–1). */\n  withAlpha(alpha: number): Color {\n    return new Color([this.r, this.g, this.b, alpha]);\n  }\n\n  /**\n   * Replace HSL lightness with `lightness` (0–100), leaving hue and saturation alone.\n   * Use this to hit an absolute lightness; use {@link Color.lighten} to step relative to\n   * where the color already is.\n   */\n  withLightness(lightness: number): Color {\n    const { hue, saturation } = this.toHsl();\n    return Color.fromHsl({ hue, lightness: clamp(lightness, 0, 100), saturation }, this.a);\n  }\n}\n","export const colorContrastRatiosByShape = {\n  nonText: 3.0, // 3.0:1 - https://www.w3.org/TR/WCAG21/#non-text-contrast\n  largeText: 3.0, // 3.0:1 - https://www.w3.org/TR/WCAG21/#contrast-minimum\n  paragraphText: 4.5, // 4.5:1 - https://www.w3.org/TR/WCAG21/#contrast-minimum\n  smallText: 5.5, // We're making this up, but it should be more than the paragraph text\n};\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@wistia/kaleidoscope",
+  "version": "0.0.0-beta.1e8dd2d4.d35c078",
+  "description": "Shared logic and token engine for Wistia's audience-facing design system",
+  "type": "module",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "scripts": {
+    "build:watch": "tsdown --watch",
+    "clean": "shx rm -rf ./dist && echo 'dist directory has been removed'",
+    "prepack": "vp run build",
+    "publint": "publint-check",
+    "publint:export": "check-export-map",
+    "test:ci": "vitest run --coverage",
+    "test:coverage": "yarn run test:ci && open ./coverage/index.html",
+    "test:watch": "vitest",
+    "typecheck": "tsc"
+  },
+  "devDependencies": {
+    "@repo/config": "workspace:*",
+    "@types/node": "^26.1.2",
+    "@vitest/coverage-istanbul": "^4.1.10",
+    "check-export-map": "^1.3.1",
+    "shx": "^0.4.0",
+    "tsdown": "^0.22.14",
+    "typescript-7": "npm:typescript@^7.0.2",
+    "vitest": "^4.1.10"
+  },
+  "author": "Wistia Engineering",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wistia/vhs.git"
+  },
+  "bugs": {
+    "url": "https://github.com/wistia/vhs/issues"
+  },
+  "homepage": "https://github.com/wistia/vhs#readme"
+}