@tempots/std 0.27.0 → 0.28.0

package/color-adjust.d.ts

@@ -0,0 +1,148 @@
+import { Color } from './color';
+/**
+ * Increases the lightness of a color by the given amount.
+ *
+ * Operates in OKLCH space and returns the result in the
+ * same color space as the input.
+ *
+ * @param c - The color to lighten.
+ * @param amount - A value between 0 and 1 indicating how
+ *   much to increase lightness.
+ * @returns The lightened color in the original color space.
+ * @public
+ * @example
+ * ```ts
+ * const light = lighten(rgb8a(100, 50, 50, 1), 0.2)
+ * ```
+ */
+export declare const lighten: (c: Color, amount: number) => Color;
+/**
+ * Decreases the lightness of a color by the given amount.
+ *
+ * Operates in OKLCH space and returns the result in the
+ * same color space as the input.
+ *
+ * @param c - The color to darken.
+ * @param amount - A value between 0 and 1 indicating how
+ *   much to decrease lightness.
+ * @returns The darkened color in the original color space.
+ * @public
+ * @example
+ * ```ts
+ * const dark = darken(rgb8a(200, 150, 150, 1), 0.2)
+ * ```
+ */
+export declare const darken: (c: Color, amount: number) => Color;
+/**
+ * Increases the chroma (saturation) of a color by the
+ * given amount.
+ *
+ * Operates in OKLCH space. The amount is scaled by 0.4 to
+ * map the 0–1 input range to the typical OKLCH chroma
+ * range.
+ *
+ * @param c - The color to saturate.
+ * @param amount - A value between 0 and 1 indicating how
+ *   much to increase chroma.
+ * @returns The saturated color in the original color space.
+ * @public
+ * @example
+ * ```ts
+ * const vivid = saturate(rgb8a(100, 100, 100, 1), 0.5)
+ * ```
+ */
+export declare const saturate: (c: Color, amount: number) => Color;
+/**
+ * Decreases the chroma (saturation) of a color by the
+ * given amount.
+ *
+ * Operates in OKLCH space. The amount is scaled by 0.4 to
+ * map the 0–1 input range to the typical OKLCH chroma
+ * range.
+ *
+ * @param c - The color to desaturate.
+ * @param amount - A value between 0 and 1 indicating how
+ *   much to decrease chroma.
+ * @returns The desaturated color in the original color
+ *   space.
+ * @public
+ * @example
+ * ```ts
+ * const muted = desaturate(rgb8a(255, 0, 0, 1), 0.5)
+ * ```
+ */
+export declare const desaturate: (c: Color, amount: number) => Color;
+/**
+ * Increases the opacity (alpha) of a color by the given
+ * amount.
+ *
+ * No color space conversion is performed — the alpha
+ * channel is adjusted directly.
+ *
+ * @param c - The color to make more opaque.
+ * @param amount - A value between 0 and 1 indicating how
+ *   much to increase alpha.
+ * @returns The color with increased opacity, in the same
+ *   color space.
+ * @public
+ * @example
+ * ```ts
+ * const opaque = opacify(rgb8a(100, 50, 50, 0.5), 0.3)
+ * // alpha is now 0.8
+ * ```
+ */
+export declare const opacify: (c: Color, amount: number) => Color;
+/**
+ * Decreases the opacity (alpha) of a color by the given
+ * amount.
+ *
+ * No color space conversion is performed — the alpha
+ * channel is adjusted directly.
+ *
+ * @param c - The color to make more transparent.
+ * @param amount - A value between 0 and 1 indicating how
+ *   much to decrease alpha.
+ * @returns The color with decreased opacity, in the same
+ *   color space.
+ * @public
+ * @example
+ * ```ts
+ * const faded = transparentize(rgb8a(100, 50, 50, 1), 0.3)
+ * // alpha is now 0.7
+ * ```
+ */
+export declare const transparentize: (c: Color, amount: number) => Color;
+/**
+ * Inverts the RGB channels of a color while preserving
+ * alpha.
+ *
+ * Converts to RGB8 space, inverts each channel
+ * (`255 - value`), and converts back to the original
+ * color space.
+ *
+ * @param c - The color to invert.
+ * @returns The inverted color in the original color space.
+ * @public
+ * @example
+ * ```ts
+ * const inv = invert(rgb8a(255, 0, 0, 1))
+ * // result is cyan: rgb8a(0, 255, 255, 1)
+ * ```
+ */
+export declare const invert: (c: Color) => Color;
+/**
+ * Converts a color to grayscale by removing all chroma.
+ *
+ * Operates in OKLCH space by setting chroma to 0 while
+ * preserving lightness and hue. Returns the result in the
+ * same color space as the input.
+ *
+ * @param c - The color to convert to grayscale.
+ * @returns The grayscale color in the original color space.
+ * @public
+ * @example
+ * ```ts
+ * const gray = grayscale(rgb8a(255, 0, 0, 1))
+ * ```
+ */
+export declare const grayscale: (c: Color) => Color;

