@quidgest/ui 0.20.0 → 0.21.0

package/esm/composables/useToast/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/composables/useToast/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE1D,eAAO,MAAM,WAAW,EAAE,YAAY,CAAC,aAAa,CAAyB,CAAA;AAE7E;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC3B;;OAEG;IACH,MAAM,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAA;CACxB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACvB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IAEV;;OAEG;IACH,KAAK,EAAE,WAAW,CAAA;CAClB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG;IAC5C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAEjD;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/composables/useToast/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAO,MAAM,KAAK,CAAA;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AA+H1D;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG;IACvB;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAA;IAEX;;OAEG;IACH,KAAK,EAAE,WAAW,CAAA;CAClB,CAAA;AAoBD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B;;;;OAIG;IACH,MAAM,EAAE,WAAW,CAAC,SAAS,EAAE,CAAC,CAAA;IAEhC;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAE7C;;;;;OAKG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IAE7B;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B,CAAA"}

package/esm/framework.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"framework.d.ts","sourceRoot":"","sources":["../src/framework.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAO,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,CAAA;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AACtD,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,qBAAqB,CAAA;AAMrE;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC7B,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAEtC,gFAAgF;IAChF,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACnB,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,GAAE,eAAoB,GAAG,MAAM,CAwBpE"}
+{"version":3,"file":"framework.d.ts","sourceRoot":"","sources":["../src/framework.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAO,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,CAAA;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AACtD,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,qBAAqB,CAAA;AAMrE;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC7B,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAEtC,gFAAgF;IAChF,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACnB,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,GAAE,eAAoB,GAAG,MAAM,CA2BpE"}

package/esm/framework.js

@@ -4,21 +4,21 @@ import { createThemeInstance as r, generateRootStyle as i } from "./utils/theme.
 import { ThemeSymbol as a } from "./composables/theme.js";
 import { DismissibleLayerKey as o } from "./symbols/dismissibleLayer.js";
 import { useDismissibleLayerStack as s } from "./composables/useDismissibleLayerStack/index.js";
-import { ToastSymbol as c } from "./composables/useToast/types.js";
-import { createToastInstance as l } from "./composables/useToast/index.js";
-import { ref as u, watch as d } from "vue";
+import { DialogSymbol as c, createDialogInstance as l } from "./composables/useDialog/_internal.js";
+import { ToastSymbol as u, createToastInstance as d } from "./composables/useToast/_internal.js";
+import { ref as f, watch as p } from "vue";
 //#region src/framework.ts
-function f(e = {}) {
+function m(e = {}) {
 	return { install: (t) => {
 		let r = e.components || {};
 		for (let e in r) t.component(e, r[e]);
 		let i = e.defaults || {};
-		t.provide(n, u(i)), p(t, e.themes);
+		t.provide(n, f(i)), h(t, e.themes);
 		let a = s();
-		t.provide(o, a), m(t);
+		t.provide(o, a), g(t), _(t);
 	} };
 }
-function p(n, o) {
+function h(n, o) {
 	let s = [], c;
 	if (o) for (let n of o.themes) {
 		let r = {
@@ -44,17 +44,21 @@ function p(n, o) {
 		s.push(...n), c = "light";
 	}
 	if (c) {
-		let e = r(u(c), u(s));
-		i(s), d(e.class, h, { immediate: !0 }), n.provide(a, e);
+		let e = r(f(c), f(s));
+		i(s), p(e.class, v, { immediate: !0 }), n.provide(a, e);
 	}
 }
-function m(e) {
+function g(e) {
+	let t = d();
+	e.provide(u, t);
+}
+function _(e) {
 	let t = l();
 	e.provide(c, t);
 }
-function h(e) {
+function v(e) {
 	let t = document.documentElement;
 	t.className = Array.from(t.classList).filter((e) => !e.startsWith("q-theme")).join(" "), t.classList.add(e);
 }
 //#endregion
-export { f as createFramework };
+export { m as createFramework };

package/esm/index.d.ts

@@ -32,6 +32,7 @@ declare module '@vue/runtime-core' {
 		QField: typeof import('@quidgest/ui/components')['QField']
 		QFileUpload: typeof import('@quidgest/ui/components')['QFileUpload']
 		QFocusWrap: typeof import('@quidgest/ui/components')['QFocusWrap']
+		QGauge: typeof import('@quidgest/ui/components')['QGauge']
 		QCol: typeof import('@quidgest/ui/components')['QCol']
 		QContainer: typeof import('@quidgest/ui/components')['QContainer']
 		QRow: typeof import('@quidgest/ui/components')['QRow']

package/esm/templates/theme.js

@@ -1,56 +1,56 @@
 //#region src/templates/theme.ts
 var e = {
 	primary: "#008ad2",
-	primaryLight: "#cde5ff",
-	primaryDark: "#006398",
+	primaryLight: "#b4e5ff",
+	primaryDark: "#00669d",
 	secondary: "#001d31",
 	secondaryLight: "#e6eef3",
 	secondaryDark: "#001425",
 	highlight: "#ff8241",
-	highlightLight: "#ffe4d6",
-	highlightDark: "#cc4700",
+	highlightLight: "#ffe0d0",
+	highlightDark: "#f15400",
 	info: "#17a2b8",
 	infoLight: "#bceff7",
-	infoDark: "#11798a",
+	infoDark: "#117b8c",
 	success: "#28a745",
 	successLight: "#c2f0cd",
-	successDark: "#1e7d34",
+	successDark: "#1f7e35",
 	warning: "#ffa900",
 	warningLight: "#ffeabf",
-	warningDark: "#bf7f00",
+	warningDark: "#bf8000",
 	danger: "#b71c1c",
-	dangerLight: "#f7cccc",
-	dangerDark: "#891515",
+	dangerLight: "#f5bebe",
+	dangerDark: "#881515",
 	background: "#fff",
 	container: "#fff",
-	neutral: "#7c858d",
-	neutralLight: "#c4c5ca",
-	neutralDark: "#40474f",
-	onPrimary: "#fff",
-	onPrimaryLight: "#202428",
+	neutral: "#6d767f",
+	neutralLight: "#dadddf",
+	neutralDark: "#51585f",
+	onPrimary: "#000",
+	onPrimaryLight: "#000",
 	onPrimaryDark: "#fff",
 	onSecondary: "#fff",
-	onSecondaryLight: "#202428",
+	onSecondaryLight: "#000",
 	onSecondaryDark: "#fff",
-	onHighlight: "#fff",
-	onHighlightLight: "#202428",
-	onHighlightDark: "#fff",
-	onInfo: "#fff",
-	onInfoLight: "#202428",
+	onHighlight: "#000",
+	onHighlightLight: "#000",
+	onHighlightDark: "#000",
+	onInfo: "#000",
+	onInfoLight: "#000",
 	onInfoDark: "#fff",
-	onSuccess: "#fff",
-	onSuccessLight: "#202428",
+	onSuccess: "#000",
+	onSuccessLight: "#000",
 	onSuccessDark: "#fff",
-	onWarning: "#fff",
-	onWarningLight: "#202428",
-	onWarningDark: "#fff",
+	onWarning: "#000",
+	onWarningLight: "#000",
+	onWarningDark: "#000",
 	onDanger: "#fff",
-	onDangerLight: "#202428",
+	onDangerLight: "#000",
 	onDangerDark: "#fff",
-	onBackground: "#202428",
-	onContainer: "#202428",
+	onBackground: "#000",
+	onContainer: "#000",
 	onNeutral: "#fff",
-	onNeutralLight: "#202428",
+	onNeutralLight: "#000",
 	onNeutralDark: "#fff"
 }, t = {
 	primary: "#4da6e0",
@@ -80,30 +80,30 @@ var e = {
 	neutralLight: "#2a2d31",
 	neutralDark: "#c8ced6",
 	onPrimary: "#000",
-	onPrimaryLight: "#e0e0e0",
+	onPrimaryLight: "#fff",
 	onPrimaryDark: "#000",
 	onSecondary: "#000",
-	onSecondaryLight: "#e0e0e0",
+	onSecondaryLight: "#fff",
 	onSecondaryDark: "#000",
 	onHighlight: "#000",
-	onHighlightLight: "#e0e0e0",
+	onHighlightLight: "#fff",
 	onHighlightDark: "#000",
 	onInfo: "#000",
-	onInfoLight: "#e0e0e0",
+	onInfoLight: "#fff",
 	onInfoDark: "#000",
 	onSuccess: "#000",
-	onSuccessLight: "#e0e0e0",
+	onSuccessLight: "#fff",
 	onSuccessDark: "#000",
 	onWarning: "#000",
-	onWarningLight: "#e0e0e0",
+	onWarningLight: "#fff",
 	onWarningDark: "#000",
 	onDanger: "#000",
-	onDangerLight: "#e0e0e0",
+	onDangerLight: "#fff",
 	onDangerDark: "#000",
-	onBackground: "#e0e0e0",
-	onContainer: "#e0e0e0",
+	onBackground: "#fff",
+	onContainer: "#fff",
 	onNeutral: "#000",
-	onNeutralLight: "#e0e0e0",
+	onNeutralLight: "#fff",
 	onNeutralDark: "#000"
 };
 //#endregion

package/esm/utils/color/contrast.d.ts

@@ -1,11 +1,18 @@
+import { RGB } from './types';
 /**
- * Determines a contrasting color (black or white) based on the given luminance.
- * Useful for ensuring text readability against a background color with the given luminance.
+ * Calculates the WCAG 2.x relative luminance for an sRGB color.
  *
- * @param luminance - The luminance value (between 0 and 100) of the background color.
+ * @param rgb - The color in RGB space.
+ * @returns Relative luminance between 0 and 1.
+ */
+export declare function getRelativeLuminance(rgb: RGB): number;
+/**
+ * Determines a contrasting color (black or white) based on WCAG relative luminance.
+ *
+ * @param rgb - The background color in RGB space.
  * @returns A hex string representing either black ('#000') or white ('#fff').
  */
-export declare function getContrastingColor(luminance: number): '#000' | '#fff';
+export declare function getContrastingColor(rgb: RGB): '#000' | '#fff';
 /**
  * Calculates the complementary color for a given color string.
  * The complementary color is the color directly opposite on the color wheel,

package/esm/utils/color/contrast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contrast.d.ts","sourceRoot":"","sources":["../../../src/utils/color/contrast.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAMtE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAW3D"}
+{"version":3,"file":"contrast.d.ts","sourceRoot":"","sources":["../../../src/utils/color/contrast.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAiBlC;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAMrD;AAgBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,MAAM,CAM7D;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ3D"}

package/esm/utils/color/contrast.js

@@ -2,11 +2,24 @@ import { rgbToHex as e } from "./conversion.js";
 import { parseColor as t } from "./parse.js";
 //#region src/utils/color/contrast.ts
 function n(e) {
-	return e > 50 ? "#000" : "#fff";
+	let t = e / 255;
+	return t <= .03928 ? t / 12.92 : ((t + .055) / 1.055) ** 2.4;
 }
-function r(n) {
+function r(e) {
+	let t = n(e.r), r = n(e.g), i = n(e.b);
+	return .2126 * t + .7152 * r + .0722 * i;
+}
+function i(e, t) {
+	let n = Math.max(e, t), r = Math.min(e, t);
+	return (n + .05) / (r + .05);
+}
+function a(e) {
+	let t = r(e), n = i(t, 0);
+	return i(t, 1) >= n ? "#fff" : "#000";
+}
+function o(n) {
 	let r = t(n);
 	return r.r = 255 - r.r, r.g = 255 - r.g, r.b = 255 - r.b, e(r);
 }
 //#endregion
-export { r as getComplementaryColor, n as getContrastingColor };
+export { o as getComplementaryColor, a as getContrastingColor, r as getRelativeLuminance };

package/esm/utils/color/index.d.ts

@@ -3,5 +3,6 @@ export * from './conversion';
 export * from './manipulate';
 export * from './merge';
 export * from './parse';
+export * from './theme-colors';
 export * from './types';
 //# sourceMappingURL=index.d.ts.map

package/esm/utils/color/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/color/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/color/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA"}

package/esm/utils/color/merge.d.ts

@@ -1,4 +1,13 @@
 import { ColorScheme } from './types';
+/**
+ * Amount passed to {@link lighten} when auto-generating scheme `*Light` variants.
+ */
+export declare const COLOR_SCHEME_LIGHTEN_AMOUNT = 75;
+/**
+ * Amount passed to {@link darken} when auto-generating scheme `*Dark` variants
+ * (and `useColor` hover fallback when no scheme `*Dark` token applies).
+ */
+export declare const COLOR_SCHEME_DARKEN_AMOUNT = 25;
 /**
  * Merges two color schemes, generating color variants and contrasting text colors as needed.
  *

package/esm/utils/color/merge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../../src/utils/color/merge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmB,WAAW,EAAE,MAAM,SAAS,CAAA;AAQ3D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAkGtF"}
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../../src/utils/color/merge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmB,WAAW,EAAE,MAAM,SAAS,CAAA;AAQ3D;;GAEG;AACH,eAAO,MAAM,2BAA2B,KAAK,CAAA;AAE7C;;;GAGG;AACH,eAAO,MAAM,0BAA0B,KAAK,CAAA;AAE5C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAiGtF"}

package/esm/utils/color/merge.js

@@ -1,17 +1,16 @@
-import { rgbToHex as e, rgbToHsl as t } from "./conversion.js";
-import { parseColor as n } from "./parse.js";
-import { getComplementaryColor as r, getContrastingColor as i } from "./contrast.js";
-import { darken as a, lighten as o } from "./manipulate.js";
-//#region src/utils/color/merge.ts
-function s(s, c) {
-	let l = { ...s }, u = (t, r) => {
-		let i = n(t), s = e(o(i, 85)), c = e(a(i, 25)), l = r.toString().replace(/(Light|Dark)$/, "");
+import { rgbToHex as e } from "./conversion.js";
+import { parseColor as t } from "./parse.js";
+import { getComplementaryColor as n, getContrastingColor as r } from "./contrast.js";
+import { darken as i, lighten as a } from "./manipulate.js";
+function o(o, s) {
+	let c = { ...o }, l = (n, r) => {
+		let o = t(n), s = e(a(o, 75)), c = e(i(o, 25)), l = r.toString().replace(/(Light|Dark)$/, "");
 		return {
-			[l]: t,
+			[l]: n,
 			[`${l}Light`]: s,
 			[`${l}Dark`]: c
 		};
-	}, d = (e) => i(t(n(e)).l);
+	}, u = (e) => r(t(e));
 	for (let e of [
 		"primary",
 		"secondary",
@@ -23,22 +22,22 @@ function s(s, c) {
 		"neutral"
 	]) {
 		let t = e, n = `${e}Light`, r = `${e}Dark`, i = `on${e.charAt(0).toUpperCase() + e.slice(1)}`, a = `on${e.charAt(0).toUpperCase() + e.slice(1)}Light`, o = `on${e.charAt(0).toUpperCase() + e.slice(1)}Dark`;
-		if (c[t]) {
-			let e = u(c[t], t);
-			Object.assign(l, e), l[i] = d(c[t]), l[a] = d(e[n]), l[o] = d(e[r]);
+		if (s[t]) {
+			let e = l(s[t], t);
+			Object.assign(c, e), c[i] = u(s[t]), c[a] = u(e[n]), c[o] = u(e[r]);
 		}
-		c[t] || (c[n] && (l[n] = c[n], c[a] || (l[a] = d(c[n]))), c[r] && (l[r] = c[r], c[o] || (l[o] = d(c[r])))), c[i] && (l[i] = c[i]), c[a] && (l[a] = c[a]), c[o] && (l[o] = c[o]);
+		s[t] || (s[n] && (c[n] = s[n], s[a] || (c[a] = u(s[n]))), s[r] && (c[r] = s[r], s[o] || (c[o] = u(s[r])))), s[i] && (c[i] = s[i]), s[a] && (c[a] = s[a]), s[o] && (c[o] = s[o]);
 	}
-	if (c.primary && !c.highlight) {
-		let e = r(c.primary), t = u(e, "highlight");
-		Object.assign(l, t), l.onHighlight = d(e), l.onHighlightLight = d(t.highlightLight), l.onHighlightDark = d(t.highlightDark);
+	if (s.primary && !s.highlight) {
+		let e = n(s.primary), t = l(e, "highlight");
+		Object.assign(c, t), c.onHighlight = u(e), c.onHighlightLight = u(t.highlightLight), c.onHighlightDark = u(t.highlightDark);
 	}
-	for (let e of ["background", "container"]) if (c[e]) {
-		l[e] = c[e];
+	for (let e of ["background", "container"]) if (s[e]) {
+		c[e] = s[e];
 		let t = `on${e.charAt(0).toUpperCase() + e.slice(1)}`;
-		c[t] || (l[t] = d(c[e]));
+		s[t] || (c[t] = u(s[e]));
 	}
-	return c.onBackground && (l.onBackground = c.onBackground), c.onContainer && (l.onContainer = c.onContainer), l;
+	return s.onBackground && (c.onBackground = s.onBackground), s.onContainer && (c.onContainer = s.onContainer), c;
 }
 //#endregion
-export { s as mergeColorSchemes };
+export { o as mergeColorSchemes };

package/esm/utils/color/parse.d.ts

@@ -2,23 +2,39 @@ import { RGB } from './types';
 /**
  * Checks if the given string represents a valid hexadecimal color code.
  *
+ * When `enforceSixChars` is false, accepts `#rgb`, `#rrggbb`, and `#rrggbbaa`
+ * (aligned with {@link tryParseColor} / hex parsing). When true, only `#rrggbb`.
+ *
  * @param hexColorCode - The color code to validate.
  * @param enforceSixChars - Whether to enforce only the 6-character format (default is false).
  * @returns True if the color code is valid, false otherwise.
  */
 export declare function isValidHex(hexColorCode: string, enforceSixChars?: boolean): boolean;
 /**
- * Tries to parse a string in the format 'rgb(r, g, b)' to an RGB object.
+ * Tries to parse an `rgb()` or `rgba()` color string to an RGB object.
+ *
+ * Supports comma-separated and modern space-separated syntax. Alpha is ignored.
  *
- * @param tr The input string to parse, expected in the format 'rgb(r, g, b)'.
- * @returns An object containing parsed RGB values if the input string is valid, otherwise undefined.
+ * @param str - The input string to parse.
+ * @returns Parsed RGB values when valid, otherwise undefined.
  */
 export declare function tryParseRgb(str: string): RGB | undefined;
 /**
- * Parses a color from a hex string.
+ * Attempts to parse a color string into an RGB object without throwing.
+ *
+ * Supports hex (`#rgb`, `#rrggbb`, `#rrggbbaa`), `rgb`/`rgba`, and `hsl`/`hsla`.
+ * Alpha channels are ignored.
+ *
+ * @param color - A CSS color string.
+ * @returns The parsed RGB object, or undefined when parsing fails.
+ */
+export declare function tryParseColor(color: string): RGB | undefined;
+/**
+ * Parses a supported CSS color string.
  *
- * @param color A hex string representing the color, e.g., "#aabbcc".
+ * @param color - A CSS color string, e.g. `#aabbcc` or `rgb(170, 187, 204)`.
  * @returns A `RGB` object representing the parsed color.
+ * @throws {Error} When the color format is not supported.
  */
 export declare function parseColor(color: string): RGB;
 //# sourceMappingURL=parse.d.ts.map

package/esm/utils/color/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/utils/color/parse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAElC;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,GAAE,OAAe,GAAG,OAAO,CAQ1F;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CASxD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAkB7C"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/utils/color/parse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AASlC;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,GAAE,OAAe,GAAG,OAAO,CAQ1F;AAuMD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAExD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAS5D;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAQ7C"}

package/esm/utils/color/parse.js

@@ -1,26 +1,94 @@
+import { hslToRgb as e } from "./conversion.js";
 //#region src/utils/color/parse.ts
-function e(e, t = !1) {
-	return t ? /^#[a-fA-F0-9]{6}$/.test(e) : /^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$/.test(e);
-}
-function t(e) {
-	let t = e.match(/^rgb\((\d+),\s*(\d+),\s*(\d+)\)$/);
-	if (t) return {
-		r: parseInt(t[1], 10),
-		g: parseInt(t[2], 10),
-		b: parseInt(t[3], 10)
-	};
+var t = /^#([a-fA-F0-9]{3})$/, n = /^#([a-fA-F0-9]{6})$/, r = /^#([a-fA-F0-9]{8})$/;
+function i(e, i = !1) {
+	return i ? n.test(e) : t.test(e) || n.test(e) || r.test(e);
+}
+function a(e) {
+	return Math.max(0, Math.min(255, Math.round(e)));
 }
-function n(n) {
-	if (e(n)) return n.length === 4 && (n = "#" + n[1] + n[1] + n[2] + n[2] + n[3] + n[3]), {
-		r: parseInt(n.slice(1, 3), 16),
-		g: parseInt(n.slice(3, 5), 16),
-		b: parseInt(n.slice(5, 7), 16)
+function o(e) {
+	return {
+		r: parseInt(e.slice(0, 2), 16),
+		g: parseInt(e.slice(2, 4), 16),
+		b: parseInt(e.slice(4, 6), 16)
 	};
-	{
-		let e = t(n);
-		if (e) return e;
+}
+function s(e) {
+	if (t.test(e)) return o(("#" + e[1] + e[1] + e[2] + e[2] + e[3] + e[3]).slice(1));
+	if (n.test(e)) return o(e.slice(1));
+	if (r.test(e)) return o(e.slice(1, 7));
+}
+function c(e) {
+	let t = e.trim(), n = t.match(/^(-?\d*\.?\d+)%$/);
+	if (n) {
+		let e = Number.parseFloat(n[1]);
+		return Number.isNaN(e) ? void 0 : a(e / 100 * 255);
 	}
-	throw Error("Invalid color format");
+	let r = t.match(/^(-?\d*\.?\d+)$/);
+	if (!r) return;
+	let i = Number.parseFloat(r[1]);
+	if (!Number.isNaN(i)) return a(i);
+}
+function l(e) {
+	let t = e.trim().toLowerCase().match(/^(-?\d*\.?\d+)(deg)?$/);
+	if (!t) return;
+	let n = Number.parseFloat(t[1]);
+	if (!Number.isNaN(n)) return (n % 360 + 360) % 360;
+}
+function u(e) {
+	let t = e.trim();
+	if (!t.endsWith("%")) return;
+	let n = Number.parseFloat(t.slice(0, -1));
+	if (!Number.isNaN(n)) return Math.max(0, Math.min(100, n));
+}
+function d(e) {
+	let t = e.match(/^rgba?\(([^)]+)\)$/i);
+	if (!t) return;
+	let n = t[1].split("/")[0].split(",").map((e) => e.trim()).filter(Boolean);
+	if (n.length < 3) return;
+	let r = c(n[0]), i = c(n[1]), a = c(n[2]);
+	if (!(r === void 0 || i === void 0 || a === void 0)) return {
+		r,
+		g: i,
+		b: a
+	};
+}
+function f(e) {
+	let t = e.match(/^rgba?\(([^)]+)\)$/i);
+	if (!t) return;
+	let [n] = t[1].split("/"), r = n.trim().split(/\s+/).filter(Boolean);
+	if (r.length !== 3) return;
+	let i = c(r[0]), a = c(r[1]), o = c(r[2]);
+	if (!(i === void 0 || a === void 0 || o === void 0)) return {
+		r: i,
+		g: a,
+		b: o
+	};
+}
+function p(t) {
+	let n = t.match(/^hsla?\(([^)]+)\)$/i);
+	if (!n) return;
+	let [r] = n[1].split("/"), i = r.includes(",") ? "," : /\s+/, a = r.split(i).map((e) => e.trim()).filter(Boolean);
+	if (a.length < 3) return;
+	let o = l(a[0]), s = u(a[1]), c = u(a[2]);
+	if (!(o === void 0 || s === void 0 || c === void 0)) return e({
+		h: o,
+		s,
+		l: c
+	});
+}
+function m(e) {
+	return d(e) ?? f(e);
+}
+function h(e) {
+	let t = e.trim();
+	return s(t) ?? d(t) ?? f(t) ?? p(t);
+}
+function g(e) {
+	let t = h(e);
+	if (!t) throw Error("Invalid color format");
+	return t;
 }
 //#endregion
-export { e as isValidHex, n as parseColor, t as tryParseRgb };
+export { i as isValidHex, g as parseColor, h as tryParseColor, m as tryParseRgb };

package/esm/utils/color/theme-colors.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Theme utility color keys used for BEM classification via `isThemeColor` /
+ * `isUtilityColor`.
+ *
+ * Brand/semantic keys match the historical `$theme-colors` SCSS map. Color CSS
+ * vars for QButton / QBadge / QToast come from bound `useColor` styles rather
+ * than `$theme-colors` BEM loops. `background` remains a utility key so QButton
+ * can apply its hand-written `--background` modifier (and skip inline vars for
+ * that color). `container` is omitted (scheme resolve only).
+ */
+export declare const THEME_COLOR_KEYS: readonly ["primary", "secondary", "highlight", "info", "success", "warning", "danger", "neutral", "background"];
+/**
+ * A theme utility color key that resolves against the active color scheme.
+ */
+export type ThemeColorKey = (typeof THEME_COLOR_KEYS)[number];
+/**
+ * Checks whether a color string is a theme utility color key.
+ *
+ * Does not trim: BEM consumers build classes from the raw prop
+ * (`q-button--${color}`), so padded keys must not be classified as utilities
+ * or the modifier class would miss while the prop still looks theme-like.
+ *
+ * @param color - The color value to check.
+ * @returns True when the value matches a key in {@link THEME_COLOR_KEYS}.
+ */
+export declare function isThemeColor(color: string): color is ThemeColorKey;
+/**
+ * Checks whether a color string is an unsupported CSS keyword or function
+ * that cannot be resolved by `useColor`.
+ *
+ * @param color - The color value to check.
+ * @returns True for `transparent`, `currentColor`, `inherit`, and `var(...)`.
+ */
+export declare function isUnsupportedColor(color: string): boolean;
+//# sourceMappingURL=theme-colors.d.ts.map

package/esm/utils/color/theme-colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-colors.d.ts","sourceRoot":"","sources":["../../../src/utils/color/theme-colors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,iHAUnB,CAAA;AAEV;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAI7D;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,aAAa,CAElE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAIzD"}

package/esm/utils/color/theme-colors.js

@@ -0,0 +1,25 @@
+//#region src/utils/color/theme-colors.ts
+var e = [
+	"primary",
+	"secondary",
+	"highlight",
+	"info",
+	"success",
+	"warning",
+	"danger",
+	"neutral",
+	"background"
+], t = /* @__PURE__ */ new Set([
+	"transparent",
+	"currentcolor",
+	"inherit"
+]);
+function n(t) {
+	return e.includes(t);
+}
+function r(e) {
+	let n = e.trim().toLowerCase();
+	return t.has(n) || n.startsWith("var(");
+}
+//#endregion
+export { e as THEME_COLOR_KEYS, n as isThemeColor, r as isUnsupportedColor };