colorizr 5.1.0 → 5.1.1

package/dist/index.d.mts

@@ -9,7 +9,6 @@ type ColorTypeInput = ColorType | 'named';
 type ColorValue = ColorModel | HEX;
 type ConverterParameters<TModel extends ColorModel> = TModel | ColorTuple;
 type HEX = `#${string}`;
-type PlainObject<T = any> = Record<string, T>;
 interface Analysis {
     brightnessDifference: number;
     colorDifference: number;
@@ -524,7 +523,7 @@ declare function desaturate(input: string, amount: number, format?: ColorType):
 type ExtractColorPartsReturn = {
     alpha?: number;
     model: ColorModelKey;
-} & PlainObject<number>;
+} & Record<string, number>;
 /**
  * Extract the color parts from a CSS color string.
  * Hex colors are supported via conversion.
@@ -919,7 +918,7 @@ declare function rotate(input: string, degrees: number, format?: ColorType): str
  */
 declare function saturate(input: string, amount: number, format?: ColorType): string;
 
-type ScaleMode = 'light' | 'dark';
+type ScaleMode = 'light' | 'dark' | 'reversed';
 type ScaleVariant = 'deep' | 'neutral' | 'pastel' | 'subtle' | 'vibrant';
 /**
  * Parabolic chroma curve with a movable center.
@@ -1044,7 +1043,14 @@ interface ScaleOptions {
      * Theme-aware lightness direction.
      *
      * - 'light': Low keys (50) are lightest, high keys (950) are darkest
-     * - 'dark': Low keys (50) are darkest, high keys (950) are lightest
+     * - 'dark': Low keys (50) are darkest, high keys (950) are lightest, re-derived
+     *   with the lightness ramp running in the dark direction
+     * - 'reversed': the 'light' palette with its keys reversed — identical colors in
+     *   mirrored order (50↔950, 100↔900, …)
+     *
+     * `dark` re-derives the scale, so its intermediate steps are not a reversal of
+     * `light` (they coincide only when `lightnessCurve` is linear). `reversed`
+     * re-labels the `light` palette, so it mirrors exactly at any curve.
      *
      * @default 'light'
      */
@@ -1142,4 +1148,4 @@ declare function toGamut(input: string, format?: ColorType): string;
  */
 declare function transparentize(input: string, alpha: number, format?: ColorType): string;
 
-export { APCA_VERSION, type Analysis, CLMS_TO_OKLAB, type ColorKeysTuple, type ColorModel, type ColorModelKey, type ColorModelKeys, type ColorReturn, type ColorTuple, type ColorType, type ColorTypeInput, type ColorValue, type ColorizrOptions, type ConverterParameters, DEG2RAD, DELTA_E_JND, type FormatCSSOptions, GAMUT_EPSILON, type HEX, type HSL, type HueMode, type LAB, type LCH, LMS_TO_LRGB, LRGB_TO_LMS, type MixOptions, OKLAB_TO_CLMS, P3_TO_SRGB, P3_TO_XYZ, PRECISION, type PaletteOptions, type PlainObject, RAD2DEG, type RGB, type ReadableColorMethod, type ReadableColorOptions, SRGB_TO_P3, type ScaleChromaPeak, type ScaleOptions, type ScaleRange, type ScaleVariant, type Scheme, type SchemeOptions, XYZ_TO_SRGB, addAlphaToHex, apcaContrast, brightnessDifference, chroma, colorDifference, compare, contrast, convertAlphaToHex, convertCSS, darken, Colorizr as default, deltaE, desaturate, extractAlphaFromHex, extractColorParts, formatCSS, formatHex, getColorType, getP3MaxChroma, getP3MaxColor, getScaleStepKeys, grayscale, hex2hsl, hex2oklab, hex2oklch, hex2rgb, hsl2hex, hsl2oklab, hsl2oklch, hsl2rgb, invert, isHSL, isHex, isInGamut, isLAB, isLCH, isRGB, isValidColor, lighten, luminance, mix, name, oklab2hex, oklab2hsl, oklab2oklch, oklab2rgb, oklabToLinearP3, oklabToLinearSRGB, oklch2hex, oklch2hsl, oklch2oklab, oklch2rgb, opacify, opacity, palette, parseCSS, random, readableColor, removeAlphaFromHex, rgb2hex, rgb2hsl, rgb2oklab, rgb2oklch, rotate, saturate, scale, scheme, srgbGammaDecode, srgbGammaEncode, toGamut, transparentize };
+export { APCA_VERSION, type Analysis, CLMS_TO_OKLAB, type ColorKeysTuple, type ColorModel, type ColorModelKey, type ColorModelKeys, type ColorReturn, type ColorTuple, type ColorType, type ColorTypeInput, type ColorValue, type ColorizrOptions, type ConverterParameters, DEG2RAD, DELTA_E_JND, type FormatCSSOptions, GAMUT_EPSILON, type HEX, type HSL, type HueMode, type LAB, type LCH, LMS_TO_LRGB, LRGB_TO_LMS, type MixOptions, OKLAB_TO_CLMS, P3_TO_SRGB, P3_TO_XYZ, PRECISION, type PaletteOptions, RAD2DEG, type RGB, type RandomOptions, type ReadableColorMethod, type ReadableColorOptions, SRGB_TO_P3, type ScaleChromaPeak, type ScaleMode, type ScaleOptions, type ScaleRange, type ScaleVariant, type Scheme, type SchemeOptions, XYZ_TO_SRGB, addAlphaToHex, apcaContrast, brightnessDifference, chroma, colorDifference, compare, contrast, convertAlphaToHex, convertCSS, darken, Colorizr as default, deltaE, desaturate, extractAlphaFromHex, extractColorParts, formatCSS, formatHex, getColorType, getP3MaxChroma, getP3MaxColor, getScaleStepKeys, grayscale, hex2hsl, hex2oklab, hex2oklch, hex2rgb, hsl2hex, hsl2oklab, hsl2oklch, hsl2rgb, invert, isHSL, isHex, isInGamut, isLAB, isLCH, isRGB, isValidColor, lighten, luminance, mix, name, oklab2hex, oklab2hsl, oklab2oklch, oklab2rgb, oklabToLinearP3, oklabToLinearSRGB, oklch2hex, oklch2hsl, oklch2oklab, oklch2rgb, opacify, opacity, palette, parseCSS, random, readableColor, removeAlphaFromHex, rgb2hex, rgb2hsl, rgb2oklab, rgb2oklch, rotate, saturate, scale, scheme, srgbGammaDecode, srgbGammaEncode, toGamut, transparentize };

