@number10/jsx-core 5.0.0

package/dist/colors/color-utils.cjs

@@ -0,0 +1,197 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const colorTypes = require("./color-types.cjs");
+function hexToNumber(hex) {
+  const cleaned = hex.replace("#", "");
+  return parseInt(cleaned, 16);
+}
+function numberToHex(num, withHash = true) {
+  const hex = normalizeColorNumber(num).toString(16).padStart(6, "0");
+  return withHash ? `#${hex}` : hex;
+}
+function normalizeColorNumber(color) {
+  if (!Number.isFinite(color)) return 0;
+  return Math.max(0, Math.round(color)) & 16777215;
+}
+function normalizeTextColor(color) {
+  if (color === void 0 || color === null) return void 0;
+  if (typeof color === "number") {
+    return numberToHex(normalizeColorNumber(color));
+  }
+  const trimmed = color.trim();
+  if (trimmed === "") return void 0;
+  if (/^0x[0-9a-fA-F]+$/.test(trimmed)) {
+    const num = parseInt(trimmed.slice(2), 16);
+    if (Number.isNaN(num)) return void 0;
+    return numberToHex(normalizeColorNumber(num));
+  }
+  if (/^#[0-9a-fA-F]{3}$/.test(trimmed)) {
+    const r = trimmed[1];
+    const g = trimmed[2];
+    const b = trimmed[3];
+    return `#${r}${r}${g}${g}${b}${b}`;
+  }
+  return trimmed;
+}
+function rgbToNumber(r, g, b) {
+  return (r & 255) << 16 | (g & 255) << 8 | b & 255;
+}
+function numberToRgb(num) {
+  const normalized = normalizeColorNumber(num);
+  return {
+    r: normalized >> 16 & 255,
+    g: normalized >> 8 & 255,
+    b: normalized & 255
+  };
+}
+function rgbToHsl(r, g, b) {
+  const red = r / 255;
+  const green = g / 255;
+  const blue = b / 255;
+  const max = Math.max(red, green, blue);
+  const min = Math.min(red, green, blue);
+  const delta = max - min;
+  const light = (max + min) / 2;
+  if (delta === 0) {
+    return { h: 0, s: 0, l: light };
+  }
+  const saturationValue = light > 0.5 ? delta / (2 - max - min) : delta / (max + min);
+  let hueValue;
+  if (max === red) {
+    hueValue = (green - blue) / delta + (green < blue ? 6 : 0);
+  } else if (max === green) {
+    hueValue = (blue - red) / delta + 2;
+  } else {
+    hueValue = (red - green) / delta + 4;
+  }
+  return { h: hueValue / 6, s: saturationValue, l: light };
+}
+function hslToRgb(h, s, l) {
+  const hue = ((Number.isFinite(h) ? h : 0) % 1 + 1) % 1;
+  const saturation = Math.max(0, Math.min(1, Number.isFinite(s) ? s : 0));
+  const lightness = Math.max(0, Math.min(1, Number.isFinite(l) ? l : 0));
+  if (saturation === 0) {
+    const value = Math.round(lightness * 255);
+    return { r: value, g: value, b: value };
+  }
+  const hueToRgb = (p2, q2, t) => {
+    let next = t;
+    if (next < 0) next += 1;
+    if (next > 1) next -= 1;
+    if (next < 1 / 6) return p2 + (q2 - p2) * 6 * next;
+    if (next < 1 / 2) return q2;
+    if (next < 2 / 3) return p2 + (q2 - p2) * (2 / 3 - next) * 6;
+    return p2;
+  };
+  const q = lightness < 0.5 ? lightness * (1 + saturation) : lightness + saturation - lightness * saturation;
+  const p = 2 * lightness - q;
+  return {
+    r: Math.round(hueToRgb(p, q, hue + 1 / 3) * 255),
+    g: Math.round(hueToRgb(p, q, hue) * 255),
+    b: Math.round(hueToRgb(p, q, hue - 1 / 3) * 255)
+  };
+}
+function hslToNumber(h, s, l) {
+  const rgb = hslToRgb(h, s, l);
+  return rgbToNumber(rgb.r, rgb.g, rgb.b);
+}
+function numberToHsl(color) {
+  const rgb = numberToRgb(color);
+  return rgbToHsl(rgb.r, rgb.g, rgb.b);
+}
+function lighten(color, amount) {
+  const rgb = numberToRgb(color);
+  const factor = Math.max(0, Math.min(1, amount));
+  const r = Math.round(rgb.r + (255 - rgb.r) * factor);
+  const g = Math.round(rgb.g + (255 - rgb.g) * factor);
+  const b = Math.round(rgb.b + (255 - rgb.b) * factor);
+  return rgbToNumber(r, g, b);
+}
+function darken(color, amount) {
+  const rgb = numberToRgb(color);
+  const factor = 1 - Math.max(0, Math.min(1, amount));
+  const r = Math.round(rgb.r * factor);
+  const g = Math.round(rgb.g * factor);
+  const b = Math.round(rgb.b * factor);
+  return rgbToNumber(r, g, b);
+}
+function lightenHex(hex, amount) {
+  const num = hexToNumber(hex);
+  const lightened = lighten(num, amount);
+  return colorTypes.HexColor.from(numberToHex(lightened));
+}
+function darkenHex(hex, amount) {
+  const num = hexToNumber(hex);
+  const darkened = darken(num, amount);
+  return colorTypes.HexColor.from(numberToHex(darkened));
+}
+function alpha(color, alphaValue = 1) {
+  const rgb = numberToRgb(color);
+  const a = Math.max(0, Math.min(1, alphaValue));
+  return `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, ${a})`;
+}
+function getLuminance(color) {
+  const rgb = numberToRgb(color);
+  const rsRGB = rgb.r / 255;
+  const gsRGB = rgb.g / 255;
+  const bsRGB = rgb.b / 255;
+  const r = rsRGB <= 0.03928 ? rsRGB / 12.92 : Math.pow((rsRGB + 0.055) / 1.055, 2.4);
+  const g = gsRGB <= 0.03928 ? gsRGB / 12.92 : Math.pow((gsRGB + 0.055) / 1.055, 2.4);
+  const b = bsRGB <= 0.03928 ? bsRGB / 12.92 : Math.pow((bsRGB + 0.055) / 1.055, 2.4);
+  return 0.2126 * r + 0.7152 * g + 0.0722 * b;
+}
+function getContrastRatio(foreground, background) {
+  const l1 = getLuminance(foreground);
+  const l2 = getLuminance(background);
+  const lighter = Math.max(l1, l2);
+  const darker = Math.min(l1, l2);
+  return (lighter + 0.05) / (darker + 0.05);
+}
+function ensureContrast(foreground, background, minRatio = 4.5) {
+  if (getContrastRatio(foreground, background) >= minRatio) {
+    return foreground;
+  }
+  const bgLuminance = getLuminance(background);
+  const shouldLighten = bgLuminance < 0.5;
+  let low = 0;
+  let high = 1;
+  while (high - low > 0.01) {
+    const mid = (low + high) / 2;
+    const adjusted = shouldLighten ? lighten(foreground, mid) : darken(foreground, mid);
+    if (getContrastRatio(adjusted, background) >= minRatio) {
+      high = mid;
+    } else {
+      low = mid;
+    }
+  }
+  return shouldLighten ? lighten(foreground, high) : darken(foreground, high);
+}
+function createTextStyle(baseStyle, overrides) {
+  const base = baseStyle ?? {};
+  return {
+    fontSize: overrides.fontSize ?? base.fontSize ?? "14px",
+    color: overrides.color ?? base.color ?? "#ffffff",
+    ...base.fontFamily && { fontFamily: base.fontFamily },
+    ...base.align && { align: base.align },
+    ...overrides
+  };
+}
+exports.alpha = alpha;
+exports.createTextStyle = createTextStyle;
+exports.darken = darken;
+exports.darkenHex = darkenHex;
+exports.ensureContrast = ensureContrast;
+exports.getContrastRatio = getContrastRatio;
+exports.hexToNumber = hexToNumber;
+exports.hslToNumber = hslToNumber;
+exports.hslToRgb = hslToRgb;
+exports.lighten = lighten;
+exports.lightenHex = lightenHex;
+exports.normalizeColorNumber = normalizeColorNumber;
+exports.normalizeTextColor = normalizeTextColor;
+exports.numberToHex = numberToHex;
+exports.numberToHsl = numberToHsl;
+exports.numberToRgb = numberToRgb;
+exports.rgbToHsl = rgbToHsl;
+exports.rgbToNumber = rgbToNumber;
+//# sourceMappingURL=color-utils.cjs.map