package/color-adjust.js

@@ -0,0 +1,47 @@
+import { clamp as e } from "./number.js";
+import { m as s, R as c, a4 as l } from "./color-SZxckS9U.js";
+const i = (a, n) => {
+  const o = a.space, t = s(a, "oklch"), r = c(e(t.l + n, 0, 1), t.c, t.h, t.alpha);
+  return s(r, o);
+}, u = (a, n) => {
+  const o = a.space, t = s(a, "oklch"), r = c(e(t.l - n, 0, 1), t.c, t.h, t.alpha);
+  return s(r, o);
+}, d = (a, n) => {
+  const o = a.space, t = s(a, "oklch"), r = c(
+    t.l,
+    Math.max(0, t.c + n * 0.4),
+    t.h,
+    t.alpha
+  );
+  return s(r, o);
+}, g = (a, n) => {
+  const o = a.space, t = s(a, "oklch"), r = c(
+    t.l,
+    Math.max(0, t.c - n * 0.4),
+    t.h,
+    t.alpha
+  );
+  return s(r, o);
+}, k = (a, n) => ({
+  ...a,
+  alpha: e(a.alpha + n, 0, 1)
+}), m = (a, n) => ({
+  ...a,
+  alpha: e(a.alpha - n, 0, 1)
+}), j = (a) => {
+  const n = a.space, o = s(a, "rgb8"), t = l(255 - o.r, 255 - o.g, 255 - o.b, o.alpha);
+  return s(t, n);
+}, b = (a) => {
+  const n = a.space, o = s(a, "oklch"), t = c(o.l, 0, o.h, o.alpha);
+  return s(t, n);
+};
+export {
+  u as darken,
+  g as desaturate,
+  b as grayscale,
+  j as invert,
+  i as lighten,
+  k as opacify,
+  d as saturate,
+  m as transparentize
+};

package/color-contrast.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./color-D7FAmkht.cjs"),a=t=>t<=.04045?t/12.92:Math.pow((t+.055)/1.055,2.4),l=t=>{const o=e.convertColor(t,"rgb8"),n=a(o.r/255),r=a(o.g/255),s=a(o.b/255);return .2126*n+.7152*r+.0722*s},c=(t,o)=>{const n=l(t),r=l(o),s=Math.max(n,r),g=Math.min(n,r);return(s+.05)/(g+.05)},i=(t,o=e.rgb8a(0,0,0),n=e.rgb8a(255,255,255))=>{const r=c(t,o),s=c(t,n);return r>=s?o:n},b={AA:4.5,AAA:7,"AA-large":3,"AAA-large":4.5},A=(t,o,n)=>c(t,o)>=b[n];exports.contrastColor=i;exports.contrastRatio=c;exports.luminance=l;exports.meetsContrast=A;

package/color-contrast.d.ts