package/dist/index.d.ts

@@ -9,7 +9,6 @@ type ColorTypeInput = ColorType | 'named';
 type ColorValue = ColorModel | HEX;
 type ConverterParameters<TModel extends ColorModel> = TModel | ColorTuple;
 type HEX = `#${string}`;
-type PlainObject<T = any> = Record<string, T>;
 interface Analysis {
     brightnessDifference: number;
     colorDifference: number;
@@ -524,7 +523,7 @@ declare function desaturate(input: string, amount: number, format?: ColorType):
 type ExtractColorPartsReturn = {
     alpha?: number;
     model: ColorModelKey;
-} & PlainObject<number>;
+} & Record<string, number>;
 /**
  * Extract the color parts from a CSS color string.
  * Hex colors are supported via conversion.
@@ -919,7 +918,7 @@ declare function rotate(input: string, degrees: number, format?: ColorType): str
  */
 declare function saturate(input: string, amount: number, format?: ColorType): string;
 
-type ScaleMode = 'light' | 'dark';
+type ScaleMode = 'light' | 'dark' | 'reversed';
 type ScaleVariant = 'deep' | 'neutral' | 'pastel' | 'subtle' | 'vibrant';
 /**
  * Parabolic chroma curve with a movable center.
@@ -1044,7 +1043,14 @@ interface ScaleOptions {
      * Theme-aware lightness direction.
      *
      * - 'light': Low keys (50) are lightest, high keys (950) are darkest
-     * - 'dark': Low keys (50) are darkest, high keys (950) are lightest
+     * - 'dark': Low keys (50) are darkest, high keys (950) are lightest, re-derived
+     *   with the lightness ramp running in the dark direction
+     * - 'reversed': the 'light' palette with its keys reversed — identical colors in
+     *   mirrored order (50↔950, 100↔900, …)
+     *
+     * `dark` re-derives the scale, so its intermediate steps are not a reversal of
+     * `light` (they coincide only when `lightnessCurve` is linear). `reversed`
+     * re-labels the `light` palette, so it mirrors exactly at any curve.
      *
      * @default 'light'
      */
@@ -1142,4 +1148,4 @@ declare function toGamut(input: string, format?: ColorType): string;
  */
 declare function transparentize(input: string, alpha: number, format?: ColorType): string;
 
