@tenphi/glaze 0.0.0-snapshot.4e8eab7 → 0.0.0-snapshot.52e0dd6

package/dist/index.d.cts

@@ -26,6 +26,12 @@ interface FindLightnessForContrastOptions {
   epsilon?: number;
   /** Maximum binary-search iterations per branch. Default: 14. */
   maxIterations?: number;
+  /**
+   * When both branches fail to meet contrast, try flipping
+   * the lightness around the center of the search range.
+   * Default: false (no flip). Set true for auto-flip behavior.
+   */
+  flip?: boolean;
 }
 interface FindLightnessForContrastResult {
   /** Chosen lightness in 0–1. */
@@ -36,6 +42,8 @@ interface FindLightnessForContrastResult {
   met: boolean;
   /** Which branch was selected. */
   branch: 'lighter' | 'darker' | 'preferred';
+  /** Whether the result was auto-flipped to the opposite direction. */
+  flipped?: boolean;
 }
 declare function resolveMinContrast(value: MinContrast$1): number;
 /**
@@ -62,6 +70,12 @@ interface FindValueForMixContrastOptions {
   epsilon?: number;
   /** Maximum binary-search iterations per branch. Default: 20. */
   maxIterations?: number;
+  /**
+   * When both branches fail to meet contrast, try flipping
+   * the mix value around the center of [0, 1].
+   * Default: false (no flip). Set true for auto-flip behavior.
+   */
+  flip?: boolean;
 }
 interface FindValueForMixContrastResult {
   /** Chosen mix parameter (0–1). */
@@ -70,6 +84,8 @@ interface FindValueForMixContrastResult {
   contrast: number;
   /** Whether the target was reached. */
   met: boolean;
+  /** Whether the result was auto-flipped to the opposite direction. */
+  flipped?: boolean;
 }
 /**
  * Find the mix parameter (ratio or opacity) that satisfies a WCAG 2 contrast
@@ -273,6 +289,18 @@ interface GlazeConfig {
   modes?: GlazeOutputModes;
   /** Default tuning for all shadow colors. Per-color tuning merges field-by-field. */
   shadowTuning?: ShadowTuning;
+  /**
+   * Automatically flip lightness direction when contrast can't be met.
+   *
+   * When enabled (default `true`), if the preferred branch (e.g., darker
+   * than base) cannot reach the target contrast, the solver tries the
+   * opposite direction (lighter). Falls back to a warning if neither side
+   * works.
+   *
+   * Set to `false` for strict "no flip" behavior that always warns on
+   * unmet contrast and uses the best partial result without flipping.
+   */
+  autoFlip?: boolean;
 }
 interface GlazeConfigResolved {
   lightLightness: [number, number];
@@ -285,6 +313,7 @@ interface GlazeConfigResolved {
   };
   modes: Required<GlazeOutputModes>;
   shadowTuning?: ShadowTuning;
+  autoFlip: boolean;
 }
 /** Serialized theme configuration (no resolved values). */
 interface GlazeThemeExport {
@@ -528,6 +557,13 @@ interface GlazeColorTokenExport {
   overrides?: GlazeColorOverridesExport;
   /** Lightness scaling override, if any. */
   scaling?: GlazeColorScaling;
+  /**
+   * Auto-flip setting snapshotted at creation time from
+   * `globalConfig.autoFlip`. Only present when it differs from the
+   * global default (`true`). Rehydrated tokens use this value instead
+   * of whatever is current in `globalConfig`.
+   */
+  autoFlip?: boolean;
 }
 /**
  * Serializable shape of a structured `glaze.color({...})` input.
@@ -721,14 +757,7 @@ declare function glaze(hueOrOptions: number | {
 }, saturation?: number): GlazeTheme;
 declare namespace glaze {
   var configure: (config: GlazeConfig) => void;
-  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 & GlazePaletteExportOptions): GlazeCssResult;
-  };
+  var palette: (themes: PaletteInput, options?: GlazePaletteOptions) => GlazePalette;
   var from: (data: GlazeThemeExport) => GlazeTheme;
   var color: {
     (input: GlazeColorInput, scaling?: GlazeColorScaling): GlazeColorToken;

package/dist/index.d.mts

@@ -26,6 +26,12 @@ interface FindLightnessForContrastOptions {
   epsilon?: number;
   /** Maximum binary-search iterations per branch. Default: 14. */
   maxIterations?: number;
+  /**
+   * When both branches fail to meet contrast, try flipping
+   * the lightness around the center of the search range.
+   * Default: false (no flip). Set true for auto-flip behavior.
+   */
+  flip?: boolean;
 }
 interface FindLightnessForContrastResult {
   /** Chosen lightness in 0–1. */
@@ -36,6 +42,8 @@ interface FindLightnessForContrastResult {
   met: boolean;
   /** Which branch was selected. */
   branch: 'lighter' | 'darker' | 'preferred';
+  /** Whether the result was auto-flipped to the opposite direction. */
+  flipped?: boolean;
 }
 declare function resolveMinContrast(value: MinContrast$1): number;
 /**
@@ -62,6 +70,12 @@ interface FindValueForMixContrastOptions {
   epsilon?: number;
   /** Maximum binary-search iterations per branch. Default: 20. */
   maxIterations?: number;
+  /**
+   * When both branches fail to meet contrast, try flipping
+   * the mix value around the center of [0, 1].
+   * Default: false (no flip). Set true for auto-flip behavior.
+   */
+  flip?: boolean;
 }
 interface FindValueForMixContrastResult {
   /** Chosen mix parameter (0–1). */
@@ -70,6 +84,8 @@ interface FindValueForMixContrastResult {
   contrast: number;
   /** Whether the target was reached. */
   met: boolean;
+  /** Whether the result was auto-flipped to the opposite direction. */
+  flipped?: boolean;
 }
 /**
  * Find the mix parameter (ratio or opacity) that satisfies a WCAG 2 contrast
@@ -273,6 +289,18 @@ interface GlazeConfig {
   modes?: GlazeOutputModes;
   /** Default tuning for all shadow colors. Per-color tuning merges field-by-field. */
   shadowTuning?: ShadowTuning;
+  /**
+   * Automatically flip lightness direction when contrast can't be met.
+   *
+   * When enabled (default `true`), if the preferred branch (e.g., darker
+   * than base) cannot reach the target contrast, the solver tries the
+   * opposite direction (lighter). Falls back to a warning if neither side
+   * works.
+   *
+   * Set to `false` for strict "no flip" behavior that always warns on
+   * unmet contrast and uses the best partial result without flipping.
+   */
+  autoFlip?: boolean;
 }
 interface GlazeConfigResolved {
   lightLightness: [number, number];
@@ -285,6 +313,7 @@ interface GlazeConfigResolved {
   };
   modes: Required<GlazeOutputModes>;
   shadowTuning?: ShadowTuning;
+  autoFlip: boolean;
 }
 /** Serialized theme configuration (no resolved values). */
 interface GlazeThemeExport {
@@ -528,6 +557,13 @@ interface GlazeColorTokenExport {
   overrides?: GlazeColorOverridesExport;
   /** Lightness scaling override, if any. */
   scaling?: GlazeColorScaling;
+  /**
+   * Auto-flip setting snapshotted at creation time from
+   * `globalConfig.autoFlip`. Only present when it differs from the
+   * global default (`true`). Rehydrated tokens use this value instead
+   * of whatever is current in `globalConfig`.
+   */
+  autoFlip?: boolean;
 }
 /**
  * Serializable shape of a structured `glaze.color({...})` input.
@@ -721,14 +757,7 @@ declare function glaze(hueOrOptions: number | {
 }, saturation?: number): GlazeTheme;
 declare namespace glaze {
   var configure: (config: GlazeConfig) => void;
-  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 & GlazePaletteExportOptions): GlazeCssResult;
-  };
+  var palette: (themes: PaletteInput, options?: GlazePaletteOptions) => GlazePalette;
   var from: (data: GlazeThemeExport) => GlazeTheme;
   var color: {
     (input: GlazeColorInput, scaling?: GlazeColorScaling): GlazeColorToken;