@@ -0,0 +1,96 @@
+import { Color } from './color';
+/**
+ * WCAG contrast level thresholds.
+ *
+ * - `'AA'` — 4.5:1 for normal text
+ * - `'AAA'` — 7:1 for normal text
+ * - `'AA-large'` — 3:1 for large text
+ * - `'AAA-large'` — 4.5:1 for large text
+ *
+ * @public
+ */
+export type ContrastLevel = 'AA' | 'AAA' | 'AA-large' | 'AAA-large';
+/**
+ * Computes the WCAG relative luminance of a color.
+ *
+ * Converts the color to sRGB, linearizes each channel,
+ * and returns the weighted sum per the WCAG 2.x formula.
+ *
+ * @param c - The color to measure
+ * @returns A number between 0 (darkest) and 1 (lightest)
+ *
+ * @example
+ * ```ts
+ * luminance(rgb8a(255, 255, 255)) // 1
+ * luminance(rgb8a(0, 0, 0))       // 0
+ * ```
+ *
+ * @public
+ */
+export declare const luminance: (c: Color) => number;
+/**
+ * Computes the WCAG contrast ratio between two colors.
+ *
+ * The ratio ranges from 1:1 (identical) to 21:1
+ * (black vs white).
+ *
+ * @param a - The first color
+ * @param b - The second color
+ * @returns A number between 1 and 21
+ *
+ * @example
+ * ```ts
+ * contrastRatio(
+ *   rgb8a(0, 0, 0),
+ *   rgb8a(255, 255, 255)
+ * ) // 21
+ * ```
+ *
+ * @public
+ */
+export declare const contrastRatio: (a: Color, b: Color) => number;
+/**
+ * Picks whichever of two candidates has better contrast
+ * against a reference color.
+ *
+ * Useful for choosing a readable foreground color for
+ * a given background.
+ *
+ * @param c - The reference color (e.g. a background)
+ * @param dark - The dark candidate (defaults to black)
+ * @param light - The light candidate (defaults to white)
+ * @returns The candidate with the higher contrast ratio
+ *
+ * @example
+ * ```ts
+ * // Returns white for a dark background
+ * contrastColor(rgb8a(30, 30, 30))
+ *
+ * // Returns black for a light background
+ * contrastColor(rgb8a(220, 220, 220))
+ * ```
+ *
+ * @public
+ */
+export declare const contrastColor: (c: Color, dark?: Color, light?: Color) => Color;
+/**
+ * Checks whether two colors meet a WCAG contrast level.
+ *
+ * @param a - The first color
+ * @param b - The second color
+ * @param level - The WCAG level to test against
+ * @returns `true` if the contrast ratio meets or exceeds
+ *   the threshold for the given level
+ *
+ * @example
+ * ```ts
+ * meetsContrast(
+ *   rgb8a(0, 0, 0),
+ *   rgb8a(255, 255, 255),
+ *   'AAA'
+ * ) // true
+ * ```
+ *
+ * @public
+ */
+export declare const meetsContrast: (a: Color, b: Color, level: ContrastLevel) => boolean;

package/color-contrast.js

@@ -0,0 +1,22 @@
+import { a4 as e, m as g } from "./color-SZxckS9U.js";
+const a = (t) => t <= 0.04045 ? t / 12.92 : Math.pow((t + 0.055) / 1.055, 2.4), l = (t) => {
+  const o = g(t, "rgb8"), n = a(o.r / 255), r = a(o.g / 255), s = a(o.b / 255);
+  return 0.2126 * n + 0.7152 * r + 0.0722 * s;
+}, c = (t, o) => {
+  const n = l(t), r = l(o), s = Math.max(n, r), A = Math.min(n, r);
+  return (s + 0.05) / (A + 0.05);
+}, m = (t, o = e(0, 0, 0), n = e(255, 255, 255)) => {
+  const r = c(t, o), s = c(t, n);
+  return r >= s ? o : n;
+}, b = {
+  AA: 4.5,
+  AAA: 7,
+  "AA-large": 3,
+  "AAA-large": 4.5
+}, h = (t, o, n) => c(t, o) >= b[n];
+export {
+  m as contrastColor,
+  c as contrastRatio,
+  l as luminance,
+  h as meetsContrast
+};

