@stll/folio-core 0.0.1-placeholder.0 → 0.1.0

package/dist/utils/colorResolver.d.ts

@@ -0,0 +1,158 @@
+import { document_d_exports } from "../types/document.js";
+
+//#region src/utils/colorResolver.d.ts
+/**
+ * Resolve a ColorValue to a CSS color string
+ *
+ * @param color - ColorValue object with rgb, themeColor, tint/shade, or auto
+ * @param theme - Theme for resolving theme colors
+ * @param defaultColor - Default color if auto or undefined (default: black)
+ * @returns CSS color string (e.g., "#FF0000" or "inherit")
+ */
+declare function resolveColor(color: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined, defaultColor?: string): string;
+/**
+ * Resolve a highlight color name to CSS
+ *
+ * @param highlight - Highlight color name (e.g., "yellow", "cyan")
+ * @returns CSS color string or empty string for "none"
+ */
+declare function resolveHighlightColor(highlight: string | undefined): string;
+/**
+ * Resolve a shading fill or pattern color to CSS
+ *
+ * @param color - ColorValue for fill
+ * @param theme - Theme for resolving theme colors
+ * @returns CSS color string
+ */
+declare function resolveShadingColor(color: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined): string;
+/**
+ * Check if a color is effectively black
+ *
+ * @param color - ColorValue object
+ * @param theme - Theme for resolving theme colors
+ * @returns True if color resolves to black or very dark
+ */
+declare function isBlack(color: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined): boolean;
+/**
+ * Check if a color is effectively white
+ *
+ * @param color - ColorValue object
+ * @param theme - Theme for resolving theme colors
+ * @returns True if color resolves to white or very light
+ */
+declare function isWhite(color: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined): boolean;
+/**
+ * Get contrasting text color for a background
+ *
+ * @param backgroundColor - Background ColorValue
+ * @param theme - Theme for resolving theme colors
+ * @returns Black or white hex color for best contrast
+ */
+declare function getContrastingColor(backgroundColor: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined): string;
+/**
+ * Parse a color string (various formats) to ColorValue
+ *
+ * @param colorString - Color string like "FF0000", "auto", or theme color name
+ * @returns ColorValue object
+ */
+declare function parseColorString(colorString: string | undefined): document_d_exports.ColorValue | undefined;
+/**
+ * Create a ColorValue from theme color reference
+ *
+ * @param themeColor - Theme color slot name
+ * @param tint - Optional tint modifier
+ * @param shade - Optional shade modifier
+ * @returns ColorValue object
+ */
+declare function createThemeColor(themeColor: document_d_exports.ThemeColorSlot, tint?: number, shade?: number): document_d_exports.ColorValue;
+/**
+ * Create a ColorValue from RGB hex
+ *
+ * @param hex - 6-character hex color (no #)
+ * @returns ColorValue object
+ */
+declare function createRgbColor(hex: string): document_d_exports.ColorValue;
+/**
+ * Darken a color by a percentage
+ *
+ * @param color - ColorValue to darken
+ * @param theme - Theme for resolving
+ * @param percent - Percentage to darken (0-100)
+ * @returns CSS color string
+ */
+declare function darkenColor(color: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined, percent: number): string;
+/**
+ * Lighten a color by a percentage
+ *
+ * @param color - ColorValue to lighten
+ * @param theme - Theme for resolving
+ * @param percent - Percentage to lighten (0-100)
+ * @returns CSS color string
+ */
+declare function lightenColor(color: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined, percent: number): string;
+/**
+ * Blend two colors together
+ *
+ * @param color1 - First color
+ * @param color2 - Second color
+ * @param ratio - Blend ratio (0 = all color1, 1 = all color2)
+ * @param theme - Theme for resolving
+ * @returns CSS color string
+ */
+declare function blendColors(color1: document_d_exports.ColorValue | undefined | null, color2: document_d_exports.ColorValue | undefined | null, ratio: number, theme: document_d_exports.Theme | null | undefined): string;
+/**
+ * Ensure a hex color string has a '#' prefix.
+ */
+declare function ensureHexPrefix(hex: string): string;
+/**
+ * Resolve a highlight color value to a CSS-ready string.
+ * Tries OOXML named highlight first, then ensures hex prefix.
+ */
+declare function resolveHighlightToCss(value: string): string;
+/**
+ * Theme color matrix cell
+ */
+type ThemeMatrixCell = {
+  /** Resolved hex color (6 chars, no #) */hex: string; /** Theme color slot */
+  themeSlot: document_d_exports.ThemeColorSlot; /** Tint hex modifier if applicable (e.g., "CC") */
+  tint?: string; /** Shade hex modifier if applicable (e.g., "BF") */
+  shade?: string; /** Human-readable label (e.g., "Accent 1, Lighter 60%") */
+  label: string;
+};
+/**
+ * Standard colors row matching Word's color picker (below the theme matrix).
+ */
+declare const STANDARD_TEXT_COLORS: {
+  name: string;
+  hex: string;
+}[];
+/**
+ * Compute a single tinted or shaded hex color from a base color.
+ *
+ * @param baseHex - 6-character hex color (no #)
+ * @param type - 'tint' to lighten, 'shade' to darken
+ * @param fraction - Amount (0-1). For tint: 0=no change, 1=white. For shade: 0=black, 1=no change.
+ * @returns 6-character hex color (no #)
+ */
+declare function getThemeTintShadeHex(baseHex: string, type: "tint" | "shade", fraction: number): string;
+/**
+ * Generate the 10×6 theme color matrix for an advanced color picker.
+ *
+ * Columns: lt1, dk1, lt2, dk2, accent1-6 (matches Word's order)
+ * Rows: base, 80% tint, 60% tint, 40% tint, 25% shade, 50% shade
+ *
+ * @param colorScheme - Theme color scheme (falls back to Office 2016 defaults)
+ * @returns 6 rows × 10 columns of ThemeMatrixCell
+ */
+declare function generateThemeTintShadeMatrix(colorScheme?: document_d_exports.ThemeColorScheme | null): ThemeMatrixCell[][];
+/**
+ * Check if two colors are equal
+ *
+ * @param color1 - First color
+ * @param color2 - Second color
+ * @param theme - Theme for resolving
+ * @returns True if colors resolve to the same value
+ */
+declare function colorsEqual(color1: document_d_exports.ColorValue | undefined | null, color2: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined): boolean;
+//#endregion
+export { STANDARD_TEXT_COLORS, ThemeMatrixCell, blendColors, colorsEqual, createRgbColor, createThemeColor, darkenColor, ensureHexPrefix, generateThemeTintShadeMatrix, getContrastingColor, getThemeTintShadeHex, isBlack, isWhite, lightenColor, parseColorString, resolveColor, resolveHighlightColor, resolveHighlightToCss, resolveShadingColor };

