@tenphi/glaze 0.16.1 → 0.17.0

package/dist/index.d.cts

@@ -248,7 +248,7 @@ interface RegularColorDef {
    * Defaults to the global `autoFlip` config (default `true`). Set `false`
    * to clamp instead.
    */
-  flip?: boolean;
+  autoFlip?: boolean;
   /**
    * Fixed opacity (0–1).
    * Output includes alpha in the CSS value.
@@ -565,7 +565,7 @@ interface GlazeColorInput {
   saturationFactor?: number;
   mode?: AdaptationMode;
   /** Flip out-of-bounds results instead of clamping. Default: global `autoFlip`. */
-  flip?: boolean;
+  autoFlip?: boolean;
   /**
    * Fixed opacity (0–1). Output includes alpha in the CSS value.
    * Combining with `contrast` is not recommended (perceived tone
@@ -660,7 +660,7 @@ interface GlazeColorOverrides {
    * `contrast`) to the opposite side instead of clamping. Defaults to
    * the global `autoFlip`.
    */
-  flip?: boolean;
+  autoFlip?: boolean;
   /**
    * Contrast floor. By default solved against the literal seed
    * (the value itself); when `base` is set, solved against the base's
@@ -739,7 +739,7 @@ interface GlazeColorCssOptions {
    * `name: 'brand'` → `--brand-color: …`.
    */
   name: string;
-  /** Output color format. Default: 'rgb' (matches `theme.css` default). */
+  /** Output color format. Default: 'oklch'. */
   format?: GlazeColorFormat;
   /**
    * Suffix appended to the name. Default: '-color' (matches
@@ -832,7 +832,7 @@ interface GlazeColorInputExport {
   tone: HCPair<number | ExtremeValue>;
   saturationFactor?: number;
   mode?: AdaptationMode;
-  flip?: boolean;
+  autoFlip?: boolean;
   opacity?: number;
   base?: GlazeColorTokenExport | GlazeColorValue;
   contrast?: HCPair<ContrastSpec>;
@@ -850,7 +850,7 @@ interface GlazeColorOverridesExport {
   tone?: HCPair<ToneValue>;
   saturationFactor?: number;
   mode?: AdaptationMode;
-  flip?: boolean;
+  autoFlip?: boolean;
   contrast?: HCPair<ContrastSpec>;
   base?: GlazeColorTokenExport | GlazeColorValue;
   opacity?: number;
@@ -944,7 +944,7 @@ interface GlazeTokenOptions {
   };
   /** Override which scheme variants to include. */
   modes?: GlazeOutputModes;
-  /** Output color format. Default: 'okhsl'. */
+  /** Output color format. Default: 'oklch'. */
   format?: GlazeColorFormat;
   /**
    * Emit hue as a separate custom property, referenced via `var()`.
@@ -960,11 +960,11 @@ interface GlazeTokenOptions {
 interface GlazeJsonOptions {
   /** Override which scheme variants to include. */
   modes?: GlazeOutputModes;
-  /** Output color format. Default: 'okhsl'. */
+  /** Output color format. Default: 'oklch'. */
   format?: GlazeColorFormat;
 }
 interface GlazeCssOptions {
-  /** Output color format. Default: 'rgb'. */
+  /** Output color format. Default: 'oklch'. */
   format?: GlazeColorFormat;
   /** Suffix appended to each CSS custom property name. Default: '-color'. */
   suffix?: string;

package/dist/index.d.mts

@@ -248,7 +248,7 @@ interface RegularColorDef {
    * Defaults to the global `autoFlip` config (default `true`). Set `false`
    * to clamp instead.
    */
-  flip?: boolean;
+  autoFlip?: boolean;
   /**
    * Fixed opacity (0–1).
    * Output includes alpha in the CSS value.
@@ -565,7 +565,7 @@ interface GlazeColorInput {
   saturationFactor?: number;
   mode?: AdaptationMode;
   /** Flip out-of-bounds results instead of clamping. Default: global `autoFlip`. */
-  flip?: boolean;
+  autoFlip?: boolean;
   /**
    * Fixed opacity (0–1). Output includes alpha in the CSS value.
    * Combining with `contrast` is not recommended (perceived tone
@@ -660,7 +660,7 @@ interface GlazeColorOverrides {
    * `contrast`) to the opposite side instead of clamping. Defaults to
    * the global `autoFlip`.
    */
-  flip?: boolean;
+  autoFlip?: boolean;
   /**
    * Contrast floor. By default solved against the literal seed
    * (the value itself); when `base` is set, solved against the base's
@@ -739,7 +739,7 @@ interface GlazeColorCssOptions {
    * `name: 'brand'` → `--brand-color: …`.
    */
   name: string;
-  /** Output color format. Default: 'rgb' (matches `theme.css` default). */
+  /** Output color format. Default: 'oklch'. */
   format?: GlazeColorFormat;
   /**
    * Suffix appended to the name. Default: '-color' (matches
@@ -832,7 +832,7 @@ interface GlazeColorInputExport {
   tone: HCPair<number | ExtremeValue>;
   saturationFactor?: number;
   mode?: AdaptationMode;
-  flip?: boolean;
+  autoFlip?: boolean;
   opacity?: number;
   base?: GlazeColorTokenExport | GlazeColorValue;
   contrast?: HCPair<ContrastSpec>;
@@ -850,7 +850,7 @@ interface GlazeColorOverridesExport {
   tone?: HCPair<ToneValue>;
   saturationFactor?: number;
   mode?: AdaptationMode;
-  flip?: boolean;
+  autoFlip?: boolean;
   contrast?: HCPair<ContrastSpec>;
   base?: GlazeColorTokenExport | GlazeColorValue;
   opacity?: number;
@@ -944,7 +944,7 @@ interface GlazeTokenOptions {
   };
   /** Override which scheme variants to include. */
   modes?: GlazeOutputModes;
-  /** Output color format. Default: 'okhsl'. */
+  /** Output color format. Default: 'oklch'. */
   format?: GlazeColorFormat;
   /**
    * Emit hue as a separate custom property, referenced via `var()`.
@@ -960,11 +960,11 @@ interface GlazeTokenOptions {
 interface GlazeJsonOptions {
   /** Override which scheme variants to include. */
   modes?: GlazeOutputModes;
-  /** Output color format. Default: 'okhsl'. */
+  /** Output color format. Default: 'oklch'. */
   format?: GlazeColorFormat;
 }
 interface GlazeCssOptions {
-  /** Output color format. Default: 'rgb'. */
+  /** Output color format. Default: 'oklch'. */
   format?: GlazeColorFormat;
   /** Suffix appended to each CSS custom property name. Default: '-color'. */
   suffix?: string;

package/dist/index.mjs

@@ -1853,7 +1853,7 @@ function resolveDependentColor(name, def, ctx, isHighContrast, isDark, effective
 	if (!baseResolved) throw new Error(`glaze: base "${baseName}" not yet resolved for "${name}".`);
 	const mode = def.mode ?? "auto";
 	const satFactor = clamp(def.saturation ?? 1, 0, 1);
-	const flip = def.flip ?? ctx.config.autoFlip;
+	const flip = def.autoFlip ?? ctx.config.autoFlip;
 	const pastel = effectivePastel;
 	const baseVariant = getSchemeVariant(baseResolved, isDark, isHighContrast);
 	const baseTone = baseVariant.t * 100;
@@ -2284,7 +2284,7 @@ const formatters = {
 function fmt(value, decimals) {
 	return parseFloat(value.toFixed(decimals)).toString();
 }
-function formatVariant(v, format = "okhsl", pastel = false) {
+function formatVariant(v, format = "oklch", pastel = false) {
 	const effectivePastel = v.pastel ?? pastel;
 	let base;
 	if (format === "okhst") base = formatOkhst(v.h, v.s * 100, v.t * 100, effectivePastel);
@@ -2323,7 +2323,7 @@ function resolveModes(override) {
 		highContrast: override?.highContrast ?? cfg.modes.highContrast
 	};
 }
-function buildTokenMap(resolved, prefix, states, modes, format = "okhsl", pastel = false, channelCtx) {
+function buildTokenMap(resolved, prefix, states, modes, format = "oklch", pastel = false, channelCtx) {
 	const tokens = {};
 	const huePlans = channelCtx !== void 0 && format === "oklch" ? buildHuePlans(resolved, channelCtx) : void 0;
 	if (huePlans !== void 0 && channelCtx !== void 0) {
@@ -2353,7 +2353,7 @@ function buildTokenEntry(color, states, modes, format, pastel, huePlan) {
 	if (modes.dark && modes.highContrast) entry[`${states.dark} & ${states.highContrast}`] = formatColorValue(color.darkContrast, format, pastel, huePlan);
 	return entry;
 }
-function buildFlatTokenMap(resolved, prefix, modes, format = "okhsl", pastel = false) {
+function buildFlatTokenMap(resolved, prefix, modes, format = "oklch", pastel = false) {
 	const result = { light: {} };
 	if (modes.dark) result.dark = {};
 	if (modes.highContrast) result.lightContrast = {};
@@ -2367,7 +2367,7 @@ function buildFlatTokenMap(resolved, prefix, modes, format = "okhsl", pastel = f
 	}
 	return result;
 }
-function buildJsonMap(resolved, modes, format = "okhsl", pastel = false) {
+function buildJsonMap(resolved, modes, format = "oklch", pastel = false) {
 	const result = {};
 	for (const [name, color] of resolved) {
 		const entry = { light: formatVariant(color.light, format, pastel) };
@@ -2930,7 +2930,7 @@ function buildStandaloneValueDefs(main, options) {
 		tone: toneOption ?? seedTone,
 		contrast: options?.contrast,
 		mode: options?.mode ?? "auto",
-		flip: options?.flip,
+		autoFlip: options?.autoFlip,
 		opacity: options?.opacity,
 		pastel: options?.pastel,
 		role: options?.role,
@@ -2965,7 +2965,7 @@ function createColorTokenFromDefs(seedHue, seedSaturation, defs, primary, effect
 		};
 	};
 	const tokenLike = (options) => {
-		return buildTokenMap(resolveOnce(), "", resolveStates(options), resolveModes(options?.modes), options?.format, effectiveConfig.pastel)[`#${primary}`];
+		return buildTokenMap(resolveOnce(), "", resolveStates(options), resolveModes(options?.modes), options?.format ?? "oklch", effectiveConfig.pastel)[`#${primary}`];
 	};
 	return {
 		resolve() {
@@ -2979,7 +2979,7 @@ function createColorTokenFromDefs(seedHue, seedSaturation, defs, primary, effect
 			return buildJsonMap(resolveOnce(), resolveModes(options?.modes), format, effectiveConfig.pastel)[primary];
 		},
 		css(options) {
-			const format = options.format ?? "rgb";
+			const format = options.format ?? "oklch";
 			assertNativeFormat(format, "css");
 			const resolved = resolveOnce().get(primary);
 			const renamed = new Map([[options.name, resolved]]);
@@ -3072,7 +3072,7 @@ function createColorToken(input, configOverride) {
 		tone: input.tone,
 		saturation: input.saturationFactor,
 		mode: input.mode ?? "auto",
-		flip: input.flip,
+		autoFlip: input.autoFlip,
 		contrast: input.contrast,
 		opacity: input.opacity,
 		pastel: input.pastel,
@@ -3122,7 +3122,7 @@ function buildOverridesExport(options) {
 	if (options.tone !== void 0) out.tone = options.tone;
 	if (options.saturationFactor !== void 0) out.saturationFactor = options.saturationFactor;
 	if (options.mode !== void 0) out.mode = options.mode;
-	if (options.flip !== void 0) out.flip = options.flip;
+	if (options.autoFlip !== void 0) out.autoFlip = options.autoFlip;
 	if (options.contrast !== void 0) out.contrast = options.contrast;
 	if (options.opacity !== void 0) out.opacity = options.opacity;
 	if (options.name !== void 0) out.name = options.name;
@@ -3139,7 +3139,7 @@ function buildStructuredInputExport(input) {
 	};
 	if (input.saturationFactor !== void 0) out.saturationFactor = input.saturationFactor;
 	if (input.mode !== void 0) out.mode = input.mode;
-	if (input.flip !== void 0) out.flip = input.flip;
+	if (input.autoFlip !== void 0) out.autoFlip = input.autoFlip;
 	if (input.opacity !== void 0) out.opacity = input.opacity;
 	if (input.contrast !== void 0) out.contrast = input.contrast;
 	if (input.name !== void 0) out.name = input.name;
@@ -3161,7 +3161,7 @@ function rehydrateOverrides(data) {
 	if (data.tone !== void 0) out.tone = data.tone;
 	if (data.saturationFactor !== void 0) out.saturationFactor = data.saturationFactor;
 	if (data.mode !== void 0) out.mode = data.mode;
-	if (data.flip !== void 0) out.flip = data.flip;
+	if (data.autoFlip !== void 0) out.autoFlip = data.autoFlip;
 	if (data.contrast !== void 0) out.contrast = data.contrast;
 	if (data.opacity !== void 0) out.opacity = data.opacity;
 	if (data.name !== void 0) out.name = data.name;
@@ -3178,7 +3178,7 @@ function rehydrateStructuredInput(data) {
 	};
 	if (data.saturationFactor !== void 0) out.saturationFactor = data.saturationFactor;
 	if (data.mode !== void 0) out.mode = data.mode;
-	if (data.flip !== void 0) out.flip = data.flip;
+	if (data.autoFlip !== void 0) out.autoFlip = data.autoFlip;
 	if (data.opacity !== void 0) out.opacity = data.opacity;
 	if (data.contrast !== void 0) out.contrast = data.contrast;
 	if (data.name !== void 0) out.name = data.name;
@@ -3316,7 +3316,7 @@ function createPalette(themes, paletteOptions) {
 				highContrast: options?.states?.highContrast ?? cfg.states.highContrast
 			};
 			const modes = resolveModes(options?.modes);
-			const format = options?.format ?? "okhsl";
+			const format = options?.format ?? "oklch";
 			return buildPaletteOutput(themes, paletteOptions, options, (filtered, prefix, pastel, themeName, theme) => {
 				return buildTokenMap(filtered, prefix, states, modes, format, pastel, channelCtxForTheme(theme, themeName, prefix, resolvePrefix(options, themeName, true), options?.splitHue, format, modes, filtered));
 			}, (acc, part) => Object.assign(acc, part), () => ({}));
@@ -3331,7 +3331,7 @@ function createPalette(themes, paletteOptions) {
 		},
 		css(options) {
 			const suffix = options?.suffix ?? "-color";
-			const format = options?.format ?? "rgb";
+			const format = options?.format ?? "oklch";
 			assertNativeFormat(format, "css");
 			const modes = resolveModes();
 			const lines = buildPaletteOutput(themes, paletteOptions, options, (filtered, prefix, pastel, themeName, theme) => {
@@ -3498,8 +3498,8 @@ function createTheme(hue, saturation, initialColors, configOverride) {
 				highContrast: options?.states?.highContrast ?? cfg.states.highContrast
 			};
 			const modes = resolveModes(options?.modes);
-			const format = options?.format ?? "okhsl";
-			const channelCtx = channelCtxFor(options, "okhsl", "");
+			const format = options?.format ?? "oklch";
+			const channelCtx = channelCtxFor(options, "oklch", "");
 			return buildTokenMap(resolveCached(), "", states, modes, format, cfg.pastel, channelCtx);
 		},
 		json(options) {
@@ -3509,9 +3509,9 @@ function createTheme(hue, saturation, initialColors, configOverride) {
 			return buildJsonMap(resolveCached(), modes, format, getEffectiveConfig().pastel);
 		},
 		css(options) {
-			const format = options?.format ?? "rgb";
+			const format = options?.format ?? "oklch";
 			assertNativeFormat(format, "css");
-			const channelCtx = channelCtxFor(options, "rgb", "");
+			const channelCtx = channelCtxFor(options, "oklch", "");
 			return buildCssMap(resolveCached(), "", options?.suffix ?? "-color", format, getEffectiveConfig().pastel, channelCtx);
 		},
 		dtcg(options) {