package/color-distance.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("./color-D7FAmkht.cjs"),r=l=>l*Math.PI/180,F=(l,q)=>{const n=d.convertColor(l,"lab"),c=d.convertColor(q,"lab"),h=n.l-c.l,e=n.a-c.a,a=n.b-c.b;return Math.sqrt(h*h+e*e+a*a)},J=(l,q)=>{const n=d.convertColor(l,"lab"),c=d.convertColor(q,"lab"),h=n.l,e=n.a,a=n.b,v=c.l,m=c.a,M=c.b,T=Math.sqrt(e*e+a*a),H=Math.sqrt(m*m+M*M),I=(T+H)/2,g=Math.pow(I,7),w=.5*(1-Math.sqrt(g/(g+Math.pow(25,7)))),f=e*(1+w),L=m*(1+w),i=Math.sqrt(f*f+a*a),p=Math.sqrt(L*L+M*M);let t=Math.atan2(a,f)*180/Math.PI;t<0&&(t+=360);let o=Math.atan2(M,L)*180/Math.PI;o<0&&(o+=360);const R=v-h,y=p-i;let b;i*p===0?b=0:Math.abs(o-t)<=180?b=o-t:o-t>180?b=o-t-360:b=o-t+360;const j=2*Math.sqrt(i*p)*Math.sin(r(b/2)),x=(h+v)/2,_=(i+p)/2;let s;i*p===0?s=t+o:Math.abs(t-o)<=180?s=(t+o)/2:t+o<360?s=(t+o+360)/2:s=(t+o-360)/2;const G=1-.17*Math.cos(r(s-30))+.24*Math.cos(r(2*s))+.32*Math.cos(r(3*s+6))-.2*Math.cos(r(4*s-63)),C=x-50,O=1+.015*C*C/Math.sqrt(20+C*C),k=1+.045*_,z=1+.015*_*G,A=30*Math.exp(-((s-275)/25*((s-275)/25))),D=Math.pow(_,7),B=2*Math.sqrt(D/(D+Math.pow(25,7))),E=-Math.sin(r(2*A))*B,P=R/O,S=y/k,u=j/z;return Math.sqrt(P*P+S*S+u*u+E*S*u)};exports.colorDistance=J;exports.colorDistanceSimple=F;

package/color-distance.d.ts

@@ -0,0 +1,41 @@
+import { Color } from './color';
+/**
+ * Computes the CIE76 color distance (Euclidean distance in
+ * CIELAB space) between two colors.
+ *
+ * @param a - The first color.
+ * @param b - The second color.
+ * @returns The Euclidean distance in LAB space.
+ * @public
+ * @example
+ * ```ts
+ * import { rgb8a } from './color'
+ * colorDistanceSimple(
+ *   rgb8a(255, 0, 0),
+ *   rgb8a(0, 255, 0)
+ * ) // ~170.56
+ * ```
+ */
+export declare const colorDistanceSimple: (a: Color, b: Color) => number;
+/**
+ * Computes the CIEDE2000 color distance between two colors.
+ *
+ * This is the most perceptually uniform color difference metric
+ * standardized by the CIE. It accounts for lightness, chroma,
+ * and hue weighting as well as interactive effects between
+ * chroma and hue differences.
+ *
+ * @param a - The first color.
+ * @param b - The second color.
+ * @returns The CIEDE2000 deltaE value.
+ * @public
+ * @example
+ * ```ts
+ * import { rgb8a } from './color'
+ * colorDistance(
+ *   rgb8a(255, 0, 0),
+ *   rgb8a(0, 255, 0)
+ * ) // ~86.61
+ * ```
+ */
+export declare const colorDistance: (a: Color, b: Color) => number;

package/color-distance.js

