@tenphi/glaze 0.11.1 → 0.12.0

package/dist/index.d.cts

@@ -26,6 +26,30 @@ interface FindLightnessForContrastOptions {
   epsilon?: number;
   /** Maximum binary-search iterations per branch. Default: 14. */
   maxIterations?: number;
+  /**
+   * Preferred search direction before auto-flip is considered.
+   *
+   * Theme resolution sets this from the requested lightness relative to
+   * the base color so `autoFlip: false` preserves the authored direction.
+   * When omitted, the solver falls back to the side whose extreme has
+   * higher contrast against the base.
+   */
+  initialDirection?: 'lighter' | 'darker';
+  /**
+   * Auto-flip lightness direction when contrast can't be met.
+   *
+   * When `true`, the solver searches the initial direction first. If that side
+   * doesn't reach the target, it tries the opposite direction and
+   * uses it when it passes. If neither side passes, it returns the
+   * extreme lightness of the initial direction.
+   *
+   * When `false`, only the initial direction is considered. If it
+   * doesn't reach the target, the result is pinned to the initial
+   * direction's extreme — never to the original preferred lightness.
+   *
+   * Default: false.
+   */
+  flip?: boolean;
 }
 interface FindLightnessForContrastResult {
   /** Chosen lightness in 0–1. */
@@ -36,6 +60,12 @@ interface FindLightnessForContrastResult {
   met: boolean;
   /** Which branch was selected. */
   branch: 'lighter' | 'darker' | 'preferred';
+  /**
+   * Whether the result was auto-flipped to the opposite direction.
+   * Only set when the initial direction failed and the opposite
+   * direction satisfied the target.
+   */
+  flipped?: boolean;
 }
 declare function resolveMinContrast(value: MinContrast$1): number;
 /**
@@ -62,6 +92,22 @@ interface FindValueForMixContrastOptions {
   epsilon?: number;
   /** Maximum binary-search iterations per branch. Default: 20. */
   maxIterations?: number;
+  /**
+   * Auto-flip mix direction when contrast can't be met.
+   *
+   * When `true`, the solver searches the initial direction first
+   * (the side whose extreme has higher contrast against the base).
+   * If that side doesn't reach the target, it tries the opposite
+   * direction and uses it when it passes. If neither side passes,
+   * it returns the extreme mix value of the initial direction.
+   *
+   * When `false`, only the initial direction is considered. If it
+   * doesn't reach the target, the result is pinned to the initial
+   * direction's extreme — never to the original preferred value.
+   *
+   * Default: false.
+   */
+  flip?: boolean;
 }
 interface FindValueForMixContrastResult {
   /** Chosen mix parameter (0–1). */
@@ -70,6 +116,12 @@ interface FindValueForMixContrastResult {
   contrast: number;
   /** Whether the target was reached. */
   met: boolean;
+  /**
+   * Whether the result was auto-flipped to the opposite direction.
+   * Only set when the initial direction failed and the opposite
+   * direction satisfied the target.
+   */
+  flipped?: boolean;
 }
 /**
  * Find the mix parameter (ratio or opacity) that satisfies a WCAG 2 contrast
@@ -104,6 +156,18 @@ interface OkhslColor {
   s: number;
   l: number;
 }
+/** sRGB components in 0–255 (value-shorthand object form). */
+interface RgbColor {
+  r: number;
+  g: number;
+  b: number;
+}
+/** OKLCh components matching CSS `oklch(L C H)` (L/C: 0–1, H: degrees). */
+interface OklchColor {
+  l: number;
+  c: number;
+  h: number;
+}
 interface RegularColorDef {
   /**
    * Lightness value (0–100).
@@ -273,6 +337,21 @@ 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`), the solver searches the requested
+   * lightness direction first. If that direction can't reach the target,
+   * it tries the opposite direction and uses it when it passes. If neither
+   * side passes, the lightness is pinned to the requested-direction
+   * extreme and a warning is emitted.
+   *
+   * Set to `false` for strict "no flip" behavior. The opposite
+   * direction is never considered: if the requested direction can't
+   * meet the target, the lightness is pinned to its extreme (never
+   * falls back to the originally requested lightness).
+   */
+  autoFlip?: boolean;
 }
 interface GlazeConfigResolved {
   lightLightness: [number, number];
@@ -285,6 +364,7 @@ interface GlazeConfigResolved {
   };
   modes: Required<GlazeOutputModes>;
   shadowTuning?: ShadowTuning;
+  autoFlip: boolean;
 }
 /** Serialized theme configuration (no resolved values). */
 interface GlazeThemeExport {
@@ -297,8 +377,8 @@ interface GlazeShadowInput {
   /**
    * Background color — accepts any `GlazeColorValue` form: hex
    * (`#rgb` / `#rrggbb` / `#rrggbbaa`), `rgb()` / `hsl()` / `okhsl()`
-   * / `oklch()` strings, an `OkhslColor` object, or an `[r, g, b]`
-   * (0–255) tuple. Alpha components are dropped with a warning.
+   * / `oklch()` strings, or literal objects (`{ r, g, b }`, `{ h, s, l }`,
+   * `{ l, c, h }`). Alpha components are dropped with a warning.
    */
   bg: GlazeColorValue;
   /**
@@ -349,14 +429,13 @@ interface GlazeColorInput {
  * `rgb()`, `hsl()`, `okhsl()`, `oklch()` (alpha components also dropped
  * with a warning).
  *
- * The OKHSL object form `{ h, s, l }` matches Glaze's native shape
- * (h: 0–360, s/l: 0–1). Passing 0–100 values for `s`/`l` throws with
- * a hint to use the structured `{ hue, saturation, lightness }` form.
- *
- * The tuple form is `[r, g, b]` in 0–255, matching `glaze.fromRgb`'s
- * range. Out-of-range or non-finite components throw.
+ * Literal object forms:
+ * - `{ h, s, l }` — OKHSL (h: 0–360, s/l: 0–1). Passing 0–100 for `s`/`l`
+ *   throws with a hint to use the structured form.
+ * - `{ r, g, b }` — sRGB 0–255.
+ * - `{ l, c, h }` — OKLCh (L/C: 0–1, H: degrees), same as `oklch()` strings.
  */
-type GlazeColorValue = string | OkhslColor | readonly [number, number, number];
+type GlazeColorValue = string | OkhslColor | RgbColor | OklchColor;
 /** Optional overrides for `glaze.color(value, overrides?)`. */
 interface GlazeColorOverrides {
   /**
@@ -378,11 +457,11 @@ interface GlazeColorOverrides {
   /**
    * Adaptation mode. Defaults to `'auto'` for every input form, so
    * colors automatically adapt between light and dark like an ordinary
-   * theme color. The default *scaling* snapshot differs by input form:
-   * string inputs preserve their light lightness and extend the dark
-   * window to `[lo, 100]` (`#000` ↔ `#fff` flip), while `OkhslColor`
-   * and `[r, g, b]` tuple inputs snapshot the full `globalConfig.
-   * lightLightness` / `globalConfig.darkLightness` windows.
+   * theme color. All value-shorthand inputs (strings and literal objects)
+   * preserve light lightness (`lightLightness: false`) and snapshot
+   * `globalConfig.darkLightness` on the dark side. Only the structured
+   * `{ hue, saturation, lightness }` form also snapshots
+   * `globalConfig.lightLightness`.
    *
    * Pass `'fixed'` explicitly to opt back into the legacy linear, non-
    * inverting mapping; pass `'static'` to pin the same lightness
@@ -398,7 +477,7 @@ interface GlazeColorOverrides {
   /**
    * Optional dependency on another color. Accepts either a
    * `GlazeColorToken` (returned by another `glaze.color()`) or a raw
-   * `GlazeColorValue` (hex / `rgb()` / `OkhslColor` / `[r, g, b]`),
+   * `GlazeColorValue` (hex / CSS strings / `{ r, g, b }` / `{ h, s, l }` / …),
    * which is automatically wrapped in `glaze.color(value)`.
    *
    * When set:
@@ -436,17 +515,14 @@ interface GlazeColorOverrides {
  * `glaze.configure()` calls don't retroactively change already-created
  * tokens (and `token.export()` round-trips byte-for-byte):
  *
- * - **String inputs** (`'#1a1a1a'`, `'rgb(...)'`, `'okhsl(...)'`, ...):
+ * - **Value-shorthand** (hex / `rgb()` / `hsl()` / `okhsl()` / `oklch()`
+ *   strings, `{ r, g, b }`, `{ h, s, l }`, `{ l, c, h }`):
  *   - `lightLightness: false` — preserve input exactly.
- *   - `darkLightness: [globalConfig.darkLightness[0], 100]` — extended
- *     dark window so the auto-mode dark variant can Möbius-invert all
- *     the way up to white.
+ *   - `darkLightness: globalConfig.darkLightness` — snapshotted at create time.
  *
- * - **`OkhslColor` / `[r, g, b]` tuple / structured inputs**:
- *   - `lightLightness: globalConfig.lightLightness` — same light window
- *     theme colors use, snapshotted at create time.
- *   - `darkLightness: globalConfig.darkLightness` — same dark window
- *     theme colors use, snapshotted at create time.
+ * - **Structured inputs** (`{ hue, saturation, lightness, ... }`):
+ *   - `lightLightness: globalConfig.lightLightness` — theme light window.
+ *   - `darkLightness: globalConfig.darkLightness` — theme dark window.
  *
  * Passing this object replaces both fields at once. To keep one
  * field's default while overriding the other, restate the default
@@ -454,18 +530,16 @@ interface GlazeColorOverrides {
  */
 interface GlazeColorScaling {
   /**
-   * Light-mode lightness window. Snapshotted from `globalConfig` at
-   * create time: `false` (preserve input) for string inputs, plain
-   * `globalConfig.lightLightness` for object / tuple / structured
-   * inputs. Pass `false` to preserve input lightness in light mode.
+   * Light-mode lightness window. Snapshotted at create time: `false`
+   * (preserve input) for value-shorthand inputs; plain
+   * `globalConfig.lightLightness` for structured inputs only. Pass
+   * `false` to preserve input lightness in light mode.
    */
   lightLightness?: false | [number, number];
   /**
    * Dark-mode lightness window. Snapshotted from `globalConfig` at
-   * create time: extended `[globalConfig.darkLightness[0], 100]` for
-   * string inputs, plain `globalConfig.darkLightness` for object /
-   * tuple / structured inputs. Pass `false` to preserve input
-   * lightness in dark mode too.
+   * create time for value-shorthand and structured inputs. Pass `false`
+   * to preserve input lightness in dark mode too.
    */
   darkLightness?: false | [number, number];
 }
@@ -528,6 +602,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.
@@ -831,5 +912,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 FindValueForMixContrastOptions, type FindValueForMixContrastResult, type GlazeColorCssOptions, type GlazeColorFormat, type GlazeColorInput, type GlazeColorInputExport, type GlazeColorOverrides, type GlazeColorOverridesExport, type GlazeColorScaling, type GlazeColorToken, type GlazeColorTokenExport, type GlazeColorValue, 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, hslToSrgb, okhslToLinearSrgb, okhslToOklab, okhslToSrgb, oklabToOkhsl, parseHex, parseHexAlpha, relativeLuminanceFromLinearRgb, resolveMinContrast, srgbToOkhsl };
+export { type AdaptationMode, type ColorDef, type ColorMap, type ContrastPreset, type FindLightnessForContrastOptions, type FindLightnessForContrastResult, type FindValueForMixContrastOptions, type FindValueForMixContrastResult, type GlazeColorCssOptions, type GlazeColorFormat, type GlazeColorInput, type GlazeColorInputExport, type GlazeColorOverrides, type GlazeColorOverridesExport, type GlazeColorScaling, type GlazeColorToken, type GlazeColorTokenExport, type GlazeColorValue, 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 OklchColor, type RegularColorDef, type RelativeValue, type ResolvedColor, type ResolvedColorVariant, type RgbColor, type ShadowColorDef, type ShadowTuning, contrastRatioFromLuminance, findLightnessForContrast, findValueForMixContrast, formatHsl, formatOkhsl, formatOklch, formatRgb, gamutClampedLuminance, glaze, hslToSrgb, okhslToLinearSrgb, okhslToOklab, okhslToSrgb, oklabToOkhsl, parseHex, parseHexAlpha, relativeLuminanceFromLinearRgb, resolveMinContrast, srgbToOkhsl };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -26,6 +26,30 @@ interface FindLightnessForContrastOptions {
   epsilon?: number;
   /** Maximum binary-search iterations per branch. Default: 14. */
   maxIterations?: number;
+  /**
+   * Preferred search direction before auto-flip is considered.
+   *
+   * Theme resolution sets this from the requested lightness relative to
+   * the base color so `autoFlip: false` preserves the authored direction.
+   * When omitted, the solver falls back to the side whose extreme has
+   * higher contrast against the base.
+   */
+  initialDirection?: 'lighter' | 'darker';
+  /**
+   * Auto-flip lightness direction when contrast can't be met.
+   *
+   * When `true`, the solver searches the initial direction first. If that side
+   * doesn't reach the target, it tries the opposite direction and
+   * uses it when it passes. If neither side passes, it returns the
+   * extreme lightness of the initial direction.
+   *
+   * When `false`, only the initial direction is considered. If it
+   * doesn't reach the target, the result is pinned to the initial
+   * direction's extreme — never to the original preferred lightness.
+   *
+   * Default: false.
+   */
+  flip?: boolean;
 }
 interface FindLightnessForContrastResult {
   /** Chosen lightness in 0–1. */
@@ -36,6 +60,12 @@ interface FindLightnessForContrastResult {
   met: boolean;
   /** Which branch was selected. */
   branch: 'lighter' | 'darker' | 'preferred';
+  /**
+   * Whether the result was auto-flipped to the opposite direction.
+   * Only set when the initial direction failed and the opposite
+   * direction satisfied the target.
+   */
+  flipped?: boolean;
 }
 declare function resolveMinContrast(value: MinContrast$1): number;
 /**
@@ -62,6 +92,22 @@ interface FindValueForMixContrastOptions {
   epsilon?: number;
   /** Maximum binary-search iterations per branch. Default: 20. */
   maxIterations?: number;
+  /**
+   * Auto-flip mix direction when contrast can't be met.
+   *
+   * When `true`, the solver searches the initial direction first
+   * (the side whose extreme has higher contrast against the base).
+   * If that side doesn't reach the target, it tries the opposite
+   * direction and uses it when it passes. If neither side passes,
+   * it returns the extreme mix value of the initial direction.
+   *
+   * When `false`, only the initial direction is considered. If it
+   * doesn't reach the target, the result is pinned to the initial
+   * direction's extreme — never to the original preferred value.
+   *
+   * Default: false.
+   */
+  flip?: boolean;
 }
 interface FindValueForMixContrastResult {
   /** Chosen mix parameter (0–1). */
@@ -70,6 +116,12 @@ interface FindValueForMixContrastResult {
   contrast: number;
   /** Whether the target was reached. */
   met: boolean;
+  /**
+   * Whether the result was auto-flipped to the opposite direction.
+   * Only set when the initial direction failed and the opposite
+   * direction satisfied the target.
+   */
+  flipped?: boolean;
 }
 /**
  * Find the mix parameter (ratio or opacity) that satisfies a WCAG 2 contrast
@@ -104,6 +156,18 @@ interface OkhslColor {
   s: number;
   l: number;
 }
+/** sRGB components in 0–255 (value-shorthand object form). */
+interface RgbColor {
+  r: number;
+  g: number;
+  b: number;
+}
+/** OKLCh components matching CSS `oklch(L C H)` (L/C: 0–1, H: degrees). */
+interface OklchColor {
+  l: number;
+  c: number;
+  h: number;
+}
 interface RegularColorDef {
   /**
    * Lightness value (0–100).
@@ -273,6 +337,21 @@ 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`), the solver searches the requested
+   * lightness direction first. If that direction can't reach the target,
+   * it tries the opposite direction and uses it when it passes. If neither
+   * side passes, the lightness is pinned to the requested-direction
+   * extreme and a warning is emitted.
+   *
+   * Set to `false` for strict "no flip" behavior. The opposite
+   * direction is never considered: if the requested direction can't
+   * meet the target, the lightness is pinned to its extreme (never
+   * falls back to the originally requested lightness).
+   */
+  autoFlip?: boolean;
 }
 interface GlazeConfigResolved {
   lightLightness: [number, number];
@@ -285,6 +364,7 @@ interface GlazeConfigResolved {
   };
   modes: Required<GlazeOutputModes>;
   shadowTuning?: ShadowTuning;
+  autoFlip: boolean;
 }
 /** Serialized theme configuration (no resolved values). */
 interface GlazeThemeExport {
@@ -297,8 +377,8 @@ interface GlazeShadowInput {
   /**
    * Background color — accepts any `GlazeColorValue` form: hex
    * (`#rgb` / `#rrggbb` / `#rrggbbaa`), `rgb()` / `hsl()` / `okhsl()`
-   * / `oklch()` strings, an `OkhslColor` object, or an `[r, g, b]`
-   * (0–255) tuple. Alpha components are dropped with a warning.
+   * / `oklch()` strings, or literal objects (`{ r, g, b }`, `{ h, s, l }`,
+   * `{ l, c, h }`). Alpha components are dropped with a warning.
    */
   bg: GlazeColorValue;
   /**
@@ -349,14 +429,13 @@ interface GlazeColorInput {
  * `rgb()`, `hsl()`, `okhsl()`, `oklch()` (alpha components also dropped
  * with a warning).
  *
- * The OKHSL object form `{ h, s, l }` matches Glaze's native shape
- * (h: 0–360, s/l: 0–1). Passing 0–100 values for `s`/`l` throws with
- * a hint to use the structured `{ hue, saturation, lightness }` form.
- *
- * The tuple form is `[r, g, b]` in 0–255, matching `glaze.fromRgb`'s
- * range. Out-of-range or non-finite components throw.
+ * Literal object forms:
+ * - `{ h, s, l }` — OKHSL (h: 0–360, s/l: 0–1). Passing 0–100 for `s`/`l`
+ *   throws with a hint to use the structured form.
+ * - `{ r, g, b }` — sRGB 0–255.
+ * - `{ l, c, h }` — OKLCh (L/C: 0–1, H: degrees), same as `oklch()` strings.
  */
-type GlazeColorValue = string | OkhslColor | readonly [number, number, number];
+type GlazeColorValue = string | OkhslColor | RgbColor | OklchColor;
 /** Optional overrides for `glaze.color(value, overrides?)`. */
 interface GlazeColorOverrides {
   /**
@@ -378,11 +457,11 @@ interface GlazeColorOverrides {
   /**
    * Adaptation mode. Defaults to `'auto'` for every input form, so
    * colors automatically adapt between light and dark like an ordinary
-   * theme color. The default *scaling* snapshot differs by input form:
-   * string inputs preserve their light lightness and extend the dark
-   * window to `[lo, 100]` (`#000` ↔ `#fff` flip), while `OkhslColor`
-   * and `[r, g, b]` tuple inputs snapshot the full `globalConfig.
-   * lightLightness` / `globalConfig.darkLightness` windows.
+   * theme color. All value-shorthand inputs (strings and literal objects)
+   * preserve light lightness (`lightLightness: false`) and snapshot
+   * `globalConfig.darkLightness` on the dark side. Only the structured
+   * `{ hue, saturation, lightness }` form also snapshots
+   * `globalConfig.lightLightness`.
    *
    * Pass `'fixed'` explicitly to opt back into the legacy linear, non-
    * inverting mapping; pass `'static'` to pin the same lightness
@@ -398,7 +477,7 @@ interface GlazeColorOverrides {
   /**
    * Optional dependency on another color. Accepts either a
    * `GlazeColorToken` (returned by another `glaze.color()`) or a raw
-   * `GlazeColorValue` (hex / `rgb()` / `OkhslColor` / `[r, g, b]`),
+   * `GlazeColorValue` (hex / CSS strings / `{ r, g, b }` / `{ h, s, l }` / …),
    * which is automatically wrapped in `glaze.color(value)`.
    *
    * When set:
@@ -436,17 +515,14 @@ interface GlazeColorOverrides {
  * `glaze.configure()` calls don't retroactively change already-created
  * tokens (and `token.export()` round-trips byte-for-byte):
  *
- * - **String inputs** (`'#1a1a1a'`, `'rgb(...)'`, `'okhsl(...)'`, ...):
+ * - **Value-shorthand** (hex / `rgb()` / `hsl()` / `okhsl()` / `oklch()`
+ *   strings, `{ r, g, b }`, `{ h, s, l }`, `{ l, c, h }`):
  *   - `lightLightness: false` — preserve input exactly.
- *   - `darkLightness: [globalConfig.darkLightness[0], 100]` — extended
- *     dark window so the auto-mode dark variant can Möbius-invert all
- *     the way up to white.
+ *   - `darkLightness: globalConfig.darkLightness` — snapshotted at create time.
  *
- * - **`OkhslColor` / `[r, g, b]` tuple / structured inputs**:
- *   - `lightLightness: globalConfig.lightLightness` — same light window
- *     theme colors use, snapshotted at create time.
- *   - `darkLightness: globalConfig.darkLightness` — same dark window
- *     theme colors use, snapshotted at create time.
+ * - **Structured inputs** (`{ hue, saturation, lightness, ... }`):
+ *   - `lightLightness: globalConfig.lightLightness` — theme light window.
+ *   - `darkLightness: globalConfig.darkLightness` — theme dark window.
  *
  * Passing this object replaces both fields at once. To keep one
  * field's default while overriding the other, restate the default
@@ -454,18 +530,16 @@ interface GlazeColorOverrides {
  */
 interface GlazeColorScaling {
   /**
-   * Light-mode lightness window. Snapshotted from `globalConfig` at
-   * create time: `false` (preserve input) for string inputs, plain
-   * `globalConfig.lightLightness` for object / tuple / structured
-   * inputs. Pass `false` to preserve input lightness in light mode.
+   * Light-mode lightness window. Snapshotted at create time: `false`
+   * (preserve input) for value-shorthand inputs; plain
+   * `globalConfig.lightLightness` for structured inputs only. Pass
+   * `false` to preserve input lightness in light mode.
    */
   lightLightness?: false | [number, number];
   /**
    * Dark-mode lightness window. Snapshotted from `globalConfig` at
-   * create time: extended `[globalConfig.darkLightness[0], 100]` for
-   * string inputs, plain `globalConfig.darkLightness` for object /
-   * tuple / structured inputs. Pass `false` to preserve input
-   * lightness in dark mode too.
+   * create time for value-shorthand and structured inputs. Pass `false`
+   * to preserve input lightness in dark mode too.
    */
   darkLightness?: false | [number, number];
 }
@@ -528,6 +602,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.
@@ -831,5 +912,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 FindValueForMixContrastOptions, type FindValueForMixContrastResult, type GlazeColorCssOptions, type GlazeColorFormat, type GlazeColorInput, type GlazeColorInputExport, type GlazeColorOverrides, type GlazeColorOverridesExport, type GlazeColorScaling, type GlazeColorToken, type GlazeColorTokenExport, type GlazeColorValue, 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, hslToSrgb, okhslToLinearSrgb, okhslToOklab, okhslToSrgb, oklabToOkhsl, parseHex, parseHexAlpha, relativeLuminanceFromLinearRgb, resolveMinContrast, srgbToOkhsl };
+export { type AdaptationMode, type ColorDef, type ColorMap, type ContrastPreset, type FindLightnessForContrastOptions, type FindLightnessForContrastResult, type FindValueForMixContrastOptions, type FindValueForMixContrastResult, type GlazeColorCssOptions, type GlazeColorFormat, type GlazeColorInput, type GlazeColorInputExport, type GlazeColorOverrides, type GlazeColorOverridesExport, type GlazeColorScaling, type GlazeColorToken, type GlazeColorTokenExport, type GlazeColorValue, 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 OklchColor, type RegularColorDef, type RelativeValue, type ResolvedColor, type ResolvedColorVariant, type RgbColor, type ShadowColorDef, type ShadowTuning, contrastRatioFromLuminance, findLightnessForContrast, findValueForMixContrast, formatHsl, formatOkhsl, formatOklch, formatRgb, gamutClampedLuminance, glaze, hslToSrgb, okhslToLinearSrgb, okhslToOklab, okhslToSrgb, oklabToOkhsl, parseHex, parseHexAlpha, relativeLuminanceFromLinearRgb, resolveMinContrast, srgbToOkhsl };
 //# sourceMappingURL=index.d.mts.map