package/dist/utils/colorResolver.js

@@ -0,0 +1,557 @@
+//#region src/utils/colorResolver.ts
+/**
+* Default theme colors (Office 2016 default theme)
+*/
+const DEFAULT_THEME_COLORS = {
+	dk1: "000000",
+	lt1: "FFFFFF",
+	dk2: "44546A",
+	lt2: "E7E6E6",
+	accent1: "4472C4",
+	accent2: "ED7D31",
+	accent3: "A5A5A5",
+	accent4: "FFC000",
+	accent5: "5B9BD5",
+	accent6: "70AD47",
+	hlink: "0563C1",
+	folHlink: "954F72"
+};
+/**
+* Highlight color mapping to hex values
+* These are the W3C standard colors for Word highlighting
+*/
+const HIGHLIGHT_COLORS = {
+	black: "000000",
+	blue: "0000FF",
+	cyan: "00FFFF",
+	darkBlue: "00008B",
+	darkCyan: "008B8B",
+	darkGray: "A9A9A9",
+	darkGreen: "006400",
+	darkMagenta: "8B008B",
+	darkRed: "8B0000",
+	darkYellow: "808000",
+	green: "00FF00",
+	lightGray: "D3D3D3",
+	magenta: "FF00FF",
+	red: "FF0000",
+	white: "FFFFFF",
+	yellow: "FFFF00",
+	none: ""
+};
+/**
+* Map alternative theme color names to standard slots
+* OOXML uses different names in different contexts
+*/
+const THEME_COLOR_ALIASES = {
+	dk1: "dk1",
+	lt1: "lt1",
+	dk2: "dk2",
+	lt2: "lt2",
+	accent1: "accent1",
+	accent2: "accent2",
+	accent3: "accent3",
+	accent4: "accent4",
+	accent5: "accent5",
+	accent6: "accent6",
+	hlink: "hlink",
+	folHlink: "folHlink",
+	dark1: "dk1",
+	light1: "lt1",
+	dark2: "dk2",
+	light2: "lt2",
+	hyperlink: "hlink",
+	followedHyperlink: "folHlink",
+	background1: "lt1",
+	text1: "dk1",
+	background2: "lt2",
+	text2: "dk2",
+	tx1: "dk1",
+	tx2: "dk2",
+	bg1: "lt1",
+	bg2: "lt2"
+};
+/**
+* Parse a hex color modifier value (tint or shade)
+* OOXML stores tint/shade as hex string (00-FF) representing 0-255
+*
+* @param hexValue - Hex string like "80" or "FF"
+* @returns Decimal value 0-1
+*/
+function parseModifierValue(hexValue) {
+	if (!hexValue) return 1;
+	const parsed = Number.parseInt(hexValue, 16);
+	if (Number.isNaN(parsed)) return 1;
+	return parsed / 255;
+}
+/**
+* Parse RGB hex color to component values
+*
+* @param hex - 6-character hex color (no #)
+* @returns RGB object with r, g, b values 0-255
+*/
+function hexToRgb(hex) {
+	const normalized = hex.padStart(6, "0").slice(0, 6);
+	const r = Number.parseInt(normalized.slice(0, 2), 16);
+	const g = Number.parseInt(normalized.slice(2, 4), 16);
+	const b = Number.parseInt(normalized.slice(4, 6), 16);
+	return {
+		r: Number.isNaN(r) ? 0 : r,
+		g: Number.isNaN(g) ? 0 : g,
+		b: Number.isNaN(b) ? 0 : b
+	};
+}
+/**
+* Convert RGB values to hex color
+*
+* @param r - Red 0-255
+* @param g - Green 0-255
+* @param b - Blue 0-255
+* @returns 6-character hex color (no #)
+*/
+function rgbToHex(r, g, b) {
+	const toHex = (n) => Math.max(0, Math.min(255, Math.round(n))).toString(16).padStart(2, "0");
+	return `${toHex(r)}${toHex(g)}${toHex(b)}`.toUpperCase();
+}
+/**
+* Apply tint to a color (make lighter by blending with white)
+*
+* OOXML tint algorithm:
+* - Blends each channel toward white
+*
+* @param hex - 6-character hex color (no #)
+* @param tint - Tint value 0-1 (0 = no change, 1 = fully white)
+* @returns Modified hex color
+*/
+function applyTint(hex, tint) {
+	if (tint <= 0 || tint >= 1) return tint >= 1 ? "FFFFFF" : hex;
+	const rgb = hexToRgb(hex);
+	return rgbToHex(rgb.r * (1 - tint) + 255 * tint, rgb.g * (1 - tint) + 255 * tint, rgb.b * (1 - tint) + 255 * tint);
+}
+/**
+* Apply shade to a color (make darker by blending with black)
+*
+* OOXML shade algorithm:
+* - Multiplies each channel by the shade value
+*
+* @param hex - 6-character hex color (no #)
+* @param shade - Shade value 0-1 (0 = fully black, 1 = no change)
+* @returns Modified hex color
+*/
+function applyShade(hex, shade) {
+	if (shade <= 0 || shade >= 1) return shade <= 0 ? "000000" : hex;
+	const rgb = hexToRgb(hex);
+	return rgbToHex(rgb.r * shade, rgb.g * shade, rgb.b * shade);
+}
+/**
+* Get a theme color by slot name
+*
+* @param theme - Theme object
+* @param slot - Color slot name
+* @returns Hex color (6 characters, no #)
+*/
+function getThemeColorValue(theme, slot) {
+	const schemeKey = THEME_COLOR_ALIASES[slot] ?? slot;
+	const schemeKeys = [
+		"dk1",
+		"lt1",
+		"dk2",
+		"lt2",
+		"accent1",
+		"accent2",
+		"accent3",
+		"accent4",
+		"accent5",
+		"accent6",
+		"hlink",
+		"folHlink"
+	];
+	const isSchemeKey = (key) => schemeKeys.includes(key);
+	if (!theme?.colorScheme) {
+		if (isSchemeKey(schemeKey)) return DEFAULT_THEME_COLORS[schemeKey] ?? "000000";
+		return "000000";
+	}
+	if (isSchemeKey(schemeKey)) return theme.colorScheme[schemeKey] ?? DEFAULT_THEME_COLORS[schemeKey] ?? "000000";
+	return "000000";
+}
+/**
+* Resolve a theme color name to a standard slot
+*
+* @param colorName - Theme color name (could be alias)
+* @returns Standard ThemeColorSlot or null if unknown
+*/
+function resolveThemeColorSlot(colorName) {
+	if (!colorName) return null;
+	const normalized = colorName.toLowerCase();
+	return THEME_COLOR_ALIASES[colorName] ?? THEME_COLOR_ALIASES[normalized] ?? null;
+}
+/**
+* Resolve a ColorValue to a CSS color string
+*
+* @param color - ColorValue object with rgb, themeColor, tint/shade, or auto
+* @param theme - Theme for resolving theme colors
+* @param defaultColor - Default color if auto or undefined (default: black)
+* @returns CSS color string (e.g., "#FF0000" or "inherit")
+*/
+function resolveColor(color, theme, defaultColor = "000000") {
+	if (!color) return `#${defaultColor}`;
+	if (color.auto) return `#${defaultColor}`;
+	let hexColor;
+	if (color.themeColor) {
+		const slot = resolveThemeColorSlot(color.themeColor);
+		if (slot) hexColor = getThemeColorValue(theme, slot);
+		else hexColor = color.rgb ?? defaultColor;
+		if (color.themeTint) {
+			const tintValue = parseModifierValue(color.themeTint);
+			hexColor = applyTint(hexColor, 1 - tintValue);
+		} else if (color.themeShade) {
+			const shadeValue = parseModifierValue(color.themeShade);
+			hexColor = applyShade(hexColor, shadeValue);
+		}
+	} else if (color.rgb) hexColor = color.rgb === "auto" ? defaultColor : color.rgb;
+	else hexColor = defaultColor;
+	return `#${hexColor.toUpperCase().replace(/^#/u, "")}`;
+}
+/**
+* Resolve a highlight color name to CSS
+*
+* @param highlight - Highlight color name (e.g., "yellow", "cyan")
+* @returns CSS color string or empty string for "none"
+*/
+function resolveHighlightColor(highlight) {
+	if (!highlight || highlight === "none") return "";
+	const hex = HIGHLIGHT_COLORS[highlight];
+	return hex ? `#${hex}` : "";
+}
+/**
+* Resolve a shading fill or pattern color to CSS
+*
+* @param color - ColorValue for fill
+* @param theme - Theme for resolving theme colors
+* @returns CSS color string
+*/
+function resolveShadingColor(color, theme) {
+	if (!color) return "";
+	if (color.auto) return "transparent";
+	return resolveColor(color, theme);
+}
+/**
+* Check if a color is effectively black
+*
+* @param color - ColorValue object
+* @param theme - Theme for resolving theme colors
+* @returns True if color resolves to black or very dark
+*/
+function isBlack(color, theme) {
+	if (!color) return false;
+	if (color.auto) return true;
+	const rgb = hexToRgb(resolveColor(color, theme).replace(/^#/u, "").toLowerCase());
+	return (rgb.r + rgb.g + rgb.b) / 3 < 20;
+}
+/**
+* Check if a color is effectively white
+*
+* @param color - ColorValue object
+* @param theme - Theme for resolving theme colors
+* @returns True if color resolves to white or very light
+*/
+function isWhite(color, theme) {
+	if (!color) return false;
+	const rgb = hexToRgb(resolveColor(color, theme).replace(/^#/u, "").toLowerCase());
+	return (rgb.r + rgb.g + rgb.b) / 3 > 235;
+}
+/**
+* Get contrasting text color for a background
+*
+* @param backgroundColor - Background ColorValue
+* @param theme - Theme for resolving theme colors
+* @returns Black or white hex color for best contrast
+*/
+function getContrastingColor(backgroundColor, theme) {
+	if (!backgroundColor) return "#000000";
+	const bgRgb = hexToRgb(resolveColor(backgroundColor, theme).replace(/^#/u, ""));
+	return (.299 * bgRgb.r + .587 * bgRgb.g + .114 * bgRgb.b) / 255 > .5 ? "#000000" : "#FFFFFF";
+}
+/**
+* Parse a color string (various formats) to ColorValue
+*
+* @param colorString - Color string like "FF0000", "auto", or theme color name
+* @returns ColorValue object
+*/
+function parseColorString(colorString) {
+	if (!colorString) return;
+	const normalized = colorString.trim();
+	if (normalized.toLowerCase() === "auto") return { auto: true };
+	const themeSlot = resolveThemeColorSlot(normalized);
+	if (themeSlot) return { themeColor: themeSlot };
+	const hex = normalized.replace(/^#/u, "").toUpperCase();
+	if (/^[0-9A-F]{6}$/iu.test(hex)) return { rgb: hex };
+	if (/^[0-9A-F]{3}$/iu.test(hex)) return { rgb: hex.split("").map((c) => c + c).join("") };
+	return { rgb: hex.padStart(6, "0").slice(0, 6) };
+}
+/**
+* Create a ColorValue from theme color reference
+*
+* @param themeColor - Theme color slot name
+* @param tint - Optional tint modifier
+* @param shade - Optional shade modifier
+* @returns ColorValue object
+*/
+function createThemeColor(themeColor, tint, shade) {
+	const result = { themeColor };
+	if (tint !== void 0 && tint > 0 && tint < 1) result.themeTint = Math.round(tint * 255).toString(16).toUpperCase().padStart(2, "0");
+	if (shade !== void 0 && shade > 0 && shade < 1) result.themeShade = Math.round(shade * 255).toString(16).toUpperCase().padStart(2, "0");
+	return result;
+}
+/**
+* Create a ColorValue from RGB hex
+*
+* @param hex - 6-character hex color (no #)
+* @returns ColorValue object
+*/
+function createRgbColor(hex) {
+	return { rgb: hex.replace(/^#/u, "").toUpperCase() };
+}
+/**
+* Darken a color by a percentage
+*
+* @param color - ColorValue to darken
+* @param theme - Theme for resolving
+* @param percent - Percentage to darken (0-100)
+* @returns CSS color string
+*/
+function darkenColor(color, theme, percent) {
+	return `#${applyShade(resolveColor(color, theme).replace(/^#/u, ""), 1 - percent / 100)}`;
+}
+/**
+* Lighten a color by a percentage
+*
+* @param color - ColorValue to lighten
+* @param theme - Theme for resolving
+* @param percent - Percentage to lighten (0-100)
+* @returns CSS color string
+*/
+function lightenColor(color, theme, percent) {
+	return `#${applyTint(resolveColor(color, theme).replace(/^#/u, ""), percent / 100)}`;
+}
+/**
+* Blend two colors together
+*
+* @param color1 - First color
+* @param color2 - Second color
+* @param ratio - Blend ratio (0 = all color1, 1 = all color2)
+* @param theme - Theme for resolving
+* @returns CSS color string
+*/
+function blendColors(color1, color2, ratio, theme) {
+	const resolved1 = resolveColor(color1, theme).replace(/^#/u, "");
+	const resolved2 = resolveColor(color2, theme).replace(/^#/u, "");
+	const rgb1 = hexToRgb(resolved1);
+	const rgb2 = hexToRgb(resolved2);
+	const blended = {
+		r: Math.round(rgb1.r * (1 - ratio) + rgb2.r * ratio),
+		g: Math.round(rgb1.g * (1 - ratio) + rgb2.g * ratio),
+		b: Math.round(rgb1.b * (1 - ratio) + rgb2.b * ratio)
+	};
+	return `#${rgbToHex(blended.r, blended.g, blended.b)}`;
+}
+/**
+* Ensure a hex color string has a '#' prefix.
+*/
+function ensureHexPrefix(hex) {
+	return hex.startsWith("#") ? hex : `#${hex}`;
+}
+/**
+* Resolve a highlight color value to a CSS-ready string.
+* Tries OOXML named highlight first, then ensures hex prefix.
+*/
+function resolveHighlightToCss(value) {
+	return resolveHighlightColor(value) || ensureHexPrefix(value);
+}
+/**
+* Standard colors row matching Word's color picker (below the theme matrix).
+*/
+const STANDARD_TEXT_COLORS = [
+	{
+		name: "Dark Red",
+		hex: "C00000"
+	},
+	{
+		name: "Red",
+		hex: "FF0000"
+	},
+	{
+		name: "Orange",
+		hex: "FFC000"
+	},
+	{
+		name: "Yellow",
+		hex: "FFFF00"
+	},
+	{
+		name: "Light Green",
+		hex: "92D050"
+	},
+	{
+		name: "Green",
+		hex: "00B050"
+	},
+	{
+		name: "Light Blue",
+		hex: "00B0F0"
+	},
+	{
+		name: "Blue",
+		hex: "0070C0"
+	},
+	{
+		name: "Dark Blue",
+		hex: "002060"
+	},
+	{
+		name: "Purple",
+		hex: "7030A0"
+	}
+];
+/**
+* Theme color column order matching Word's color picker:
+* Background 1 (lt1), Text 1 (dk1), Background 2 (lt2), Text 2 (dk2), Accent 1-6
+*/
+const THEME_MATRIX_COLUMNS = [
+	{
+		slot: "lt1",
+		name: "Background 1"
+	},
+	{
+		slot: "dk1",
+		name: "Text 1"
+	},
+	{
+		slot: "lt2",
+		name: "Background 2"
+	},
+	{
+		slot: "dk2",
+		name: "Text 2"
+	},
+	{
+		slot: "accent1",
+		name: "Accent 1"
+	},
+	{
+		slot: "accent2",
+		name: "Accent 2"
+	},
+	{
+		slot: "accent3",
+		name: "Accent 3"
+	},
+	{
+		slot: "accent4",
+		name: "Accent 4"
+	},
+	{
+		slot: "accent5",
+		name: "Accent 5"
+	},
+	{
+		slot: "accent6",
+		name: "Accent 6"
+	}
+];
+/**
+* Tint/shade row definitions matching Word's picker.
+* Row 0 = base, rows 1-3 = tints (lighter), rows 4-5 = shades (darker).
+*/
+const THEME_MATRIX_ROWS = [
+	{
+		type: "base",
+		value: 0,
+		hexValue: "",
+		labelSuffix: ""
+	},
+	{
+		type: "tint",
+		value: .8,
+		hexValue: "CC",
+		labelSuffix: ", Lighter 80%"
+	},
+	{
+		type: "tint",
+		value: .6,
+		hexValue: "99",
+		labelSuffix: ", Lighter 60%"
+	},
+	{
+		type: "tint",
+		value: .4,
+		hexValue: "66",
+		labelSuffix: ", Lighter 40%"
+	},
+	{
+		type: "shade",
+		value: .75,
+		hexValue: "BF",
+		labelSuffix: ", Darker 25%"
+	},
+	{
+		type: "shade",
+		value: .5,
+		hexValue: "80",
+		labelSuffix: ", Darker 50%"
+	}
+];
+/**
+* Compute a single tinted or shaded hex color from a base color.
+*
+* @param baseHex - 6-character hex color (no #)
+* @param type - 'tint' to lighten, 'shade' to darken
+* @param fraction - Amount (0-1). For tint: 0=no change, 1=white. For shade: 0=black, 1=no change.
+* @returns 6-character hex color (no #)
+*/
+function getThemeTintShadeHex(baseHex, type, fraction) {
+	if (type === "tint") return applyTint(baseHex, fraction);
+	return applyShade(baseHex, fraction);
+}
+/**
+* Generate the 10×6 theme color matrix for an advanced color picker.
+*
+* Columns: lt1, dk1, lt2, dk2, accent1-6 (matches Word's order)
+* Rows: base, 80% tint, 60% tint, 40% tint, 25% shade, 50% shade
+*
+* @param colorScheme - Theme color scheme (falls back to Office 2016 defaults)
+* @returns 6 rows × 10 columns of ThemeMatrixCell
+*/
+function generateThemeTintShadeMatrix(colorScheme) {
+	const scheme = colorScheme ?? DEFAULT_THEME_COLORS;
+	return THEME_MATRIX_ROWS.map((row) => THEME_MATRIX_COLUMNS.map((col) => {
+		const baseHex = scheme[col.slot] ?? DEFAULT_THEME_COLORS[col.slot] ?? "000000";
+		let hex;
+		if (row.type === "base") hex = baseHex.toUpperCase();
+		else if (row.type === "tint") hex = applyTint(baseHex, row.value);
+		else hex = applyShade(baseHex, row.value);
+		const cell = {
+			hex,
+			themeSlot: col.slot,
+			label: `${col.name}${row.labelSuffix}`
+		};
+		if (row.type === "tint" && row.hexValue) cell.tint = row.hexValue;
+		else if (row.type === "shade" && row.hexValue) cell.shade = row.hexValue;
+		return cell;
+	}));
+}
+/**
+* Check if two colors are equal
+*
+* @param color1 - First color
+* @param color2 - Second color
+* @param theme - Theme for resolving
+* @returns True if colors resolve to the same value
+*/
+function colorsEqual(color1, color2, theme) {
+	if (!color1 && !color2) return true;
+	if (!color1 || !color2) return false;
+	return resolveColor(color1, theme).toUpperCase() === resolveColor(color2, theme).toUpperCase();
+}
+//#endregion
+export { STANDARD_TEXT_COLORS, blendColors, colorsEqual, createRgbColor, createThemeColor, darkenColor, ensureHexPrefix, generateThemeTintShadeMatrix, getContrastingColor, getThemeTintShadeHex, isBlack, isWhite, lightenColor, parseColorString, resolveColor, resolveHighlightColor, resolveHighlightToCss, resolveShadingColor };