@@ -0,0 +1,25 @@
+import { m } from "./color-SZxckS9U.js";
+const h = (M) => M * Math.PI / 180, K = (M, d) => {
+  const n = m(M, "lab"), c = m(d, "lab"), l = n.l - c.l, e = n.a - c.a, o = n.b - c.b;
+  return Math.sqrt(l * l + e * e + o * o);
+}, N = (M, d) => {
+  const n = m(M, "lab"), c = m(d, "lab"), l = n.l, e = n.a, o = n.b, H = c.l, q = c.a, r = c.b, x = Math.sqrt(e * e + o * o), D = Math.sqrt(q * q + r * r), R = (x + D) / 2, I = Math.pow(R, 7), P = 0.5 * (1 - Math.sqrt(I / (I + Math.pow(25, 7)))), f = e * (1 + P), L = q * (1 + P), p = Math.sqrt(f * f + o * o), b = Math.sqrt(L * L + r * r);
+  let t = Math.atan2(o, f) * 180 / Math.PI;
+  t < 0 && (t += 360);
+  let s = Math.atan2(r, L) * 180 / Math.PI;
+  s < 0 && (s += 360);
+  const g = H - l, v = b - p;
+  let i;
+  p * b === 0 ? i = 0 : Math.abs(s - t) <= 180 ? i = s - t : s - t > 180 ? i = s - t - 360 : i = s - t + 360;
+  const G = 2 * Math.sqrt(p * b) * Math.sin(h(i / 2)), j = (l + H) / 2, _ = (p + b) / 2;
+  let a;
+  p * b === 0 ? a = t + s : Math.abs(t - s) <= 180 ? a = (t + s) / 2 : t + s < 360 ? a = (t + s + 360) / 2 : a = (t + s - 360) / 2;
+  const k = 1 - 0.17 * Math.cos(h(a - 30)) + 0.24 * Math.cos(h(2 * a)) + 0.32 * Math.cos(h(3 * a + 6)) - 0.2 * Math.cos(h(4 * a - 63)), C = j - 50, y = 1 + 0.015 * C * C / Math.sqrt(20 + C * C), z = 1 + 0.045 * _, A = 1 + 0.015 * _ * k, B = 30 * Math.exp(-((a - 275) / 25 * ((a - 275) / 25))), T = Math.pow(_, 7), E = 2 * Math.sqrt(T / (T + Math.pow(25, 7))), F = -Math.sin(h(2 * B)) * E, u = g / y, w = v / z, S = G / A;
+  return Math.sqrt(
+    u * u + w * w + S * S + F * w * S
+  );
+};
+export {
+  N as colorDistance,
+  K as colorDistanceSimple
+};

package/color-harmony.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("./number.cjs"),n=require("./color-D7FAmkht.cjs"),t=(o,e)=>{const a=o.space,r=n.convertColor(o,"oklch"),l=n.oklcha(r.l,r.c,s.wrapCircular(r.h+e,360),r.alpha);return n.convertColor(l,a)},c=o=>t(o,180),i=(o,e=30)=>[o,t(o,e),t(o,-e)],u=o=>[o,t(o,120),t(o,240)],m=o=>[o,t(o,150),t(o,210)],p=o=>[o,t(o,90),t(o,180),t(o,270)];exports.analogous=i;exports.complement=c;exports.splitComplementary=m;exports.tetradic=p;exports.triadic=u;

package/color-harmony.d.ts