-export { APCA_VERSION, type Analysis, CLMS_TO_OKLAB, type ColorKeysTuple, type ColorModel, type ColorModelKey, type ColorModelKeys, type ColorReturn, type ColorTuple, type ColorType, type ColorTypeInput, type ColorValue, type ColorizrOptions, type ConverterParameters, DEG2RAD, DELTA_E_JND, type FormatCSSOptions, GAMUT_EPSILON, type HEX, type HSL, type HueMode, type LAB, type LCH, LMS_TO_LRGB, LRGB_TO_LMS, type MixOptions, OKLAB_TO_CLMS, P3_TO_SRGB, P3_TO_XYZ, PRECISION, type PaletteOptions, type PlainObject, RAD2DEG, type RGB, type ReadableColorMethod, type ReadableColorOptions, SRGB_TO_P3, type ScaleChromaPeak, type ScaleOptions, type ScaleRange, type ScaleVariant, type Scheme, type SchemeOptions, XYZ_TO_SRGB, addAlphaToHex, apcaContrast, brightnessDifference, chroma, colorDifference, compare, contrast, convertAlphaToHex, convertCSS, darken, Colorizr as default, deltaE, desaturate, extractAlphaFromHex, extractColorParts, formatCSS, formatHex, getColorType, getP3MaxChroma, getP3MaxColor, getScaleStepKeys, grayscale, hex2hsl, hex2oklab, hex2oklch, hex2rgb, hsl2hex, hsl2oklab, hsl2oklch, hsl2rgb, invert, isHSL, isHex, isInGamut, isLAB, isLCH, isRGB, isValidColor, lighten, luminance, mix, name, oklab2hex, oklab2hsl, oklab2oklch, oklab2rgb, oklabToLinearP3, oklabToLinearSRGB, oklch2hex, oklch2hsl, oklch2oklab, oklch2rgb, opacify, opacity, palette, parseCSS, random, readableColor, removeAlphaFromHex, rgb2hex, rgb2hsl, rgb2oklab, rgb2oklch, rotate, saturate, scale, scheme, srgbGammaDecode, srgbGammaEncode, toGamut, transparentize };
+export { APCA_VERSION, type Analysis, CLMS_TO_OKLAB, type ColorKeysTuple, type ColorModel, type ColorModelKey, type ColorModelKeys, type ColorReturn, type ColorTuple, type ColorType, type ColorTypeInput, type ColorValue, type ColorizrOptions, type ConverterParameters, DEG2RAD, DELTA_E_JND, type FormatCSSOptions, GAMUT_EPSILON, type HEX, type HSL, type HueMode, type LAB, type LCH, LMS_TO_LRGB, LRGB_TO_LMS, type MixOptions, OKLAB_TO_CLMS, P3_TO_SRGB, P3_TO_XYZ, PRECISION, type PaletteOptions, RAD2DEG, type RGB, type RandomOptions, type ReadableColorMethod, type ReadableColorOptions, SRGB_TO_P3, type ScaleChromaPeak, type ScaleMode, type ScaleOptions, type ScaleRange, type ScaleVariant, type Scheme, type SchemeOptions, XYZ_TO_SRGB, addAlphaToHex, apcaContrast, brightnessDifference, chroma, colorDifference, compare, contrast, convertAlphaToHex, convertCSS, darken, Colorizr as default, deltaE, desaturate, extractAlphaFromHex, extractColorParts, formatCSS, formatHex, getColorType, getP3MaxChroma, getP3MaxColor, getScaleStepKeys, grayscale, hex2hsl, hex2oklab, hex2oklch, hex2rgb, hsl2hex, hsl2oklab, hsl2oklch, hsl2rgb, invert, isHSL, isHex, isInGamut, isLAB, isLCH, isRGB, isValidColor, lighten, luminance, mix, name, oklab2hex, oklab2hsl, oklab2oklch, oklab2rgb, oklabToLinearP3, oklabToLinearSRGB, oklch2hex, oklch2hsl, oklch2oklab, oklch2rgb, opacify, opacity, palette, parseCSS, random, readableColor, removeAlphaFromHex, rgb2hex, rgb2hsl, rgb2oklab, rgb2oklch, rotate, saturate, scale, scheme, srgbGammaDecode, srgbGammaEncode, toGamut, transparentize };

package/dist/index.js

@@ -2397,10 +2397,11 @@ function scale(input, options = {}) {
     lock,
     maxLightness,
     minLightness,
-    mode
+    mode: mode === "reversed" ? "light" : mode
   });
+  const ordered = mode === "reversed" ? Object.fromEntries(keys.map((key, index) => [key, palette2[keys[keys.length - 1 - index]]])) : palette2;
   return Object.fromEntries(
-    Object.entries(palette2).map(([key, value]) => [key, formatCSS(value, { format: colorFormat })])
+    Object.entries(ordered).map(([key, value]) => [key, formatCSS(value, { format: colorFormat })])
   );
 }