@tenphi/glaze 0.14.0 → 0.15.1

package/dist/index.d.cts

@@ -41,13 +41,8 @@ interface FindToneForContrastOptions {
   initialDirection?: 'lighter' | 'darker';
   /** Auto-flip tone direction when contrast can't be met. Default: false. */
   flip?: boolean;
-  /**
-   * Saturation taper strength (0–1). When set, candidate saturation is rolled
-   * off toward the tone extremes via the same envelope the renderer applies,
-   * so the solved tone meets the floor with its *rendered* saturation. Default
-   * `0` (no taper) for direct/advanced callers.
-   */
-  saturationTaper?: number;
+  /** Use the hue-independent "safe" chroma boundary. Default: false. */
+  pastel?: boolean;
 }
 interface FindToneForContrastResult {
   /** Chosen tone in 0–1. */
@@ -222,6 +217,13 @@ interface RegularColorDef {
    * should not be combined (a console.warn is emitted).
    */
   opacity?: number;
+  /**
+   * Per-color override for the hue-independent "safe" chroma limit used in
+   * OKHSL↔sRGB conversions (luminance, contrast solving, output formatting).
+   * Falls through to the global / per-theme `pastel` config when omitted.
+   * @see GlazeConfig.pastel
+   */
+  pastel?: boolean;
   /**
    * Whether this color is inherited by child themes created via `extend()`.
    * Default: true. Set to false to make this color local to the current theme.
@@ -271,6 +273,13 @@ interface ShadowColorDef {
   intensity: HCPair<number>;
   /** Override default tuning. Merged field-by-field with global `shadowTuning`. */
   tuning?: ShadowTuning;
+  /**
+   * Per-color override for the hue-independent "safe" chroma limit used in
+   * OKHSL↔sRGB conversions (luminance, contrast solving, output formatting).
+   * Falls through to the global / per-theme `pastel` config when omitted.
+   * @see GlazeConfig.pastel
+   */
+  pastel?: boolean;
   /**
    * Whether this color is inherited by child themes created via `extend()`.
    * Default: true. Set to false to make this color local to the current theme.
@@ -311,6 +320,13 @@ interface MixColorDef {
    * metric. Supports [normal, highContrast] pair.
    */
   contrast?: HCPair<ContrastSpec>;
+  /**
+   * Per-color override for the hue-independent "safe" chroma limit used in
+   * OKHSL↔sRGB conversions (luminance, contrast solving, output formatting).
+   * Falls through to the global / per-theme `pastel` config when omitted.
+   * @see GlazeConfig.pastel
+   */
+  pastel?: boolean;
   /**
    * Whether this color is inherited by child themes created via `extend()`.
    * Default: true. Set to false to make this color local to the current theme.
@@ -335,6 +351,12 @@ interface ResolvedColorVariant {
   t: number;
   /** Opacity (0–1). Default: 1. */
   alpha: number;
+  /**
+   * Effective `pastel` flag used while resolving this variant (author def or
+   * config fallback). Carried on the variant so output formatting matches the
+   * gamut mapping applied during resolution.
+   */
+  pastel?: boolean;
 }
 /** Fully resolved color across all scheme variants. */
 interface ResolvedColor {
@@ -367,12 +389,6 @@ interface GlazeConfig {
   darkTone?: ToneWindow;
   /** Saturation reduction factor for dark scheme (0–1). Default: 0.1. */
   darkDesaturation?: number;
-  /**
-   * Saturation taper toward the tone extremes (0–1). The fraction of the
-   * tone range over which saturation rolls off at each end, where in-gamut
-   * chroma collapses. Default: 0.15. Set to 0 to disable.
-   */
-  saturationTaper?: number;
   /** State alias names for token export. */
   states?: {
     dark?: string;
@@ -397,12 +413,18 @@ interface GlazeConfig {
    * falls back to the originally requested tone).
    */
   autoFlip?: boolean;
+  /**
+   * If true, uses a hue-independent "safe" chroma limit across all colors
+   * so that scaling saturation never exceeds the sRGB boundary at any hue
+   * for the given lightness.
+   * @default false
+   */
+  pastel?: boolean;
 }
 interface GlazeConfigResolved {
   lightTone: ToneWindow;
   darkTone: ToneWindow;
   darkDesaturation: number;
-  saturationTaper: number;
   states: {
     dark: string;
     highContrast: string;
@@ -410,6 +432,7 @@ interface GlazeConfigResolved {
   modes: Required<GlazeOutputModes>;
   shadowTuning?: ShadowTuning;
   autoFlip: boolean;
+  pastel: boolean;
 }
 /**
  * Per-instance config override for `glaze.color()` and `glaze()` themes.
@@ -425,10 +448,14 @@ interface GlazeConfigOverride {
   darkTone?: ToneWindow;
   /** Saturation reduction factor for dark scheme (0–1). */
   darkDesaturation?: number;
-  /** Saturation taper toward the tone extremes (0–1). */
-  saturationTaper?: number;
   /** Whether to auto-flip tone when contrast can't be met. */
   autoFlip?: boolean;
+  /**
+   * If true, uses a hue-independent "safe" chroma limit across all colors
+   * so that scaling saturation never exceeds the sRGB boundary at any hue
+   * for the given lightness.
+   */
+  pastel?: boolean;
   /**
    * Shadow tuning defaults. Only meaningful for themes; harmless on
    * standalone color tokens.
@@ -493,6 +520,13 @@ interface GlazeColorInput {
    * used). Does not affect output keys.
    */
   name?: string;
+  /**
+   * Per-color override for the hue-independent "safe" chroma limit used in
+   * OKHSL↔sRGB conversions (luminance, contrast solving, output formatting).
+   * Falls through to the global / per-theme `pastel` config when omitted.
+   * @see GlazeConfig.pastel
+   */
+  pastel?: boolean;
 }
 /**
  * Any single-color input form accepted by the value-shorthand
@@ -593,6 +627,13 @@ interface GlazeColorOverrides {
    * used). Does not affect output keys.
    */
   name?: string;
+  /**
+   * Per-color override for the hue-independent "safe" chroma limit used in
+   * OKHSL↔sRGB conversions (luminance, contrast solving, output formatting).
+   * Falls through to the global / per-theme `pastel` config when omitted.
+   * @see GlazeConfig.pastel
+   */
+  pastel?: boolean;
 }
 /**
  * Object input for `glaze.color()` that carries a raw color value plus
@@ -689,6 +730,7 @@ interface GlazeColorInputExport {
   base?: GlazeColorTokenExport | GlazeColorValue;
   contrast?: HCPair<ContrastSpec>;
   name?: string;
+  pastel?: boolean;
 }
 /**
  * Serializable shape of `GlazeColorOverrides`. `base` is replaced by
@@ -705,12 +747,15 @@ interface GlazeColorOverridesExport {
   base?: GlazeColorTokenExport | GlazeColorValue;
   opacity?: number;
   name?: string;
+  pastel?: boolean;
 }
 interface GlazeTheme {
   /** The hue seed (0–360). */
   readonly hue: number;
   /** The saturation seed (0–100). */
   readonly saturation: number;
+  /** The effective config for this theme. */
+  getConfig(): GlazeConfigResolved;
   /** Add/replace colors (additive merge with existing definitions). */
   colors(defs: ColorMap): void;
   /** Get a color definition by name. */
@@ -857,7 +902,7 @@ type PaletteInput = Record<string, GlazeTheme>;
  * Create a single-hue glaze theme.
  *
  * An optional `config` override can be supplied to customize the resolve
- * behavior for this theme (tone windows, saturation taper, etc.). The
+ * behavior for this theme (tone windows, etc.). The
  * override is **merged over the live global config at resolve time** —
  * the theme still reacts to later `configure()` calls for fields it
  * didn't override.
@@ -881,7 +926,7 @@ declare namespace glaze {
   var from: (data: GlazeThemeExport) => GlazeTheme;
   var color: (input: GlazeFromInput | GlazeColorInput | GlazeColorValue, config?: GlazeConfigOverride) => GlazeColorToken;
   var shadow: (input: GlazeShadowInput) => ResolvedColorVariant;
-  var format: (variant: ResolvedColorVariant, colorFormat?: GlazeColorFormat) => string;
+  var format: (variant: ResolvedColorVariant, colorFormat?: GlazeColorFormat, pastel?: boolean) => string;
   var fromHex: (hex: string) => GlazeTheme;
   var fromRgb: (r: number, g: number, b: number) => GlazeTheme;
   var colorFrom: (data: GlazeColorTokenExport) => GlazeColorToken;
@@ -956,15 +1001,25 @@ type Vec3 = [number, number, number];
  * OKHSL toe function: maps OKLab lightness L to perceptual lightness l.
  * Exported for the OKHST tone transfers in `okhst.ts`.
  */
+/**
+ * OKHSL lightness of the gamut cusp for a hue — the lightness where the
+ * realizable chroma peaks. Reuses the same `find_cusp` OKHSL already runs for
+ * its `s` normalization (no new color math); the OKLab cusp lightness is run
+ * through the OKHSL `toe` and clamped to `[0.001, 0.999]` so divisions that
+ * key off it stay safe. Cached per (rounded) hue.
+ *
+ * @param h Hue, 0–360.
+ */
+declare function cuspLightness(h: number): number;
 /**
  * Convert OKHSL (h: 0–360, s: 0–1, l: 0–1) to OKLab [L, a, b].
  */
-declare function okhslToOklab(h: number, s: number, l: number): [number, number, number];
+declare function okhslToOklab(h: number, s: number, l: number, pastel?: boolean): [number, number, number];
 /**
  * Convert OKHSL (h: 0–360, s: 0–1, l: 0–1) to linear sRGB.
  * Channels may exceed [0, 1] near gamut boundaries — caller must clamp if needed.
  */
-declare function okhslToLinearSrgb(h: number, s: number, l: number): [number, number, number];
+declare function okhslToLinearSrgb(h: number, s: number, l: number, pastel?: boolean): [number, number, number];
 /**
  * Compute relative luminance Y from linear sRGB channels.
  * Per WCAG 2: Y = 0.2126·R + 0.7152·G + 0.0722·B
@@ -977,7 +1032,7 @@ declare function contrastRatioFromLuminance(yA: number, yB: number): number;
 /**
  * Convert OKHSL to gamma-encoded sRGB (clamped to 0–1).
  */
-declare function okhslToSrgb(h: number, s: number, l: number): [number, number, number];
+declare function okhslToSrgb(h: number, s: number, l: number, pastel?: boolean): [number, number, number];
 /**
  * Compute WCAG 2 relative luminance from linear sRGB, matching the browser
  * rendering pipeline: gamma-encode, clamp to sRGB gamut [0,1], then linearize.
@@ -989,12 +1044,12 @@ declare function gamutClampedLuminance(linearRgb: [number, number, number]): num
  * Input: [L, a, b] where L: 0–1, a/b: roughly -0.5 to 0.5.
  * Returns [h, s, l] where h: 0–360, s: 0–1, l: 0–1.
  */
-declare const oklabToOkhsl: (lab: Vec3) => Vec3;
+declare const oklabToOkhsl: (lab: Vec3, pastel?: boolean) => Vec3;
 /**
  * Convert gamma-encoded sRGB (0–1 per channel) to OKHSL.
  * Returns [h, s, l] where h: 0–360, s: 0–1, l: 0–1.
  */
-declare function srgbToOkhsl(rgb: [number, number, number]): [number, number, number];
+declare function srgbToOkhsl(rgb: [number, number, number], pastel?: boolean): [number, number, number];
 /**
  * Convert CSS HSL (sRGB-based) to gamma-encoded sRGB [r, g, b] in 0–1 range.
  * h: 0–360, s: 0–1, l: 0–1.
@@ -1024,23 +1079,23 @@ declare function parseHexAlpha(hex: string): {
  * Format OKHSL values as a CSS `okhsl(H S% L%)` string.
  * h: 0–360, s: 0–100, l: 0–100 (percentage scale for s and l).
  */
-declare function formatOkhsl(h: number, s: number, l: number): string;
+declare function formatOkhsl(h: number, s: number, l: number, pastel?: boolean): string;
 /**
  * Format OKHSL values as a CSS `rgb(R G B)` string.
  * Uses 2 decimal places to avoid 8-bit quantization contrast loss.
  * h: 0–360, s: 0–100, l: 0–100 (percentage scale for s and l).
  */
-declare function formatRgb(h: number, s: number, l: number): string;
+declare function formatRgb(h: number, s: number, l: number, pastel?: boolean): string;
 /**
  * Format OKHSL values as a CSS `hsl(H S% L%)` string.
  * h: 0–360, s: 0–100, l: 0–100 (percentage scale for s and l).
  */
-declare function formatHsl(h: number, s: number, l: number): string;
+declare function formatHsl(h: number, s: number, l: number, pastel?: boolean): string;
 /**
  * Format OKHSL values as a CSS `oklch(L C H)` string.
  * h: 0–360, s: 0–100, l: 0–100 (percentage scale for s and l).
  */
-declare function formatOklch(h: number, s: number, l: number): string;
+declare function formatOklch(h: number, s: number, l: number, pastel?: boolean): string;
 //#endregion
-export { type AdaptationMode, type ColorDef, type ColorMap, type ContrastPreset, type ContrastSpec, type ExtremeValue, type FindToneForContrastOptions, type FindToneForContrastResult, type FindValueForMixContrastOptions, type FindValueForMixContrastResult, type GlazeColorCssOptions, type GlazeColorFormat, type GlazeColorInput, type GlazeColorInputExport, type GlazeColorOverrides, type GlazeColorOverridesExport, type GlazeColorToken, type GlazeColorTokenExport, type GlazeColorValue, type GlazeConfig, type GlazeConfigOverride, type GlazeConfigResolved, type GlazeCssOptions, type GlazeCssResult, type GlazeExtendOptions, type GlazeFromInput, type GlazeJsonOptions, type GlazeOutputModes, type GlazePalette, type GlazePaletteExportOptions, type GlazePaletteOptions, type GlazeShadowInput, type GlazeTheme, type GlazeThemeExport, type GlazeTokenOptions, type HCPair, type HexColor, type MinContrast, type MixColorDef, type OkhslColor, type OkhstColor, type OklchColor, REF_EPS, type RegularColorDef, type RelativeValue, type ResolvedColor, type ResolvedColorVariant, type ResolvedContrast, type RgbColor, type ShadowColorDef, type ShadowTuning, type ToneValue, type ToneWindow, apcaContrast, contrastRatioFromLuminance, findToneForContrast, findValueForMixContrast, formatHsl, formatOkhsl, formatOklch, formatRgb, fromTone, gamutClampedLuminance, glaze, hslToSrgb, okhslToLinearSrgb, okhslToOkhst, okhslToOklab, okhslToSrgb, okhstToOkhsl, oklabToOkhsl, parseHex, parseHexAlpha, relativeLuminanceFromLinearRgb, resolveContrastForMode, resolveMinContrast, srgbToOkhsl, toTone, toneFromY, variantToOkhsl, yFromTone };
+export { type AdaptationMode, type ColorDef, type ColorMap, type ContrastPreset, type ContrastSpec, type ExtremeValue, type FindToneForContrastOptions, type FindToneForContrastResult, type FindValueForMixContrastOptions, type FindValueForMixContrastResult, type GlazeColorCssOptions, type GlazeColorFormat, type GlazeColorInput, type GlazeColorInputExport, type GlazeColorOverrides, type GlazeColorOverridesExport, type GlazeColorToken, type GlazeColorTokenExport, type GlazeColorValue, type GlazeConfig, type GlazeConfigOverride, type GlazeConfigResolved, type GlazeCssOptions, type GlazeCssResult, type GlazeExtendOptions, type GlazeFromInput, type GlazeJsonOptions, type GlazeOutputModes, type GlazePalette, type GlazePaletteExportOptions, type GlazePaletteOptions, type GlazeShadowInput, type GlazeTheme, type GlazeThemeExport, type GlazeTokenOptions, type HCPair, type HexColor, type MinContrast, type MixColorDef, type OkhslColor, type OkhstColor, type OklchColor, REF_EPS, type RegularColorDef, type RelativeValue, type ResolvedColor, type ResolvedColorVariant, type ResolvedContrast, type RgbColor, type ShadowColorDef, type ShadowTuning, type ToneValue, type ToneWindow, apcaContrast, contrastRatioFromLuminance, cuspLightness, findToneForContrast, findValueForMixContrast, formatHsl, formatOkhsl, formatOklch, formatRgb, fromTone, gamutClampedLuminance, glaze, hslToSrgb, okhslToLinearSrgb, okhslToOkhst, okhslToOklab, okhslToSrgb, okhstToOkhsl, oklabToOkhsl, parseHex, parseHexAlpha, relativeLuminanceFromLinearRgb, resolveContrastForMode, resolveMinContrast, srgbToOkhsl, toTone, toneFromY, variantToOkhsl, yFromTone };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -41,13 +41,8 @@ interface FindToneForContrastOptions {
   initialDirection?: 'lighter' | 'darker';
   /** Auto-flip tone direction when contrast can't be met. Default: false. */
   flip?: boolean;
-  /**
-   * Saturation taper strength (0–1). When set, candidate saturation is rolled
-   * off toward the tone extremes via the same envelope the renderer applies,
-   * so the solved tone meets the floor with its *rendered* saturation. Default
-   * `0` (no taper) for direct/advanced callers.
-   */
-  saturationTaper?: number;
+  /** Use the hue-independent "safe" chroma boundary. Default: false. */
+  pastel?: boolean;
 }
 interface FindToneForContrastResult {
   /** Chosen tone in 0–1. */
@@ -222,6 +217,13 @@ interface RegularColorDef {
    * should not be combined (a console.warn is emitted).
    */
   opacity?: number;
+  /**
+   * Per-color override for the hue-independent "safe" chroma limit used in
+   * OKHSL↔sRGB conversions (luminance, contrast solving, output formatting).
+   * Falls through to the global / per-theme `pastel` config when omitted.
+   * @see GlazeConfig.pastel
+   */
+  pastel?: boolean;
   /**
    * Whether this color is inherited by child themes created via `extend()`.
    * Default: true. Set to false to make this color local to the current theme.
@@ -271,6 +273,13 @@ interface ShadowColorDef {
   intensity: HCPair<number>;
   /** Override default tuning. Merged field-by-field with global `shadowTuning`. */
   tuning?: ShadowTuning;
+  /**
+   * Per-color override for the hue-independent "safe" chroma limit used in
+   * OKHSL↔sRGB conversions (luminance, contrast solving, output formatting).
+   * Falls through to the global / per-theme `pastel` config when omitted.
+   * @see GlazeConfig.pastel
+   */
+  pastel?: boolean;
   /**
    * Whether this color is inherited by child themes created via `extend()`.
    * Default: true. Set to false to make this color local to the current theme.
@@ -311,6 +320,13 @@ interface MixColorDef {
    * metric. Supports [normal, highContrast] pair.
    */
   contrast?: HCPair<ContrastSpec>;
+  /**
+   * Per-color override for the hue-independent "safe" chroma limit used in
+   * OKHSL↔sRGB conversions (luminance, contrast solving, output formatting).
+   * Falls through to the global / per-theme `pastel` config when omitted.
+   * @see GlazeConfig.pastel
+   */
+  pastel?: boolean;
   /**
    * Whether this color is inherited by child themes created via `extend()`.
    * Default: true. Set to false to make this color local to the current theme.
@@ -335,6 +351,12 @@ interface ResolvedColorVariant {
   t: number;
   /** Opacity (0–1). Default: 1. */
   alpha: number;
+  /**
+   * Effective `pastel` flag used while resolving this variant (author def or
+   * config fallback). Carried on the variant so output formatting matches the
+   * gamut mapping applied during resolution.
+   */
+  pastel?: boolean;
 }
 /** Fully resolved color across all scheme variants. */
 interface ResolvedColor {
@@ -367,12 +389,6 @@ interface GlazeConfig {
   darkTone?: ToneWindow;
   /** Saturation reduction factor for dark scheme (0–1). Default: 0.1. */
   darkDesaturation?: number;
-  /**
-   * Saturation taper toward the tone extremes (0–1). The fraction of the
-   * tone range over which saturation rolls off at each end, where in-gamut
-   * chroma collapses. Default: 0.15. Set to 0 to disable.
-   */
-  saturationTaper?: number;
   /** State alias names for token export. */
   states?: {
     dark?: string;
@@ -397,12 +413,18 @@ interface GlazeConfig {
    * falls back to the originally requested tone).
    */
   autoFlip?: boolean;
+  /**
+   * If true, uses a hue-independent "safe" chroma limit across all colors
+   * so that scaling saturation never exceeds the sRGB boundary at any hue
+   * for the given lightness.
+   * @default false
+   */
+  pastel?: boolean;
 }
 interface GlazeConfigResolved {
   lightTone: ToneWindow;
   darkTone: ToneWindow;
   darkDesaturation: number;
-  saturationTaper: number;
   states: {
     dark: string;
     highContrast: string;
@@ -410,6 +432,7 @@ interface GlazeConfigResolved {
   modes: Required<GlazeOutputModes>;
   shadowTuning?: ShadowTuning;
   autoFlip: boolean;
+  pastel: boolean;
 }
 /**
  * Per-instance config override for `glaze.color()` and `glaze()` themes.
@@ -425,10 +448,14 @@ interface GlazeConfigOverride {
   darkTone?: ToneWindow;
   /** Saturation reduction factor for dark scheme (0–1). */
   darkDesaturation?: number;
-  /** Saturation taper toward the tone extremes (0–1). */
-  saturationTaper?: number;
   /** Whether to auto-flip tone when contrast can't be met. */
   autoFlip?: boolean;
+  /**
+   * If true, uses a hue-independent "safe" chroma limit across all colors
+   * so that scaling saturation never exceeds the sRGB boundary at any hue
+   * for the given lightness.
+   */
+  pastel?: boolean;
   /**
    * Shadow tuning defaults. Only meaningful for themes; harmless on
    * standalone color tokens.
@@ -493,6 +520,13 @@ interface GlazeColorInput {
    * used). Does not affect output keys.
    */
   name?: string;
+  /**
+   * Per-color override for the hue-independent "safe" chroma limit used in
+   * OKHSL↔sRGB conversions (luminance, contrast solving, output formatting).
+   * Falls through to the global / per-theme `pastel` config when omitted.
+   * @see GlazeConfig.pastel
+   */
+  pastel?: boolean;
 }
 /**
  * Any single-color input form accepted by the value-shorthand
@@ -593,6 +627,13 @@ interface GlazeColorOverrides {
    * used). Does not affect output keys.
    */
   name?: string;
+  /**
+   * Per-color override for the hue-independent "safe" chroma limit used in
+   * OKHSL↔sRGB conversions (luminance, contrast solving, output formatting).
+   * Falls through to the global / per-theme `pastel` config when omitted.
+   * @see GlazeConfig.pastel
+   */
+  pastel?: boolean;
 }
 /**
  * Object input for `glaze.color()` that carries a raw color value plus
@@ -689,6 +730,7 @@ interface GlazeColorInputExport {
   base?: GlazeColorTokenExport | GlazeColorValue;
   contrast?: HCPair<ContrastSpec>;
   name?: string;
+  pastel?: boolean;
 }
 /**
  * Serializable shape of `GlazeColorOverrides`. `base` is replaced by
@@ -705,12 +747,15 @@ interface GlazeColorOverridesExport {
   base?: GlazeColorTokenExport | GlazeColorValue;
   opacity?: number;
   name?: string;
+  pastel?: boolean;
 }
 interface GlazeTheme {
   /** The hue seed (0–360). */
   readonly hue: number;
   /** The saturation seed (0–100). */
   readonly saturation: number;
+  /** The effective config for this theme. */
+  getConfig(): GlazeConfigResolved;
   /** Add/replace colors (additive merge with existing definitions). */
   colors(defs: ColorMap): void;
   /** Get a color definition by name. */
@@ -857,7 +902,7 @@ type PaletteInput = Record<string, GlazeTheme>;
  * Create a single-hue glaze theme.
  *
  * An optional `config` override can be supplied to customize the resolve
- * behavior for this theme (tone windows, saturation taper, etc.). The
+ * behavior for this theme (tone windows, etc.). The
  * override is **merged over the live global config at resolve time** —
  * the theme still reacts to later `configure()` calls for fields it
  * didn't override.
@@ -881,7 +926,7 @@ declare namespace glaze {
   var from: (data: GlazeThemeExport) => GlazeTheme;
   var color: (input: GlazeFromInput | GlazeColorInput | GlazeColorValue, config?: GlazeConfigOverride) => GlazeColorToken;
   var shadow: (input: GlazeShadowInput) => ResolvedColorVariant;
-  var format: (variant: ResolvedColorVariant, colorFormat?: GlazeColorFormat) => string;
+  var format: (variant: ResolvedColorVariant, colorFormat?: GlazeColorFormat, pastel?: boolean) => string;
   var fromHex: (hex: string) => GlazeTheme;
   var fromRgb: (r: number, g: number, b: number) => GlazeTheme;
   var colorFrom: (data: GlazeColorTokenExport) => GlazeColorToken;
@@ -956,15 +1001,25 @@ type Vec3 = [number, number, number];
  * OKHSL toe function: maps OKLab lightness L to perceptual lightness l.
  * Exported for the OKHST tone transfers in `okhst.ts`.
  */
+/**
+ * OKHSL lightness of the gamut cusp for a hue — the lightness where the
+ * realizable chroma peaks. Reuses the same `find_cusp` OKHSL already runs for
+ * its `s` normalization (no new color math); the OKLab cusp lightness is run
+ * through the OKHSL `toe` and clamped to `[0.001, 0.999]` so divisions that
+ * key off it stay safe. Cached per (rounded) hue.
+ *
+ * @param h Hue, 0–360.
+ */
+declare function cuspLightness(h: number): number;
 /**
  * Convert OKHSL (h: 0–360, s: 0–1, l: 0–1) to OKLab [L, a, b].
  */
-declare function okhslToOklab(h: number, s: number, l: number): [number, number, number];
+declare function okhslToOklab(h: number, s: number, l: number, pastel?: boolean): [number, number, number];
 /**
  * Convert OKHSL (h: 0–360, s: 0–1, l: 0–1) to linear sRGB.
  * Channels may exceed [0, 1] near gamut boundaries — caller must clamp if needed.
  */
-declare function okhslToLinearSrgb(h: number, s: number, l: number): [number, number, number];
+declare function okhslToLinearSrgb(h: number, s: number, l: number, pastel?: boolean): [number, number, number];
 /**
  * Compute relative luminance Y from linear sRGB channels.
  * Per WCAG 2: Y = 0.2126·R + 0.7152·G + 0.0722·B
@@ -977,7 +1032,7 @@ declare function contrastRatioFromLuminance(yA: number, yB: number): number;
 /**
  * Convert OKHSL to gamma-encoded sRGB (clamped to 0–1).
  */
-declare function okhslToSrgb(h: number, s: number, l: number): [number, number, number];
+declare function okhslToSrgb(h: number, s: number, l: number, pastel?: boolean): [number, number, number];
 /**
  * Compute WCAG 2 relative luminance from linear sRGB, matching the browser
  * rendering pipeline: gamma-encode, clamp to sRGB gamut [0,1], then linearize.
@@ -989,12 +1044,12 @@ declare function gamutClampedLuminance(linearRgb: [number, number, number]): num
  * Input: [L, a, b] where L: 0–1, a/b: roughly -0.5 to 0.5.
  * Returns [h, s, l] where h: 0–360, s: 0–1, l: 0–1.
  */
-declare const oklabToOkhsl: (lab: Vec3) => Vec3;
+declare const oklabToOkhsl: (lab: Vec3, pastel?: boolean) => Vec3;
 /**
  * Convert gamma-encoded sRGB (0–1 per channel) to OKHSL.
  * Returns [h, s, l] where h: 0–360, s: 0–1, l: 0–1.
  */
-declare function srgbToOkhsl(rgb: [number, number, number]): [number, number, number];
+declare function srgbToOkhsl(rgb: [number, number, number], pastel?: boolean): [number, number, number];
 /**
  * Convert CSS HSL (sRGB-based) to gamma-encoded sRGB [r, g, b] in 0–1 range.
  * h: 0–360, s: 0–1, l: 0–1.
@@ -1024,23 +1079,23 @@ declare function parseHexAlpha(hex: string): {
  * Format OKHSL values as a CSS `okhsl(H S% L%)` string.
  * h: 0–360, s: 0–100, l: 0–100 (percentage scale for s and l).
  */
-declare function formatOkhsl(h: number, s: number, l: number): string;
+declare function formatOkhsl(h: number, s: number, l: number, pastel?: boolean): string;
 /**
  * Format OKHSL values as a CSS `rgb(R G B)` string.
  * Uses 2 decimal places to avoid 8-bit quantization contrast loss.
  * h: 0–360, s: 0–100, l: 0–100 (percentage scale for s and l).
  */
-declare function formatRgb(h: number, s: number, l: number): string;
+declare function formatRgb(h: number, s: number, l: number, pastel?: boolean): string;
 /**
  * Format OKHSL values as a CSS `hsl(H S% L%)` string.
  * h: 0–360, s: 0–100, l: 0–100 (percentage scale for s and l).
  */
-declare function formatHsl(h: number, s: number, l: number): string;
+declare function formatHsl(h: number, s: number, l: number, pastel?: boolean): string;
 /**
  * Format OKHSL values as a CSS `oklch(L C H)` string.
  * h: 0–360, s: 0–100, l: 0–100 (percentage scale for s and l).
  */
-declare function formatOklch(h: number, s: number, l: number): string;
+declare function formatOklch(h: number, s: number, l: number, pastel?: boolean): string;
 //#endregion
-export { type AdaptationMode, type ColorDef, type ColorMap, type ContrastPreset, type ContrastSpec, type ExtremeValue, type FindToneForContrastOptions, type FindToneForContrastResult, type FindValueForMixContrastOptions, type FindValueForMixContrastResult, type GlazeColorCssOptions, type GlazeColorFormat, type GlazeColorInput, type GlazeColorInputExport, type GlazeColorOverrides, type GlazeColorOverridesExport, type GlazeColorToken, type GlazeColorTokenExport, type GlazeColorValue, type GlazeConfig, type GlazeConfigOverride, type GlazeConfigResolved, type GlazeCssOptions, type GlazeCssResult, type GlazeExtendOptions, type GlazeFromInput, type GlazeJsonOptions, type GlazeOutputModes, type GlazePalette, type GlazePaletteExportOptions, type GlazePaletteOptions, type GlazeShadowInput, type GlazeTheme, type GlazeThemeExport, type GlazeTokenOptions, type HCPair, type HexColor, type MinContrast, type MixColorDef, type OkhslColor, type OkhstColor, type OklchColor, REF_EPS, type RegularColorDef, type RelativeValue, type ResolvedColor, type ResolvedColorVariant, type ResolvedContrast, type RgbColor, type ShadowColorDef, type ShadowTuning, type ToneValue, type ToneWindow, apcaContrast, contrastRatioFromLuminance, findToneForContrast, findValueForMixContrast, formatHsl, formatOkhsl, formatOklch, formatRgb, fromTone, gamutClampedLuminance, glaze, hslToSrgb, okhslToLinearSrgb, okhslToOkhst, okhslToOklab, okhslToSrgb, okhstToOkhsl, oklabToOkhsl, parseHex, parseHexAlpha, relativeLuminanceFromLinearRgb, resolveContrastForMode, resolveMinContrast, srgbToOkhsl, toTone, toneFromY, variantToOkhsl, yFromTone };
+export { type AdaptationMode, type ColorDef, type ColorMap, type ContrastPreset, type ContrastSpec, type ExtremeValue, type FindToneForContrastOptions, type FindToneForContrastResult, type FindValueForMixContrastOptions, type FindValueForMixContrastResult, type GlazeColorCssOptions, type GlazeColorFormat, type GlazeColorInput, type GlazeColorInputExport, type GlazeColorOverrides, type GlazeColorOverridesExport, type GlazeColorToken, type GlazeColorTokenExport, type GlazeColorValue, type GlazeConfig, type GlazeConfigOverride, type GlazeConfigResolved, type GlazeCssOptions, type GlazeCssResult, type GlazeExtendOptions, type GlazeFromInput, type GlazeJsonOptions, type GlazeOutputModes, type GlazePalette, type GlazePaletteExportOptions, type GlazePaletteOptions, type GlazeShadowInput, type GlazeTheme, type GlazeThemeExport, type GlazeTokenOptions, type HCPair, type HexColor, type MinContrast, type MixColorDef, type OkhslColor, type OkhstColor, type OklchColor, REF_EPS, type RegularColorDef, type RelativeValue, type ResolvedColor, type ResolvedColorVariant, type ResolvedContrast, type RgbColor, type ShadowColorDef, type ShadowTuning, type ToneValue, type ToneWindow, apcaContrast, contrastRatioFromLuminance, cuspLightness, findToneForContrast, findValueForMixContrast, formatHsl, formatOkhsl, formatOklch, formatRgb, fromTone, gamutClampedLuminance, glaze, hslToSrgb, okhslToLinearSrgb, okhslToOkhst, okhslToOklab, okhslToSrgb, okhstToOkhsl, oklabToOkhsl, parseHex, parseHexAlpha, relativeLuminanceFromLinearRgb, resolveContrastForMode, resolveMinContrast, srgbToOkhsl, toTone, toneFromY, variantToOkhsl, yFromTone };
 //# sourceMappingURL=index.d.mts.map