@@ -0,0 +1,81 @@
+import { Color } from './color';
+/**
+ * Returns the complementary color by rotating the hue
+ * 180 degrees in OKLCH space.
+ *
+ * @param c - Any color value
+ * @returns The complementary color in the same color
+ *   space as the input
+ * @example
+ * ```ts
+ * const red = rgba(1, 0, 0, 1)
+ * const cyan = complement(red)
+ * ```
+ * @public
+ */
+export declare const complement: (c: Color) => Color;
+/**
+ * Returns an analogous color scheme consisting of the
+ * original color and two neighbors at the given angle
+ * offset.
+ *
+ * @param c - Any color value
+ * @param angle - The hue offset in degrees (default 30)
+ * @returns A triple of [original, +angle, -angle] in
+ *   the same color space as the input
+ * @example
+ * ```ts
+ * const red = rgba(1, 0, 0, 1)
+ * const [base, warm, cool] = analogous(red)
+ * ```
+ * @public
+ */
+export declare const analogous: (c: Color, angle?: number) => [Color, Color, Color];
+/**
+ * Returns a triadic color scheme consisting of the
+ * original color and two colors evenly spaced at 120
+ * degree intervals.
+ *
+ * @param c - Any color value
+ * @returns A triple of [original, +120, +240] in the
+ *   same color space as the input
+ * @example
+ * ```ts
+ * const red = rgba(1, 0, 0, 1)
+ * const [a, b, c] = triadic(red)
+ * ```
+ * @public
+ */
+export declare const triadic: (c: Color) => [Color, Color, Color];
+/**
+ * Returns a split-complementary color scheme consisting
+ * of the original color and two colors adjacent to its
+ * complement at 150 and 210 degree offsets.
+ *
+ * @param c - Any color value
+ * @returns A triple of [original, +150, +210] in the
+ *   same color space as the input
+ * @example
+ * ```ts
+ * const red = rgba(1, 0, 0, 1)
+ * const [base, left, right] = splitComplementary(red)
+ * ```
+ * @public
+ */
+export declare const splitComplementary: (c: Color) => [Color, Color, Color];
+/**
+ * Returns a tetradic (rectangular) color scheme
+ * consisting of the original color and three colors
+ * evenly spaced at 90 degree intervals.
+ *
+ * @param c - Any color value
+ * @returns A quadruple of [original, +90, +180, +270]
+ *   in the same color space as the input
+ * @example
+ * ```ts
+ * const red = rgba(1, 0, 0, 1)
+ * const [a, b, c, d] = tetradic(red)
+ * ```
+ * @public
+ */
+export declare const tetradic: (c: Color) => [Color, Color, Color, Color];

package/color-harmony.js

@@ -0,0 +1,35 @@
+import { wrapCircular as l } from "./number.js";
+import { m as n, R as i } from "./color-SZxckS9U.js";
+const t = (o, r) => {
+  const s = o.space, a = n(o, "oklch"), e = i(
+    a.l,
+    a.c,
+    l(a.h + r, 360),
+    a.alpha
+  );
+  return n(e, s);
+}, c = (o) => t(o, 180), h = (o, r = 30) => [
+  o,
+  t(o, r),
+  t(o, -r)
+], u = (o) => [
+  o,
+  t(o, 120),
+  t(o, 240)
+], d = (o) => [
+  o,
+  t(o, 150),
+  t(o, 210)
+], k = (o) => [
+  o,
+  t(o, 90),
+  t(o, 180),
+  t(o, 270)
+];
+export {
+  h as analogous,
+  c as complement,
+  d as splitComplementary,
+  k as tetradic,
+  u as triadic
+};

package/color-hsl.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("./error.cjs");require("./number.cjs");const r=require("./color-D7FAmkht.cjs");exports.canParseHsl=r.canParseHsl;exports.hslaToHslString=r.hslaToHslString;exports.hslaToRgb8a=r.hslaToRgb8a;exports.parseHsl=r.parseHsl;exports.rgb8aToHsla=r.rgb8aToHsla;

package/color-hsl.d.ts

