@tenphi/glaze 0.0.0-snapshot.99c649d → 0.0.0-snapshot.9ff0fda

package/dist/index.d.cts

@@ -6,6 +6,7 @@
  * against a base color. Used by glaze when resolving dependent colors
  * with `contrast`.
  */
+type LinearRgb = [number, number, number];
 type ContrastPreset = 'AA' | 'AAA' | 'AA-large' | 'AAA-large';
 type MinContrast$1 = number | ContrastPreset;
 interface FindLightnessForContrastOptions {
@@ -42,6 +43,39 @@ declare function resolveMinContrast(value: MinContrast$1): number;
  * against a base color, staying as close to `preferredLightness` as possible.
  */
 declare function findLightnessForContrast(options: FindLightnessForContrastOptions): FindLightnessForContrastResult;
+interface FindValueForMixContrastOptions {
+  /** Preferred mix parameter (0–1). */
+  preferredValue: number;
+  /** Base color as linear sRGB. */
+  baseLinearRgb: LinearRgb;
+  /** Target color as linear sRGB. */
+  targetLinearRgb: LinearRgb;
+  /** WCAG contrast target. */
+  contrast: MinContrast$1;
+  /**
+   * Compute the luminance of the mixed color at parameter t.
+   * For opaque: luminance of OKHSL-interpolated color.
+   * For transparent: luminance of alpha-composited color over base.
+   */
+  luminanceAtValue: (t: number) => number;
+  /** Convergence threshold. Default: 1e-4. */
+  epsilon?: number;
+  /** Maximum binary-search iterations per branch. Default: 20. */
+  maxIterations?: number;
+}
+interface FindValueForMixContrastResult {
+  /** Chosen mix parameter (0–1). */
+  value: number;
+  /** Achieved WCAG contrast ratio. */
+  contrast: number;
+  /** Whether the target was reached. */
+  met: boolean;
+}
+/**
+ * Find the mix parameter (ratio or opacity) that satisfies a WCAG 2 contrast
+ * target against a base color, staying as close to `preferredValue` as possible.
+ */
+declare function findValueForMixContrast(options: FindValueForMixContrastOptions): FindValueForMixContrastResult;
 //#endregion
 //#region src/types.d.ts
 /** A value or [normal, high-contrast] pair. */
@@ -144,7 +178,41 @@ interface ShadowColorDef {
   /** Override default tuning. Merged field-by-field with global `shadowTuning`. */
   tuning?: ShadowTuning;
 }
-type ColorDef = RegularColorDef | ShadowColorDef;
+interface MixColorDef {
+  type: 'mix';
+  /** Background/base color name — the "from" color. */
+  base: string;
+  /** Target color name — the "to" color to mix toward. */
+  target: string;
+  /**
+   * Mix ratio 0–100 (0 = pure base, 100 = pure target).
+   * In 'transparent' blend mode, this controls the opacity of the target.
+   * Supports [normal, highContrast] pair.
+   */
+  value: HCPair<number>;
+  /**
+   * Blending mode. Default: 'opaque'.
+   * - 'opaque': produces a solid color by interpolating base and target.
+   * - 'transparent': produces the target color with alpha = value/100.
+   */
+  blend?: 'opaque' | 'transparent';
+  /**
+   * Interpolation color space for opaque blending. Default: 'okhsl'.
+   * - 'okhsl': perceptually uniform, consistent with Glaze's internal model.
+   * - 'srgb': linear sRGB interpolation, matches browser compositing.
+   *
+   * Ignored for 'transparent' blend (always composites in linear sRGB).
+   */
+  space?: 'okhsl' | 'srgb';
+  /**
+   * Minimum WCAG contrast between the base and the resulting color.
+   * In 'opaque' mode, adjusts the mix ratio to meet contrast.
+   * In 'transparent' mode, adjusts opacity to meet contrast against the composite.
+   * Supports [normal, highContrast] pair.
+   */
+  contrast?: HCPair<MinContrast>;
+}
+type ColorDef = RegularColorDef | ShadowColorDef | MixColorDef;
 type ColorMap = Record<string, ColorDef>;
 /** Resolved color for a single scheme variant. */
 interface ResolvedColorVariant {
@@ -174,6 +242,13 @@ interface GlazeConfig {
   darkLightness?: [number, number];
   /** Saturation reduction factor for dark scheme (0–1). Default: 0.1. */
   darkDesaturation?: number;
+  /**
+   * Möbius beta for dark auto-inversion (0–1).
+   * Lower values expand subtle near-white distinctions in dark mode.
+   * Set to 1 for linear (legacy) behavior. Default: 0.5.
+   * Accepts [normal, highContrast] pair for separate HC tuning.
+   */
+  darkCurve?: HCPair<number>;
   /** State alias names for token export. */
   states?: {
     dark?: string;
@@ -188,6 +263,7 @@ interface GlazeConfigResolved {
   lightLightness: [number, number];
   darkLightness: [number, number];
   darkDesaturation: number;
+  darkCurve: HCPair<number>;
   states: {
     dark: string;
     highContrast: string;
@@ -317,33 +393,64 @@ interface GlazeCssResult {
   lightContrast: string;
   darkContrast: string;
 }
+/** Options for `glaze.palette()` creation. */
+interface GlazePaletteOptions {
+  /**
+   * Name of the primary theme. The primary theme's tokens are duplicated
+   * without prefix in all exports, providing convenient short aliases
+   * alongside the prefixed versions. Can be overridden per-export.
+   *
+   * @example
+   * ```ts
+   * const palette = glaze.palette({ brand, accent }, { primary: 'brand' });
+   * palette.tokens()
+   * // → { light: { 'brand-surface': '...', 'surface': '...', 'accent-surface': '...' } }
+   * ```
+   */
+  primary?: string;
+}
+/** Options shared by palette `tokens()`, `tasty()`, and `css()` exports. */
+interface GlazePaletteExportOptions {
+  /**
+   * Prefix mode. `true` uses `"<themeName>-"`, or provide a custom map.
+   * Defaults to `true` for palette export methods.
+   * Set to `false` explicitly to disable prefixing. Colliding keys
+   * produce a console.warn and the first-written value wins.
+   */
+  prefix?: boolean | Record<string, string>;
+  /**
+   * Override the palette-level primary theme for this export.
+   * Pass a theme name to set/change the primary, or `false` to disable it.
+   * When omitted, inherits the palette-level `primary`.
+   */
+  primary?: string | false;
+}
 interface GlazePalette {
   /**
    * Export all themes as a flat token map grouped by scheme variant.
+   * Prefix defaults to `true` — all tokens are prefixed with the theme name.
+   * Inherits the palette-level `primary`; override per-call or pass `false` to disable.
    *
    * ```ts
-   * palette.tokens({ prefix: true })
-   * // → { light: { 'primary-surface': 'okhsl(...)' }, dark: { 'primary-surface': 'okhsl(...)' } }
+   * const palette = glaze.palette({ brand, accent }, { primary: 'brand' });
+   * palette.tokens()
+   * // → { light: { 'brand-surface': '...', 'surface': '...', 'accent-surface': '...' } }
    * ```
    */
-  tokens(options?: GlazeJsonOptions & {
-    prefix?: boolean | Record<string, string>;
-  }): Record<string, Record<string, string>>;
+  tokens(options?: GlazeJsonOptions & GlazePaletteExportOptions): Record<string, Record<string, string>>;
   /**
    * Export all themes as tasty style-to-state bindings.
    * Uses `#name` color token keys and state aliases (`''`, `@dark`, etc.).
-   * Spread into component styles or register as a recipe via `configure({ recipes })`.
+   * Prefix defaults to `true`. Inherits the palette-level `primary`.
    * @see https://cube-ui-kit.vercel.app/?path=/docs/tasty-documentation--docs
    */
-  tasty(options?: GlazeTokenOptions): Record<string, Record<string, string>>;
-  /** Export all themes as plain JSON. */
+  tasty(options?: GlazeTokenOptions & GlazePaletteExportOptions): Record<string, Record<string, string>>;
+  /** Export all themes as plain JSON grouped by theme name. */
   json(options?: GlazeJsonOptions & {
     prefix?: boolean | Record<string, string>;
   }): Record<string, Record<string, Record<string, string>>>;
   /** Export all themes as CSS custom property declarations. */
-  css(options?: GlazeCssOptions & {
-    prefix?: boolean | Record<string, string>;
-  }): GlazeCssResult;
+  css(options?: GlazeCssOptions & GlazePaletteExportOptions): GlazeCssResult;
 }
 //#endregion
 //#region src/glaze.d.ts
@@ -364,17 +471,13 @@ declare function glaze(hueOrOptions: number | {
 }, saturation?: number): GlazeTheme;
 declare namespace glaze {
   var configure: (config: GlazeConfig) => void;
-  var palette: (themes: PaletteInput) => {
-    tokens(options?: GlazeJsonOptions & {
-      prefix?: boolean | Record<string, string>;
-    }): Record<string, Record<string, string>>;
-    tasty(options?: GlazeTokenOptions): Record<string, Record<string, string>>;
+  var palette: (themes: PaletteInput, options?: GlazePaletteOptions) => {
+    tokens(options?: GlazeJsonOptions & GlazePaletteExportOptions): Record<string, Record<string, string>>;
+    tasty(options?: GlazeTokenOptions & GlazePaletteExportOptions): Record<string, Record<string, string>>;
     json(options?: GlazeJsonOptions & {
       prefix?: boolean | Record<string, string>;
     }): Record<string, Record<string, Record<string, string>>>;
-    css(options?: GlazeCssOptions & {
-      prefix?: boolean | Record<string, string>;
-    }): GlazeCssResult;
+    css(options?: GlazeCssOptions & GlazePaletteExportOptions): GlazeCssResult;
   };
   var from: (data: GlazeThemeExport) => GlazeTheme;
   var color: (input: GlazeColorInput) => GlazeColorToken;
@@ -394,6 +497,10 @@ declare namespace glaze {
  * computation for WCAG 2 contrast calculations, and multi-format output
  * (okhsl, rgb, hsl, oklch).
  */
+/**
+ * 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];
 /**
  * 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.
@@ -413,9 +520,11 @@ declare function contrastRatioFromLuminance(yA: number, yB: number): number;
  */
 declare function okhslToSrgb(h: number, s: number, l: number): [number, number, number];
 /**
- * Convert OKHSL (h: 0–360, s: 0–1, l: 0–1) to OKLab [L, a, b].
+ * Compute WCAG 2 relative luminance from linear sRGB, matching the browser
+ * rendering pipeline: gamma-encode, clamp to sRGB gamut [0,1], then linearize.
+ * This avoids over/under-estimating luminance for out-of-gamut OKHSL colors.
  */
-declare function okhslToOklab(h: number, s: number, l: number): [number, number, number];
+declare function gamutClampedLuminance(linearRgb: [number, number, number]): number;
 /**
  * Convert gamma-encoded sRGB (0–1 per channel) to OKHSL.
  * Returns [h, s, l] where h: 0–360, s: 0–1, l: 0–1.
@@ -432,7 +541,8 @@ declare function parseHex(hex: string): [number, number, number] | null;
  */
 declare function formatOkhsl(h: number, s: number, l: number): string;
 /**
- * Format OKHSL values as a CSS `rgb(R G B)` string with rounded integer values.
+ * 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;
@@ -447,5 +557,5 @@ declare function formatHsl(h: number, s: number, l: number): string;
  */
 declare function formatOklch(h: number, s: number, l: number): string;
 //#endregion
-export { type AdaptationMode, type ColorDef, type ColorMap, type ContrastPreset, type FindLightnessForContrastOptions, type FindLightnessForContrastResult, type GlazeColorFormat, type GlazeColorInput, type GlazeColorToken, type GlazeConfig, type GlazeCssOptions, type GlazeCssResult, type GlazeExtendOptions, type GlazeJsonOptions, type GlazeOutputModes, type GlazePalette, type GlazeShadowInput, type GlazeTheme, type GlazeThemeExport, type GlazeTokenOptions, type HCPair, type HexColor, type MinContrast, type OkhslColor, type RegularColorDef, type RelativeValue, type ResolvedColor, type ResolvedColorVariant, type ShadowColorDef, type ShadowTuning, contrastRatioFromLuminance, findLightnessForContrast, formatHsl, formatOkhsl, formatOklch, formatRgb, glaze, okhslToLinearSrgb, okhslToOklab, okhslToSrgb, parseHex, relativeLuminanceFromLinearRgb, resolveMinContrast, srgbToOkhsl };
+export { type AdaptationMode, type ColorDef, type ColorMap, type ContrastPreset, type FindLightnessForContrastOptions, type FindLightnessForContrastResult, type FindValueForMixContrastOptions, type FindValueForMixContrastResult, type GlazeColorFormat, type GlazeColorInput, type GlazeColorToken, type GlazeConfig, type GlazeCssOptions, type GlazeCssResult, type GlazeExtendOptions, 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 RegularColorDef, type RelativeValue, type ResolvedColor, type ResolvedColorVariant, type ShadowColorDef, type ShadowTuning, contrastRatioFromLuminance, findLightnessForContrast, findValueForMixContrast, formatHsl, formatOkhsl, formatOklch, formatRgb, gamutClampedLuminance, glaze, okhslToLinearSrgb, okhslToOklab, okhslToSrgb, parseHex, relativeLuminanceFromLinearRgb, resolveMinContrast, srgbToOkhsl };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -6,6 +6,7 @@
  * against a base color. Used by glaze when resolving dependent colors
  * with `contrast`.
  */
+type LinearRgb = [number, number, number];
 type ContrastPreset = 'AA' | 'AAA' | 'AA-large' | 'AAA-large';
 type MinContrast$1 = number | ContrastPreset;
 interface FindLightnessForContrastOptions {
@@ -42,6 +43,39 @@ declare function resolveMinContrast(value: MinContrast$1): number;
  * against a base color, staying as close to `preferredLightness` as possible.
  */
 declare function findLightnessForContrast(options: FindLightnessForContrastOptions): FindLightnessForContrastResult;
+interface FindValueForMixContrastOptions {
+  /** Preferred mix parameter (0–1). */
+  preferredValue: number;
+  /** Base color as linear sRGB. */
+  baseLinearRgb: LinearRgb;
+  /** Target color as linear sRGB. */
+  targetLinearRgb: LinearRgb;
+  /** WCAG contrast target. */
+  contrast: MinContrast$1;
+  /**
+   * Compute the luminance of the mixed color at parameter t.
+   * For opaque: luminance of OKHSL-interpolated color.
+   * For transparent: luminance of alpha-composited color over base.
+   */
+  luminanceAtValue: (t: number) => number;
+  /** Convergence threshold. Default: 1e-4. */
+  epsilon?: number;
+  /** Maximum binary-search iterations per branch. Default: 20. */
+  maxIterations?: number;
+}
+interface FindValueForMixContrastResult {
+  /** Chosen mix parameter (0–1). */
+  value: number;
+  /** Achieved WCAG contrast ratio. */
+  contrast: number;
+  /** Whether the target was reached. */
+  met: boolean;
+}
+/**
+ * Find the mix parameter (ratio or opacity) that satisfies a WCAG 2 contrast
+ * target against a base color, staying as close to `preferredValue` as possible.
+ */
+declare function findValueForMixContrast(options: FindValueForMixContrastOptions): FindValueForMixContrastResult;
 //#endregion
 //#region src/types.d.ts
 /** A value or [normal, high-contrast] pair. */
@@ -144,7 +178,41 @@ interface ShadowColorDef {
   /** Override default tuning. Merged field-by-field with global `shadowTuning`. */
   tuning?: ShadowTuning;
 }
-type ColorDef = RegularColorDef | ShadowColorDef;
+interface MixColorDef {
+  type: 'mix';
+  /** Background/base color name — the "from" color. */
+  base: string;
+  /** Target color name — the "to" color to mix toward. */
+  target: string;
+  /**
+   * Mix ratio 0–100 (0 = pure base, 100 = pure target).
+   * In 'transparent' blend mode, this controls the opacity of the target.
+   * Supports [normal, highContrast] pair.
+   */
+  value: HCPair<number>;
+  /**
+   * Blending mode. Default: 'opaque'.
+   * - 'opaque': produces a solid color by interpolating base and target.
+   * - 'transparent': produces the target color with alpha = value/100.
+   */
+  blend?: 'opaque' | 'transparent';
+  /**
+   * Interpolation color space for opaque blending. Default: 'okhsl'.
+   * - 'okhsl': perceptually uniform, consistent with Glaze's internal model.
+   * - 'srgb': linear sRGB interpolation, matches browser compositing.
+   *
+   * Ignored for 'transparent' blend (always composites in linear sRGB).
+   */
+  space?: 'okhsl' | 'srgb';
+  /**
+   * Minimum WCAG contrast between the base and the resulting color.
+   * In 'opaque' mode, adjusts the mix ratio to meet contrast.
+   * In 'transparent' mode, adjusts opacity to meet contrast against the composite.
+   * Supports [normal, highContrast] pair.
+   */
+  contrast?: HCPair<MinContrast>;
+}
+type ColorDef = RegularColorDef | ShadowColorDef | MixColorDef;
 type ColorMap = Record<string, ColorDef>;
 /** Resolved color for a single scheme variant. */
 interface ResolvedColorVariant {
@@ -174,6 +242,13 @@ interface GlazeConfig {
   darkLightness?: [number, number];
   /** Saturation reduction factor for dark scheme (0–1). Default: 0.1. */
   darkDesaturation?: number;
+  /**
+   * Möbius beta for dark auto-inversion (0–1).
+   * Lower values expand subtle near-white distinctions in dark mode.
+   * Set to 1 for linear (legacy) behavior. Default: 0.5.
+   * Accepts [normal, highContrast] pair for separate HC tuning.
+   */
+  darkCurve?: HCPair<number>;
   /** State alias names for token export. */
   states?: {
     dark?: string;
@@ -188,6 +263,7 @@ interface GlazeConfigResolved {
   lightLightness: [number, number];
   darkLightness: [number, number];
   darkDesaturation: number;
+  darkCurve: HCPair<number>;
   states: {
     dark: string;
     highContrast: string;
@@ -317,33 +393,64 @@ interface GlazeCssResult {
   lightContrast: string;
   darkContrast: string;
 }
+/** Options for `glaze.palette()` creation. */
+interface GlazePaletteOptions {
+  /**
+   * Name of the primary theme. The primary theme's tokens are duplicated
+   * without prefix in all exports, providing convenient short aliases
+   * alongside the prefixed versions. Can be overridden per-export.
+   *
+   * @example
+   * ```ts
+   * const palette = glaze.palette({ brand, accent }, { primary: 'brand' });
+   * palette.tokens()
+   * // → { light: { 'brand-surface': '...', 'surface': '...', 'accent-surface': '...' } }
+   * ```
+   */
+  primary?: string;
+}
+/** Options shared by palette `tokens()`, `tasty()`, and `css()` exports. */
+interface GlazePaletteExportOptions {
+  /**
+   * Prefix mode. `true` uses `"<themeName>-"`, or provide a custom map.
+   * Defaults to `true` for palette export methods.
+   * Set to `false` explicitly to disable prefixing. Colliding keys
+   * produce a console.warn and the first-written value wins.
+   */
+  prefix?: boolean | Record<string, string>;
+  /**
+   * Override the palette-level primary theme for this export.
+   * Pass a theme name to set/change the primary, or `false` to disable it.
+   * When omitted, inherits the palette-level `primary`.
+   */
+  primary?: string | false;
+}
 interface GlazePalette {
   /**
    * Export all themes as a flat token map grouped by scheme variant.
+   * Prefix defaults to `true` — all tokens are prefixed with the theme name.
+   * Inherits the palette-level `primary`; override per-call or pass `false` to disable.
    *
    * ```ts
-   * palette.tokens({ prefix: true })
-   * // → { light: { 'primary-surface': 'okhsl(...)' }, dark: { 'primary-surface': 'okhsl(...)' } }
+   * const palette = glaze.palette({ brand, accent }, { primary: 'brand' });
+   * palette.tokens()
+   * // → { light: { 'brand-surface': '...', 'surface': '...', 'accent-surface': '...' } }
    * ```
    */
-  tokens(options?: GlazeJsonOptions & {
-    prefix?: boolean | Record<string, string>;
-  }): Record<string, Record<string, string>>;
+  tokens(options?: GlazeJsonOptions & GlazePaletteExportOptions): Record<string, Record<string, string>>;
   /**
    * Export all themes as tasty style-to-state bindings.
    * Uses `#name` color token keys and state aliases (`''`, `@dark`, etc.).
-   * Spread into component styles or register as a recipe via `configure({ recipes })`.
+   * Prefix defaults to `true`. Inherits the palette-level `primary`.
    * @see https://cube-ui-kit.vercel.app/?path=/docs/tasty-documentation--docs
    */
-  tasty(options?: GlazeTokenOptions): Record<string, Record<string, string>>;
-  /** Export all themes as plain JSON. */
+  tasty(options?: GlazeTokenOptions & GlazePaletteExportOptions): Record<string, Record<string, string>>;
+  /** Export all themes as plain JSON grouped by theme name. */
   json(options?: GlazeJsonOptions & {
     prefix?: boolean | Record<string, string>;
   }): Record<string, Record<string, Record<string, string>>>;
   /** Export all themes as CSS custom property declarations. */
-  css(options?: GlazeCssOptions & {
-    prefix?: boolean | Record<string, string>;
-  }): GlazeCssResult;
+  css(options?: GlazeCssOptions & GlazePaletteExportOptions): GlazeCssResult;
 }
 //#endregion
 //#region src/glaze.d.ts
@@ -364,17 +471,13 @@ declare function glaze(hueOrOptions: number | {
 }, saturation?: number): GlazeTheme;
 declare namespace glaze {
   var configure: (config: GlazeConfig) => void;
-  var palette: (themes: PaletteInput) => {
-    tokens(options?: GlazeJsonOptions & {
-      prefix?: boolean | Record<string, string>;
-    }): Record<string, Record<string, string>>;
-    tasty(options?: GlazeTokenOptions): Record<string, Record<string, string>>;
+  var palette: (themes: PaletteInput, options?: GlazePaletteOptions) => {
+    tokens(options?: GlazeJsonOptions & GlazePaletteExportOptions): Record<string, Record<string, string>>;
+    tasty(options?: GlazeTokenOptions & GlazePaletteExportOptions): Record<string, Record<string, string>>;
     json(options?: GlazeJsonOptions & {
       prefix?: boolean | Record<string, string>;
     }): Record<string, Record<string, Record<string, string>>>;
-    css(options?: GlazeCssOptions & {
-      prefix?: boolean | Record<string, string>;
-    }): GlazeCssResult;
+    css(options?: GlazeCssOptions & GlazePaletteExportOptions): GlazeCssResult;
   };
   var from: (data: GlazeThemeExport) => GlazeTheme;
   var color: (input: GlazeColorInput) => GlazeColorToken;
@@ -394,6 +497,10 @@ declare namespace glaze {
  * computation for WCAG 2 contrast calculations, and multi-format output
  * (okhsl, rgb, hsl, oklch).
  */
+/**
+ * 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];
 /**
  * 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.
@@ -413,9 +520,11 @@ declare function contrastRatioFromLuminance(yA: number, yB: number): number;
  */
 declare function okhslToSrgb(h: number, s: number, l: number): [number, number, number];
 /**
- * Convert OKHSL (h: 0–360, s: 0–1, l: 0–1) to OKLab [L, a, b].
+ * Compute WCAG 2 relative luminance from linear sRGB, matching the browser
+ * rendering pipeline: gamma-encode, clamp to sRGB gamut [0,1], then linearize.
+ * This avoids over/under-estimating luminance for out-of-gamut OKHSL colors.
  */
-declare function okhslToOklab(h: number, s: number, l: number): [number, number, number];
+declare function gamutClampedLuminance(linearRgb: [number, number, number]): number;
 /**
  * Convert gamma-encoded sRGB (0–1 per channel) to OKHSL.
  * Returns [h, s, l] where h: 0–360, s: 0–1, l: 0–1.
@@ -432,7 +541,8 @@ declare function parseHex(hex: string): [number, number, number] | null;
  */
 declare function formatOkhsl(h: number, s: number, l: number): string;
 /**
- * Format OKHSL values as a CSS `rgb(R G B)` string with rounded integer values.
+ * 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;
@@ -447,5 +557,5 @@ declare function formatHsl(h: number, s: number, l: number): string;
  */
 declare function formatOklch(h: number, s: number, l: number): string;
 //#endregion
-export { type AdaptationMode, type ColorDef, type ColorMap, type ContrastPreset, type FindLightnessForContrastOptions, type FindLightnessForContrastResult, type GlazeColorFormat, type GlazeColorInput, type GlazeColorToken, type GlazeConfig, type GlazeCssOptions, type GlazeCssResult, type GlazeExtendOptions, type GlazeJsonOptions, type GlazeOutputModes, type GlazePalette, type GlazeShadowInput, type GlazeTheme, type GlazeThemeExport, type GlazeTokenOptions, type HCPair, type HexColor, type MinContrast, type OkhslColor, type RegularColorDef, type RelativeValue, type ResolvedColor, type ResolvedColorVariant, type ShadowColorDef, type ShadowTuning, contrastRatioFromLuminance, findLightnessForContrast, formatHsl, formatOkhsl, formatOklch, formatRgb, glaze, okhslToLinearSrgb, okhslToOklab, okhslToSrgb, parseHex, relativeLuminanceFromLinearRgb, resolveMinContrast, srgbToOkhsl };
+export { type AdaptationMode, type ColorDef, type ColorMap, type ContrastPreset, type FindLightnessForContrastOptions, type FindLightnessForContrastResult, type FindValueForMixContrastOptions, type FindValueForMixContrastResult, type GlazeColorFormat, type GlazeColorInput, type GlazeColorToken, type GlazeConfig, type GlazeCssOptions, type GlazeCssResult, type GlazeExtendOptions, 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 RegularColorDef, type RelativeValue, type ResolvedColor, type ResolvedColorVariant, type ShadowColorDef, type ShadowTuning, contrastRatioFromLuminance, findLightnessForContrast, findValueForMixContrast, formatHsl, formatOkhsl, formatOklch, formatRgb, gamutClampedLuminance, glaze, okhslToLinearSrgb, okhslToOklab, okhslToSrgb, parseHex, relativeLuminanceFromLinearRgb, resolveMinContrast, srgbToOkhsl };
 //# sourceMappingURL=index.d.mts.map