package/dist/colors/color-utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-utils.cjs","sources":["../../src/colors/color-utils.ts"],"sourcesContent":["/**\n * Color utility functions — renderer-neutral color math.\n * Provides conversion between formats and color manipulation.\n */\n\nimport type { TextStyleToken } from '../design-tokens/design-token-types'\nimport { HexColor, type RGBColor } from './color-types'\n\n/**\n * Convert hex string to Phaser number format\n * @param hex - Hex color string (e.g., '#ffffff' or 'ffffff')\n * @returns Phaser color number (e.g., 0xffffff)\n * @example\n * ```typescript\n * hexToNumber('#ff0000') // returns 0xff0000\n * hexToNumber('00ff00')  // returns 0x00ff00\n * ```\n */\nexport function hexToNumber(hex: string): number {\n  const cleaned = hex.replace('#', '')\n  return parseInt(cleaned, 16)\n}\n\n/**\n * Convert Phaser number format to hex string\n * @param num - Phaser color number (e.g., 0xffffff)\n * @param withHash - Include '#' prefix (default: true)\n * @returns Hex color string (e.g., '#ffffff')\n * @example\n * ```typescript\n * numberToHex(0xff0000)        // returns '#ff0000'\n * numberToHex(0x00ff00, false) // returns '00ff00'\n * ```\n */\nexport function numberToHex(num: number, withHash = true): string {\n  const hex = normalizeColorNumber(num).toString(16).padStart(6, '0')\n  return withHash ? `#${hex}` : hex\n}\n\n/**\n * Normalize a color number to Phaser's 0x000000-0xffffff RGB range.\n * @param color - Color number to normalize\n * @returns RGB color number in the 24-bit range\n */\nexport function normalizeColorNumber(color: number): number {\n  if (!Number.isFinite(color)) return 0x000000\n  return Math.max(0, Math.round(color)) & 0xffffff\n}\n\n/**\n * Normalize a text color value to a CSS-compatible hex string.\n *\n * Handles all common formats users might pass in JSX style.color:\n * - `0xff0000` (number) → `'#ff0000'`\n * - `'0xff0000'` (0x-prefixed string) → `'#ff0000'`\n * - `'0xf00'` (0x short string) → `'#ff0000'`\n * - `'#f00'` (short CSS hex) → `'#ff0000'`\n * - `'#ff0000'` (full CSS hex) → `'#ff0000'` (passthrough)\n * - `'red'`, `'yellow'` (CSS name) → passthrough unchanged\n * - `undefined` → `undefined`\n *\n * Both renderers (Phaser, Pixi) receive the same normalized value,\n * preventing inconsistent color rendering across renderers.\n *\n * @param color - Raw color value from style.color\n * @returns Normalized CSS hex string, CSS name, or undefined\n */\nexport function normalizeTextColor(color: string | number | undefined): string | undefined {\n  if (color === undefined || color === null) return undefined\n\n  // Number: convert to #rrggbb\n  if (typeof color === 'number') {\n    return numberToHex(normalizeColorNumber(color))\n  }\n\n  // String: detect and normalize 0x-prefixed hex strings\n  const trimmed = color.trim()\n  if (trimmed === '') return undefined\n\n  // '0xf00' or '0xff0000' → parse as hex, convert to #rrggbb\n  if (/^0x[0-9a-fA-F]+$/.test(trimmed)) {\n    const num = parseInt(trimmed.slice(2), 16)\n    if (Number.isNaN(num)) return undefined\n    return numberToHex(normalizeColorNumber(num))\n  }\n\n  // '#f00' → '#ff0000' (expand short CSS hex)\n  if (/^#[0-9a-fA-F]{3}$/.test(trimmed)) {\n    const r = trimmed[1]\n    const g = trimmed[2]\n    const b = trimmed[3]\n    return `#${r}${r}${g}${g}${b}${b}`\n  }\n\n  // Already clean '#ff0000' or CSS name like 'red' — passthrough\n  return trimmed\n}\n\n/**\n * Convert RGB values to Phaser number format\n * @param r - Red component (0-255)\n * @param g - Green component (0-255)\n * @param b - Blue component (0-255)\n * @returns Phaser color number\n * @example\n * ```typescript\n * rgbToNumber(255, 0, 0)     // returns 0xff0000 (red)\n * rgbToNumber(0, 255, 0)     // returns 0x00ff00 (green)\n * rgbToNumber(255, 255, 255) // returns 0xffffff (white)\n * ```\n */\nexport function rgbToNumber(r: number, g: number, b: number): number {\n  return ((r & 0xff) << 16) | ((g & 0xff) << 8) | (b & 0xff)\n}\n\n/**\n * Convert Phaser number to RGB components\n * @param num - Phaser color number\n * @returns RGB color object\n * @example\n * ```typescript\n * numberToRgb(0xff0000) // returns { r: 255, g: 0, b: 0 }\n * numberToRgb(0x00ff00) // returns { r: 0, g: 255, b: 0 }\n * ```\n */\nexport function numberToRgb(num: number): RGBColor {\n  const normalized = normalizeColorNumber(num)\n\n  return {\n    r: (normalized >> 16) & 0xff,\n    g: (normalized >> 8) & 0xff,\n    b: normalized & 0xff,\n  }\n}\n\n/**\n * HSL color representation\n */\nexport interface HSLColor {\n  /** Hue in normalized range (0.0 to 1.0) */\n  h: number\n  /** Saturation in normalized range (0.0 to 1.0) */\n  s: number\n  /** Lightness in normalized range (0.0 to 1.0) */\n  l: number\n}\n\n/**\n * Convert RGB values to HSL values (normalized 0.0 to 1.0)\n * @param r - Red component (0-255)\n * @param g - Green component (0-255)\n * @param b - Blue component (0-255)\n * @returns HSL color values with normalized components\n * @example\n * ```typescript\n * rgbToHsl(255, 0, 0) // returns { h: 0, s: 1, l: 0.5 }\n * rgbToHsl(0, 255, 0) // returns { h: 0.333..., s: 1, l: 0.5 }\n * ```\n */\nexport function rgbToHsl(r: number, g: number, b: number): HSLColor {\n  const red = r / 255\n  const green = g / 255\n  const blue = b / 255\n  const max = Math.max(red, green, blue)\n  const min = Math.min(red, green, blue)\n  const delta = max - min\n  const light = (max + min) / 2\n\n  if (delta === 0) {\n    return { h: 0, s: 0, l: light }\n  }\n\n  const saturationValue = light > 0.5 ? delta / (2 - max - min) : delta / (max + min)\n  let hueValue: number\n  if (max === red) {\n    hueValue = (green - blue) / delta + (green < blue ? 6 : 0)\n  } else if (max === green) {\n    hueValue = (blue - red) / delta + 2\n  } else {\n    hueValue = (red - green) / delta + 4\n  }\n  return { h: hueValue / 6, s: saturationValue, l: light }\n}\n\n/**\n * Convert normalized HSL values to RGB components.\n * @param h - Hue in normalized range (0.0 to 1.0)\n * @param s - Saturation in normalized range (0.0 to 1.0)\n * @param l - Lightness in normalized range (0.0 to 1.0)\n * @returns RGB color object\n */\nexport function hslToRgb(h: number, s: number, l: number): RGBColor {\n  const hue = (((Number.isFinite(h) ? h : 0) % 1) + 1) % 1\n  const saturation = Math.max(0, Math.min(1, Number.isFinite(s) ? s : 0))\n  const lightness = Math.max(0, Math.min(1, Number.isFinite(l) ? l : 0))\n\n  if (saturation === 0) {\n    const value = Math.round(lightness * 255)\n    return { r: value, g: value, b: value }\n  }\n\n  const hueToRgb = (p: number, q: number, t: number): number => {\n    let next = t\n    if (next < 0) next += 1\n    if (next > 1) next -= 1\n    if (next < 1 / 6) return p + (q - p) * 6 * next\n    if (next < 1 / 2) return q\n    if (next < 2 / 3) return p + (q - p) * (2 / 3 - next) * 6\n    return p\n  }\n\n  const q =\n    lightness < 0.5 ? lightness * (1 + saturation) : lightness + saturation - lightness * saturation\n  const p = 2 * lightness - q\n\n  return {\n    r: Math.round(hueToRgb(p, q, hue + 1 / 3) * 255),\n    g: Math.round(hueToRgb(p, q, hue) * 255),\n    b: Math.round(hueToRgb(p, q, hue - 1 / 3) * 255),\n  }\n}\n\n/**\n * Convert normalized HSL values to Phaser number format.\n * @param h - Hue in normalized range (0.0 to 1.0)\n * @param s - Saturation in normalized range (0.0 to 1.0)\n * @param l - Lightness in normalized range (0.0 to 1.0)\n * @returns Phaser color number\n */\nexport function hslToNumber(h: number, s: number, l: number): number {\n  const rgb = hslToRgb(h, s, l)\n  return rgbToNumber(rgb.r, rgb.g, rgb.b)\n}\n\n/**\n * Convert Phaser number format to normalized HSL values.\n * @param color - Phaser color number\n * @returns HSL color values with normalized components\n */\nexport function numberToHsl(color: number): HSLColor {\n  const rgb = numberToRgb(color)\n  return rgbToHsl(rgb.r, rgb.g, rgb.b)\n}\n\n/**\n * Lighten a color by a given amount\n * @param color - Phaser color number\n * @param amount - Amount to lighten (0.0 to 1.0, where 1.0 is white)\n * @returns Lightened color number\n * @example\n * ```typescript\n * lighten(0x0000ff, 0.3) // returns lighter blue\n * lighten(0xff0000, 0.5) // returns light red/pink\n * ```\n */\nexport function lighten(color: number, amount: number): number {\n  const rgb = numberToRgb(color)\n  const factor = Math.max(0, Math.min(1, amount))\n\n  const r = Math.round(rgb.r + (255 - rgb.r) * factor)\n  const g = Math.round(rgb.g + (255 - rgb.g) * factor)\n  const b = Math.round(rgb.b + (255 - rgb.b) * factor)\n\n  return rgbToNumber(r, g, b)\n}\n\n/**\n * Darken a color by a given amount\n * @param color - Phaser color number\n * @param amount - Amount to darken (0.0 to 1.0, where 1.0 is black)\n * @returns Darkened color number\n * @example\n * ```typescript\n * darken(0x0000ff, 0.3) // returns darker blue\n * darken(0xff0000, 0.5) // returns dark red\n * ```\n */\nexport function darken(color: number, amount: number): number {\n  const rgb = numberToRgb(color)\n  const factor = 1 - Math.max(0, Math.min(1, amount))\n\n  const r = Math.round(rgb.r * factor)\n  const g = Math.round(rgb.g * factor)\n  const b = Math.round(rgb.b * factor)\n\n  return rgbToNumber(r, g, b)\n}\n\n/**\n * Lighten a hex color by a given amount\n * @param hex - Hex color (e.g., '#ffffff' or 'ffffff')\n * @param amount - Amount to lighten (0.0 to 1.0, where 1.0 is white)\n * @returns Lightened hex color string with '#' prefix\n * @example\n * ```typescript\n * lightenHex('#0000ff', 0.3) // returns lighter blue\n * lightenHex('#ff0000', 0.5) // returns light red/pink\n * ```\n */\nexport function lightenHex(hex: string, amount: number): HexColor {\n  const num = hexToNumber(hex)\n  const lightened = lighten(num, amount)\n  return HexColor.from(numberToHex(lightened))\n}\n\n/**\n * Darken a hex color by a given amount\n * @param hex - Hex color (e.g., '#ffffff' or 'ffffff')\n * @param amount - Amount to darken (0.0 to 1.0, where 1.0 is black)\n * @returns Darkened hex color string with '#' prefix\n * @example\n * ```typescript\n * darkenHex('#0000ff', 0.3) // returns darker blue\n * darkenHex('#ff0000', 0.5) // returns dark red\n * ```\n */\nexport function darkenHex(hex: string, amount: number): HexColor {\n  const num = hexToNumber(hex)\n  const darkened = darken(num, amount)\n  return HexColor.from(numberToHex(darkened))\n}\n\n/**\n * Convert color to rgba string for Phaser Text style\n * @param color - Phaser color number\n * @param alphaValue - Alpha value (0.0 to 1.0, default: 1.0)\n * @returns RGBA string usable in Text style (e.g., 'rgba(255, 0, 0, 0.5)')\n * @example\n * ```typescript\n * alpha(0xff0000, 1.0)   // returns 'rgba(255, 0, 0, 1)'\n * alpha(0x00ff00, 0.5)   // returns 'rgba(0, 255, 0, 0.5)'\n * alpha(0x0000ff)        // returns 'rgba(0, 0, 255, 1)'\n * ```\n */\nexport function alpha(color: number, alphaValue = 1.0): string {\n  const rgb = numberToRgb(color)\n  const a = Math.max(0, Math.min(1, alphaValue))\n  return `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, ${a})`\n}\n\n/**\n * Calculate relative luminance of a color (WCAG formula)\n * @param color - Phaser color number\n * @returns Relative luminance (0.0 to 1.0)\n */\nfunction getLuminance(color: number): number {\n  const rgb = numberToRgb(color)\n\n  // Convert to sRGB\n  const rsRGB = rgb.r / 255\n  const gsRGB = rgb.g / 255\n  const bsRGB = rgb.b / 255\n\n  // Apply gamma correction\n  const r = rsRGB <= 0.03928 ? rsRGB / 12.92 : Math.pow((rsRGB + 0.055) / 1.055, 2.4)\n  const g = gsRGB <= 0.03928 ? gsRGB / 12.92 : Math.pow((gsRGB + 0.055) / 1.055, 2.4)\n  const b = bsRGB <= 0.03928 ? bsRGB / 12.92 : Math.pow((bsRGB + 0.055) / 1.055, 2.4)\n\n  // Calculate luminance\n  return 0.2126 * r + 0.7152 * g + 0.0722 * b\n}\n\n/**\n * Calculate contrast ratio between two colors (WCAG 2.0)\n * @param foreground - Foreground color (e.g., text)\n * @param background - Background color\n * @returns Contrast ratio (1 to 21)\n * @example\n * ```typescript\n * getContrastRatio(0x000000, 0xffffff) // returns 21 (black on white)\n * getContrastRatio(0xffffff, 0xffffff) // returns 1 (white on white)\n * ```\n */\nexport function getContrastRatio(foreground: number, background: number): number {\n  const l1 = getLuminance(foreground)\n  const l2 = getLuminance(background)\n\n  const lighter = Math.max(l1, l2)\n  const darker = Math.min(l1, l2)\n\n  return (lighter + 0.05) / (darker + 0.05)\n}\n\n/**\n * Ensure minimum contrast ratio by adjusting foreground color\n * Uses binary search for efficiency (O(log n) vs O(n))\n * @param foreground - Foreground color to adjust\n * @param background - Background color (fixed)\n * @param minRatio - Minimum contrast ratio (default: 4.5 for WCAG AA)\n * @returns Adjusted foreground color meeting contrast requirements\n * @example\n * ```typescript\n * // Ensure text is readable on background\n * const textColor = ensureContrast(0x888888, 0xffffff, 4.5)\n * ```\n */\nexport function ensureContrast(foreground: number, background: number, minRatio = 4.5): number {\n  // If contrast is already sufficient, return original\n  if (getContrastRatio(foreground, background) >= minRatio) {\n    return foreground\n  }\n\n  // Determine if we should lighten or darken\n  const bgLuminance = getLuminance(background)\n  const shouldLighten = bgLuminance < 0.5\n\n  // Binary search for the minimal adjustment needed\n  let low = 0\n  let high = 1\n\n  while (high - low > 0.01) {\n    const mid = (low + high) / 2\n    const adjusted = shouldLighten ? lighten(foreground, mid) : darken(foreground, mid)\n\n    if (getContrastRatio(adjusted, background) >= minRatio) {\n      high = mid\n    } else {\n      low = mid\n    }\n  }\n\n  return shouldLighten ? lighten(foreground, high) : darken(foreground, high)\n}\n\n/**\n * Create a TextStyleToken by merging base style with overrides to ensure required properties are set\n * @param baseStyle\n * @param overrides\n * @returns\n */\nexport function createTextStyle(\n  baseStyle: Partial<TextStyleToken> | undefined,\n  overrides: Partial<TextStyleToken>\n): TextStyleToken {\n  const base = baseStyle ?? {}\n  return {\n    fontSize: overrides.fontSize ?? base.fontSize ?? '14px',\n    color: overrides.color ?? base.color ?? '#ffffff',\n    ...(base.fontFamily && { fontFamily: base.fontFamily }),\n    ...(base.align && { align: base.align }),\n    ...overrides,\n  }\n}\n"],"names":["p","q","HexColor"],"mappings":"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"}

package/dist/colors/color-utils.d.ts

@@ -0,0 +1,216 @@
+import { TextStyleToken } from '../design-tokens/design-token-types';
+import { HexColor, RGBColor } from './color-types';
+/**
+ * Convert hex string to Phaser number format
+ * @param hex - Hex color string (e.g., '#ffffff' or 'ffffff')
+ * @returns Phaser color number (e.g., 0xffffff)
+ * @example
+ * ```typescript
+ * hexToNumber('#ff0000') // returns 0xff0000
+ * hexToNumber('00ff00')  // returns 0x00ff00
+ * ```
+ */
+export declare function hexToNumber(hex: string): number;
+/**
+ * Convert Phaser number format to hex string
+ * @param num - Phaser color number (e.g., 0xffffff)
+ * @param withHash - Include '#' prefix (default: true)
+ * @returns Hex color string (e.g., '#ffffff')
+ * @example
+ * ```typescript
+ * numberToHex(0xff0000)        // returns '#ff0000'
+ * numberToHex(0x00ff00, false) // returns '00ff00'
+ * ```
+ */
+export declare function numberToHex(num: number, withHash?: boolean): string;
+/**
+ * Normalize a color number to Phaser's 0x000000-0xffffff RGB range.
+ * @param color - Color number to normalize
+ * @returns RGB color number in the 24-bit range
+ */
+export declare function normalizeColorNumber(color: number): number;
+/**
+ * Normalize a text color value to a CSS-compatible hex string.
+ *
+ * Handles all common formats users might pass in JSX style.color:
+ * - `0xff0000` (number) → `'#ff0000'`
+ * - `'0xff0000'` (0x-prefixed string) → `'#ff0000'`
+ * - `'0xf00'` (0x short string) → `'#ff0000'`
+ * - `'#f00'` (short CSS hex) → `'#ff0000'`
+ * - `'#ff0000'` (full CSS hex) → `'#ff0000'` (passthrough)
+ * - `'red'`, `'yellow'` (CSS name) → passthrough unchanged
+ * - `undefined` → `undefined`
+ *
+ * Both renderers (Phaser, Pixi) receive the same normalized value,
+ * preventing inconsistent color rendering across renderers.
+ *
+ * @param color - Raw color value from style.color
+ * @returns Normalized CSS hex string, CSS name, or undefined
+ */
+export declare function normalizeTextColor(color: string | number | undefined): string | undefined;
+/**
+ * Convert RGB values to Phaser number format
+ * @param r - Red component (0-255)
+ * @param g - Green component (0-255)
+ * @param b - Blue component (0-255)
+ * @returns Phaser color number
+ * @example
+ * ```typescript
+ * rgbToNumber(255, 0, 0)     // returns 0xff0000 (red)
+ * rgbToNumber(0, 255, 0)     // returns 0x00ff00 (green)
+ * rgbToNumber(255, 255, 255) // returns 0xffffff (white)
+ * ```
+ */
+export declare function rgbToNumber(r: number, g: number, b: number): number;
+/**
+ * Convert Phaser number to RGB components
+ * @param num - Phaser color number
+ * @returns RGB color object
+ * @example
+ * ```typescript
+ * numberToRgb(0xff0000) // returns { r: 255, g: 0, b: 0 }
+ * numberToRgb(0x00ff00) // returns { r: 0, g: 255, b: 0 }
+ * ```
+ */
+export declare function numberToRgb(num: number): RGBColor;
+/**
+ * HSL color representation
+ */
+export interface HSLColor {
+    /** Hue in normalized range (0.0 to 1.0) */
+    h: number;
+    /** Saturation in normalized range (0.0 to 1.0) */
+    s: number;
+    /** Lightness in normalized range (0.0 to 1.0) */
+    l: number;
+}
+/**
+ * Convert RGB values to HSL values (normalized 0.0 to 1.0)
+ * @param r - Red component (0-255)
+ * @param g - Green component (0-255)
+ * @param b - Blue component (0-255)
+ * @returns HSL color values with normalized components
+ * @example
+ * ```typescript
+ * rgbToHsl(255, 0, 0) // returns { h: 0, s: 1, l: 0.5 }
+ * rgbToHsl(0, 255, 0) // returns { h: 0.333..., s: 1, l: 0.5 }
+ * ```
+ */
+export declare function rgbToHsl(r: number, g: number, b: number): HSLColor;
+/**
+ * Convert normalized HSL values to RGB components.
+ * @param h - Hue in normalized range (0.0 to 1.0)
+ * @param s - Saturation in normalized range (0.0 to 1.0)
+ * @param l - Lightness in normalized range (0.0 to 1.0)
+ * @returns RGB color object
+ */
+export declare function hslToRgb(h: number, s: number, l: number): RGBColor;
+/**
+ * Convert normalized HSL values to Phaser number format.
+ * @param h - Hue in normalized range (0.0 to 1.0)
+ * @param s - Saturation in normalized range (0.0 to 1.0)
+ * @param l - Lightness in normalized range (0.0 to 1.0)
+ * @returns Phaser color number
+ */
+export declare function hslToNumber(h: number, s: number, l: number): number;
+/**
+ * Convert Phaser number format to normalized HSL values.
+ * @param color - Phaser color number
+ * @returns HSL color values with normalized components
+ */
+export declare function numberToHsl(color: number): HSLColor;
+/**
+ * Lighten a color by a given amount
+ * @param color - Phaser color number
+ * @param amount - Amount to lighten (0.0 to 1.0, where 1.0 is white)
+ * @returns Lightened color number
+ * @example
+ * ```typescript
+ * lighten(0x0000ff, 0.3) // returns lighter blue
+ * lighten(0xff0000, 0.5) // returns light red/pink
+ * ```
+ */
+export declare function lighten(color: number, amount: number): number;
+/**
+ * Darken a color by a given amount
+ * @param color - Phaser color number
+ * @param amount - Amount to darken (0.0 to 1.0, where 1.0 is black)
+ * @returns Darkened color number
+ * @example
+ * ```typescript
+ * darken(0x0000ff, 0.3) // returns darker blue
+ * darken(0xff0000, 0.5) // returns dark red
+ * ```
+ */
+export declare function darken(color: number, amount: number): number;
+/**
+ * Lighten a hex color by a given amount
+ * @param hex - Hex color (e.g., '#ffffff' or 'ffffff')
+ * @param amount - Amount to lighten (0.0 to 1.0, where 1.0 is white)
+ * @returns Lightened hex color string with '#' prefix
+ * @example
+ * ```typescript
+ * lightenHex('#0000ff', 0.3) // returns lighter blue
+ * lightenHex('#ff0000', 0.5) // returns light red/pink
+ * ```
+ */
+export declare function lightenHex(hex: string, amount: number): HexColor;
+/**
+ * Darken a hex color by a given amount
+ * @param hex - Hex color (e.g., '#ffffff' or 'ffffff')
+ * @param amount - Amount to darken (0.0 to 1.0, where 1.0 is black)
+ * @returns Darkened hex color string with '#' prefix
+ * @example
+ * ```typescript
+ * darkenHex('#0000ff', 0.3) // returns darker blue
+ * darkenHex('#ff0000', 0.5) // returns dark red
+ * ```
+ */
+export declare function darkenHex(hex: string, amount: number): HexColor;
+/**
+ * Convert color to rgba string for Phaser Text style
+ * @param color - Phaser color number
+ * @param alphaValue - Alpha value (0.0 to 1.0, default: 1.0)
+ * @returns RGBA string usable in Text style (e.g., 'rgba(255, 0, 0, 0.5)')
+ * @example
+ * ```typescript
+ * alpha(0xff0000, 1.0)   // returns 'rgba(255, 0, 0, 1)'
+ * alpha(0x00ff00, 0.5)   // returns 'rgba(0, 255, 0, 0.5)'
+ * alpha(0x0000ff)        // returns 'rgba(0, 0, 255, 1)'
+ * ```
+ */
+export declare function alpha(color: number, alphaValue?: number): string;
+/**
+ * Calculate contrast ratio between two colors (WCAG 2.0)
+ * @param foreground - Foreground color (e.g., text)
+ * @param background - Background color
+ * @returns Contrast ratio (1 to 21)
+ * @example
+ * ```typescript
+ * getContrastRatio(0x000000, 0xffffff) // returns 21 (black on white)
+ * getContrastRatio(0xffffff, 0xffffff) // returns 1 (white on white)
+ * ```
+ */
+export declare function getContrastRatio(foreground: number, background: number): number;
+/**
+ * Ensure minimum contrast ratio by adjusting foreground color
+ * Uses binary search for efficiency (O(log n) vs O(n))
+ * @param foreground - Foreground color to adjust
+ * @param background - Background color (fixed)
+ * @param minRatio - Minimum contrast ratio (default: 4.5 for WCAG AA)
+ * @returns Adjusted foreground color meeting contrast requirements
+ * @example
+ * ```typescript
+ * // Ensure text is readable on background
+ * const textColor = ensureContrast(0x888888, 0xffffff, 4.5)
+ * ```
+ */
+export declare function ensureContrast(foreground: number, background: number, minRatio?: number): number;
+/**
+ * Create a TextStyleToken by merging base style with overrides to ensure required properties are set
+ * @param baseStyle
+ * @param overrides
+ * @returns
+ */
+export declare function createTextStyle(baseStyle: Partial<TextStyleToken> | undefined, overrides: Partial<TextStyleToken>): TextStyleToken;
+//# sourceMappingURL=color-utils.d.ts.map

package/dist/colors/color-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-utils.d.ts","sourceRoot":"","sources":["../../src/colors/color-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAA;AACzE,OAAO,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAA;AAEvD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,MAAM,CAGhE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CA6BzF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAQjD;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,2CAA2C;IAC3C,CAAC,EAAE,MAAM,CAAA;IACT,kDAAkD;IAClD,CAAC,EAAE,MAAM,CAAA;IACT,iDAAiD;IACjD,CAAC,EAAE,MAAM,CAAA;CACV;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,QAAQ,CAuBlE;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,QAAQ,CA6BlE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAGnD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAS7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAS5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAIhE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAI/D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,SAAM,GAAG,MAAM,CAI7D;AAwBD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAQ/E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,MAAM,CA0B7F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,EAC9C,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,GACjC,cAAc,CAShB"}

package/dist/colors/color-utils.js

@@ -0,0 +1,197 @@
+import { HexColor } from "./color-types.js";
+function hexToNumber(hex) {
+  const cleaned = hex.replace("#", "");
+  return parseInt(cleaned, 16);
+}
+function numberToHex(num, withHash = true) {
+  const hex = normalizeColorNumber(num).toString(16).padStart(6, "0");
+  return withHash ? `#${hex}` : hex;
+}
+function normalizeColorNumber(color) {
+  if (!Number.isFinite(color)) return 0;
+  return Math.max(0, Math.round(color)) & 16777215;
+}
+function normalizeTextColor(color) {
+  if (color === void 0 || color === null) return void 0;
+  if (typeof color === "number") {
+    return numberToHex(normalizeColorNumber(color));
+  }
+  const trimmed = color.trim();
+  if (trimmed === "") return void 0;
+  if (/^0x[0-9a-fA-F]+$/.test(trimmed)) {
+    const num = parseInt(trimmed.slice(2), 16);
+    if (Number.isNaN(num)) return void 0;
+    return numberToHex(normalizeColorNumber(num));
+  }
+  if (/^#[0-9a-fA-F]{3}$/.test(trimmed)) {
+    const r = trimmed[1];
+    const g = trimmed[2];
+    const b = trimmed[3];
+    return `#${r}${r}${g}${g}${b}${b}`;
+  }
+  return trimmed;
+}
+function rgbToNumber(r, g, b) {
+  return (r & 255) << 16 | (g & 255) << 8 | b & 255;
+}
+function numberToRgb(num) {
+  const normalized = normalizeColorNumber(num);
+  return {
+    r: normalized >> 16 & 255,
+    g: normalized >> 8 & 255,
+    b: normalized & 255
+  };
+}
+function rgbToHsl(r, g, b) {
+  const red = r / 255;
+  const green = g / 255;
+  const blue = b / 255;
+  const max = Math.max(red, green, blue);
+  const min = Math.min(red, green, blue);
+  const delta = max - min;
+  const light = (max + min) / 2;
+  if (delta === 0) {
+    return { h: 0, s: 0, l: light };
+  }
+  const saturationValue = light > 0.5 ? delta / (2 - max - min) : delta / (max + min);
+  let hueValue;
+  if (max === red) {
+    hueValue = (green - blue) / delta + (green < blue ? 6 : 0);
+  } else if (max === green) {
+    hueValue = (blue - red) / delta + 2;
+  } else {
+    hueValue = (red - green) / delta + 4;
+  }
+  return { h: hueValue / 6, s: saturationValue, l: light };
+}
+function hslToRgb(h, s, l) {
+  const hue = ((Number.isFinite(h) ? h : 0) % 1 + 1) % 1;
+  const saturation = Math.max(0, Math.min(1, Number.isFinite(s) ? s : 0));
+  const lightness = Math.max(0, Math.min(1, Number.isFinite(l) ? l : 0));
+  if (saturation === 0) {
+    const value = Math.round(lightness * 255);
+    return { r: value, g: value, b: value };
+  }
+  const hueToRgb = (p2, q2, t) => {
+    let next = t;
+    if (next < 0) next += 1;
+    if (next > 1) next -= 1;
+    if (next < 1 / 6) return p2 + (q2 - p2) * 6 * next;
+    if (next < 1 / 2) return q2;
+    if (next < 2 / 3) return p2 + (q2 - p2) * (2 / 3 - next) * 6;
+    return p2;
+  };
+  const q = lightness < 0.5 ? lightness * (1 + saturation) : lightness + saturation - lightness * saturation;
+  const p = 2 * lightness - q;
+  return {
+    r: Math.round(hueToRgb(p, q, hue + 1 / 3) * 255),
+    g: Math.round(hueToRgb(p, q, hue) * 255),
+    b: Math.round(hueToRgb(p, q, hue - 1 / 3) * 255)
+  };
+}
+function hslToNumber(h, s, l) {
+  const rgb = hslToRgb(h, s, l);
+  return rgbToNumber(rgb.r, rgb.g, rgb.b);
+}
+function numberToHsl(color) {
+  const rgb = numberToRgb(color);
+  return rgbToHsl(rgb.r, rgb.g, rgb.b);
+}
+function lighten(color, amount) {
+  const rgb = numberToRgb(color);
+  const factor = Math.max(0, Math.min(1, amount));
+  const r = Math.round(rgb.r + (255 - rgb.r) * factor);
+  const g = Math.round(rgb.g + (255 - rgb.g) * factor);
+  const b = Math.round(rgb.b + (255 - rgb.b) * factor);
+  return rgbToNumber(r, g, b);
+}
+function darken(color, amount) {
+  const rgb = numberToRgb(color);
+  const factor = 1 - Math.max(0, Math.min(1, amount));
+  const r = Math.round(rgb.r * factor);
+  const g = Math.round(rgb.g * factor);
+  const b = Math.round(rgb.b * factor);
+  return rgbToNumber(r, g, b);
+}
+function lightenHex(hex, amount) {
+  const num = hexToNumber(hex);
+  const lightened = lighten(num, amount);
+  return HexColor.from(numberToHex(lightened));
+}
+function darkenHex(hex, amount) {
+  const num = hexToNumber(hex);
+  const darkened = darken(num, amount);
+  return HexColor.from(numberToHex(darkened));
+}
+function alpha(color, alphaValue = 1) {
+  const rgb = numberToRgb(color);
+  const a = Math.max(0, Math.min(1, alphaValue));
+  return `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, ${a})`;
+}
+function getLuminance(color) {
+  const rgb = numberToRgb(color);
+  const rsRGB = rgb.r / 255;
+  const gsRGB = rgb.g / 255;
+  const bsRGB = rgb.b / 255;
+  const r = rsRGB <= 0.03928 ? rsRGB / 12.92 : Math.pow((rsRGB + 0.055) / 1.055, 2.4);
+  const g = gsRGB <= 0.03928 ? gsRGB / 12.92 : Math.pow((gsRGB + 0.055) / 1.055, 2.4);
+  const b = bsRGB <= 0.03928 ? bsRGB / 12.92 : Math.pow((bsRGB + 0.055) / 1.055, 2.4);
+  return 0.2126 * r + 0.7152 * g + 0.0722 * b;
+}
+function getContrastRatio(foreground, background) {
+  const l1 = getLuminance(foreground);
+  const l2 = getLuminance(background);
+  const lighter = Math.max(l1, l2);
+  const darker = Math.min(l1, l2);
+  return (lighter + 0.05) / (darker + 0.05);
+}
+function ensureContrast(foreground, background, minRatio = 4.5) {
+  if (getContrastRatio(foreground, background) >= minRatio) {
+    return foreground;
+  }
+  const bgLuminance = getLuminance(background);
+  const shouldLighten = bgLuminance < 0.5;
+  let low = 0;
+  let high = 1;
+  while (high - low > 0.01) {
+    const mid = (low + high) / 2;
+    const adjusted = shouldLighten ? lighten(foreground, mid) : darken(foreground, mid);
+    if (getContrastRatio(adjusted, background) >= minRatio) {
+      high = mid;
+    } else {
+      low = mid;
+    }
+  }
+  return shouldLighten ? lighten(foreground, high) : darken(foreground, high);
+}
+function createTextStyle(baseStyle, overrides) {
+  const base = baseStyle ?? {};
+  return {
+    fontSize: overrides.fontSize ?? base.fontSize ?? "14px",
+    color: overrides.color ?? base.color ?? "#ffffff",
+    ...base.fontFamily && { fontFamily: base.fontFamily },
+    ...base.align && { align: base.align },
+    ...overrides
+  };
+}
+export {
+  alpha,
+  createTextStyle,
+  darken,
+  darkenHex,
+  ensureContrast,
+  getContrastRatio,
+  hexToNumber,
+  hslToNumber,
+  hslToRgb,
+  lighten,
+  lightenHex,
+  normalizeColorNumber,
+  normalizeTextColor,
+  numberToHex,
+  numberToHsl,
+  numberToRgb,
+  rgbToHsl,
+  rgbToNumber
+};
+//# sourceMappingURL=color-utils.js.map