@@ -0,0 +1,81 @@
+import { RGB8A, HSLA } from './color';
+/**
+ * Returns `true` if the string can be parsed as an `hsl()` or `hsla()` color.
+ *
+ * Supports both legacy comma-separated and modern space-separated syntax.
+ *
+ * @param s - The string to test.
+ * @returns `true` if the string is a valid HSL functional notation.
+ * @public
+ * @example
+ * ```ts
+ * canParseHsl('hsl(0, 100%, 50%)') // true
+ * canParseHsl('hsl(120 50% 50% / 0.5)') // true
+ * canParseHsl('#ff0000') // false
+ * ```
+ */
+export declare const canParseHsl: (s: string) => boolean;
+/**
+ * Parses an `hsl()` or `hsla()` color string into an HSLA color.
+ *
+ * Supports both legacy comma-separated and modern space-separated syntax.
+ *
+ * @param s - The string to parse.
+ * @returns An HSLA color.
+ * @throws ParsingError if the string is not a valid HSL color.
+ * @public
+ * @example
+ * ```ts
+ * parseHsl('hsl(0, 100%, 50%)') // hsla(0, 100, 50)
+ * parseHsl('hsla(120, 50%, 75%, 0.8)') // hsla(120, 50, 75, 0.8)
+ * parseHsl('hsl(240 100% 50% / 50%)') // hsla(240, 100, 50, 0.5)
+ * ```
+ */
+export declare const parseHsl: (s: string) => HSLA;
+/**
+ * Converts an RGB8A color to an HSLA color using the standard min/max/delta
+ * algorithm.
+ *
+ * @param c - The RGB8A color to convert.
+ * @returns The equivalent HSLA color.
+ * @public
+ * @example
+ * ```ts
+ * rgb8aToHsla(rgb8a(255, 0, 0)) // hsla(0, 100, 50)
+ * rgb8aToHsla(rgb8a(0, 128, 0)) // hsla(120, 100, ~25.1)
+ * rgb8aToHsla(rgb8a(0, 0, 0)) // hsla(0, 0, 0)
+ * ```
+ */
+export declare const rgb8aToHsla: (c: RGB8A) => HSLA;
+/**
+ * Converts an HSLA color to an RGB8A color using sector-based hue-to-RGB
+ * conversion.
+ *
+ * @param c - The HSLA color to convert.
+ * @returns The equivalent RGB8A color.
+ * @public
+ * @example
+ * ```ts
+ * hslaToRgb8a(hsla(0, 100, 50)) // rgb8a(255, 0, 0)
+ * hslaToRgb8a(hsla(120, 100, 50)) // rgb8a(0, 255, 0)
+ * hslaToRgb8a(hsla(240, 100, 50)) // rgb8a(0, 0, 255)
+ * ```
+ */
+export declare const hslaToRgb8a: (c: HSLA) => RGB8A;
+/**
+ * Serializes an HSLA color to an `hsl()` or `hsla()` CSS string.
+ *
+ * Produces `hsl(h, s%, l%)` when alpha is 1, or `hsla(h, s%, l%, alpha)`
+ * otherwise. Hue, saturation, and lightness are rounded to two decimal
+ * places for readability.
+ *
+ * @param c - The HSLA color to serialize.
+ * @returns A CSS color string.
+ * @public
+ * @example
+ * ```ts
+ * hslaToHslString(hsla(0, 100, 50)) // 'hsl(0, 100%, 50%)'
+ * hslaToHslString(hsla(120, 50, 75, 0.5)) // 'hsla(120, 50%, 75%, 0.5)'
+ * ```
+ */
+export declare const hslaToHslString: (c: HSLA) => string;

package/color-hsl.js

@@ -0,0 +1,10 @@
+import "./error.js";
+import "./number.js";
+import { b as l, p, r as t, X as H, a6 as b } from "./color-SZxckS9U.js";
+export {
+  l as canParseHsl,
+  p as hslaToHslString,
+  t as hslaToRgb8a,
+  H as parseHsl,
+  b as rgb8aToHsla
+};

package/color-hsv.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("./error.cjs");require("./number.cjs");const s=require("./color-D7FAmkht.cjs");exports.canParseHsv=s.canParseHsv;exports.hslaToHsva=s.hslaToHsva;exports.hsvaToHsla=s.hsvaToHsla;exports.hsvaToHsvString=s.hsvaToHsvString;exports.hsvaToRgb8a=s.hsvaToRgb8a;exports.parseHsv=s.parseHsv;exports.rgb8aToHsva=s.rgb8aToHsva;