@cube-dev/ui-kit 0.176.0 → 0.178.0

package/dist/tokens/legacy-color.js

@@ -0,0 +1,58 @@
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
+import { parseSrgbColor } from "../utils/colors.js";
+import { srgbToHex } from "@tenphi/glaze";
+
+//#region src/tokens/legacy-color.ts
+/**
+* Convert a color literal — most usefully the `oklch(...)` a color token
+* resolves to — into a hex or `rgba()` string.
+*
+* ```ts
+* toLegacyColor(resolveTokenValue('#purple')); // '#6147d6'
+* toLegacyColor('oklch(0.55 0.21 285 / 0.4)'); // 'rgba(97, 71, 214, 0.4)'
+* toLegacyColor('oklch(0.55 0.21 285 / 0.4)', { alpha: 'hex' }); // '#6147d666'
+* ```
+*
+* Takes `null` / `undefined` so it composes with `resolveTokenValue()` without
+* a null check, and reads every notation the kit emits or accepts: `oklch()`,
+* `okhsl()`, `okhst()`, `rgb()`, `hsl()`, hex (3/4/6/8 digits) and
+* `transparent`, in either the modern slash or the legacy comma alpha syntax.
+*
+* Returns `options.fallback ?? null` rather than the input when the value
+* cannot be read — a color that is not `oklch()` but still not legacy-safe is
+* the failure this helper exists to prevent, so handing it back would defeat
+* the purpose. Named colors other than `transparent`, `color-mix()` and
+* relative syntax (`oklch(from …)`) are all unreadable here, the last two
+* because their value only exists inside a CSS engine.
+*/
+function toLegacyColor(value, options = {}) {
+	const { alpha: format = "rgba", fallback = null } = options;
+	if (typeof value !== "string") return fallback;
+	const parsed = parseSrgbColor(value);
+	if (!parsed) return fallback;
+	const hex = srgbToHex(parsed.rgb);
+	if (parsed.alpha >= 1) return hex;
+	if (format === "hex") return `${hex}${toHexByte(parsed.alpha)}`;
+	const [r, g, b] = parsed.rgb.map(toByte);
+	return `rgba(${r}, ${g}, ${b}, ${round(parsed.alpha)})`;
+}
+/**
+* 8-bit channels rather than the fractional ones `formatRgb()` emits. The point
+* of this helper is a value a *legacy* parser accepts, and those commonly read
+* channels with an integer parse; the hex form is 8-bit regardless, so this also
+* keeps the two output forms describing the same color.
+*/
+function toByte(channel) {
+	return Math.round(Math.min(Math.max(channel, 0), 1) * 255);
+}
+function toHexByte(alpha) {
+	return toByte(alpha).toString(16).padStart(2, "0");
+}
+/** Three decimals is finer than the 8-bit alpha the hex form can carry. */
+function round(alpha) {
+	return Math.round(alpha * 1e3) / 1e3;
+}
+
+//#endregion
+export { toLegacyColor };
+//# sourceMappingURL=legacy-color.js.map

package/dist/tokens/legacy-color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-color.js","names":[],"sources":["../../src/tokens/legacy-color.ts"],"sourcesContent":["import { srgbToHex } from '@tenphi/glaze';\n\nimport { parseSrgbColor } from '../utils/colors';\n\n/**\n * Converting a resolved color token into a form a third-party parser will\n * actually accept.\n *\n * Since Glaze every color token computes to `oklch(...)`, and a large class of\n * consumers validates colors against \"HEX, `rgb()`, or `hsl()`\" and *silently\n * drops* anything else — Stripe's Appearance API falls back to its own light\n * theme, `d3-color` (so Vega) throws, mapbox-gl's `csscolorparser` rejects even\n * an `#rrggbbaa` tail. A round trip through the DOM does not normalize it:\n * Chrome serializes `oklch` back as `oklch`.\n *\n * So the value `resolveTokenValue()` hands back is correct and unusable at the\n * same time, and this is the step between them.\n */\n\n/** Output form for a *translucent* color — see {@link ToLegacyColorOptions}. */\nexport type LegacyAlphaFormat = 'rgba' | 'hex';\n\nexport interface ToLegacyColorOptions {\n  /**\n   * How to carry alpha when the color is translucent. An opaque color is always\n   * `#rrggbb`, which every consumer accepts.\n   *\n   * - `'rgba'` (default) — `rgba(97, 71, 214, 0.4)`. The widest form: Stripe\n   *   takes it, mapbox-gl takes it, CSS takes it.\n   * - `'hex'` — `#rrggbbaa`. Shorter, and what Vega and plain CSS prefer, but\n   *   mapbox-gl's hex branch accepts only `#rgb` / `#rrggbb` and will drop it.\n   *\n   * When in doubt keep the default; pick `'hex'` only for a consumer known to\n   * read the tail.\n   */\n  alpha?: LegacyAlphaFormat;\n  /** Returned in place of `null` when the input is not a color we can read. */\n  fallback?: string;\n}\n\n/**\n * Convert a color literal — most usefully the `oklch(...)` a color token\n * resolves to — into a hex or `rgba()` string.\n *\n * ```ts\n * toLegacyColor(resolveTokenValue('#purple')); // '#6147d6'\n * toLegacyColor('oklch(0.55 0.21 285 / 0.4)'); // 'rgba(97, 71, 214, 0.4)'\n * toLegacyColor('oklch(0.55 0.21 285 / 0.4)', { alpha: 'hex' }); // '#6147d666'\n * ```\n *\n * Takes `null` / `undefined` so it composes with `resolveTokenValue()` without\n * a null check, and reads every notation the kit emits or accepts: `oklch()`,\n * `okhsl()`, `okhst()`, `rgb()`, `hsl()`, hex (3/4/6/8 digits) and\n * `transparent`, in either the modern slash or the legacy comma alpha syntax.\n *\n * Returns `options.fallback ?? null` rather than the input when the value\n * cannot be read — a color that is not `oklch()` but still not legacy-safe is\n * the failure this helper exists to prevent, so handing it back would defeat\n * the purpose. Named colors other than `transparent`, `color-mix()` and\n * relative syntax (`oklch(from …)`) are all unreadable here, the last two\n * because their value only exists inside a CSS engine.\n */\nexport function toLegacyColor(\n  value: string | null | undefined,\n  options: ToLegacyColorOptions = {},\n): string | null {\n  const { alpha: format = 'rgba', fallback = null } = options;\n\n  if (typeof value !== 'string') return fallback;\n\n  const parsed = parseSrgbColor(value);\n\n  if (!parsed) return fallback;\n\n  const hex = srgbToHex(parsed.rgb);\n\n  if (parsed.alpha >= 1) return hex;\n\n  if (format === 'hex') return `${hex}${toHexByte(parsed.alpha)}`;\n\n  const [r, g, b] = parsed.rgb.map(toByte);\n\n  return `rgba(${r}, ${g}, ${b}, ${round(parsed.alpha)})`;\n}\n\n/**\n * 8-bit channels rather than the fractional ones `formatRgb()` emits. The point\n * of this helper is a value a *legacy* parser accepts, and those commonly read\n * channels with an integer parse; the hex form is 8-bit regardless, so this also\n * keeps the two output forms describing the same color.\n */\nfunction toByte(channel: number): number {\n  return Math.round(Math.min(Math.max(channel, 0), 1) * 255);\n}\n\nfunction toHexByte(alpha: number): string {\n  return toByte(alpha).toString(16).padStart(2, '0');\n}\n\n/** Three decimals is finer than the 8-bit alpha the hex form can carry. */\nfunction round(alpha: number): number {\n  return Math.round(alpha * 1000) / 1000;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA8DA,SAAgB,cACd,OACA,UAAgC,EAAE,EACnB;CACf,MAAM,EAAE,OAAO,SAAS,QAAQ,WAAW,SAAS;AAEpD,KAAI,OAAO,UAAU,SAAU,QAAO;CAEtC,MAAM,SAAS,eAAe,MAAM;AAEpC,KAAI,CAAC,OAAQ,QAAO;CAEpB,MAAM,MAAM,UAAU,OAAO,IAAI;AAEjC,KAAI,OAAO,SAAS,EAAG,QAAO;AAE9B,KAAI,WAAW,MAAO,QAAO,GAAG,MAAM,UAAU,OAAO,MAAM;CAE7D,MAAM,CAAC,GAAG,GAAG,KAAK,OAAO,IAAI,IAAI,OAAO;AAExC,QAAO,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,MAAM,OAAO,MAAM,CAAC;;;;;;;;AASvD,SAAS,OAAO,SAAyB;AACvC,QAAO,KAAK,MAAM,KAAK,IAAI,KAAK,IAAI,SAAS,EAAE,EAAE,EAAE,GAAG,IAAI;;AAG5D,SAAS,UAAU,OAAuB;AACxC,QAAO,OAAO,MAAM,CAAC,SAAS,GAAG,CAAC,SAAS,GAAG,IAAI;;;AAIpD,SAAS,MAAM,OAAuB;AACpC,QAAO,KAAK,MAAM,QAAQ,IAAK,GAAG"}

package/dist/tokens/palette-config.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 import { colorSeed } from "./color-seed.js";
 import { useSyncExternalStore } from "react";
 

package/dist/tokens/palette.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 import { SURFACE_SATURATION_SHARE, getPaletteConfig, getPaletteVersion, resolvePaletteConfig } from "./palette-config.js";
 import { lazyStyles } from "./lazy-styles.js";
 import { apcaContrast, glaze, okhslToLinearSrgb, variantToOkhsl } from "@tenphi/glaze";

package/dist/tokens/resolve.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "../utils/react/useLayoutEffect.js";
 import { subscribeScheme } from "../utils/react/useScheme.js";
 import { warn } from "../utils/warnings.js";

package/dist/tokens/shadows.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 //#region src/tokens/shadows.ts
 /**
 * Shadow tokens using tasty shorthand syntax.

package/dist/tokens/sizes.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 //#region src/tokens/sizes.ts
 /**
 * Component size values in pixels.

package/dist/tokens/spacing.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 //#region src/tokens/spacing.ts
 /**
 * Spacing tokens using tasty multiplier syntax.

package/dist/tokens/typography.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 //#region src/tokens/typography.ts
 /**
 * Typography presets for headings, text, and special styles.

package/dist/utils/ResizeSensor.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 //#region src/utils/ResizeSensor.ts
 /**
 * Iterate over each of the provided element(s).

package/dist/utils/colors.d.ts

@@ -0,0 +1,2 @@
+
+import "@tenphi/glaze";

package/dist/utils/colors.js

@@ -0,0 +1,257 @@
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
+import { hslToSrgb, okhslToOklch, okhslToSrgb, okhstToOkhsl, oklabToOkhsl, parseHexAlpha } from "@tenphi/glaze";
+
+//#region src/utils/colors.ts
+/**
+* Reading a CSS color *literal* into channels — the layer under both the color
+* fields (which parse what a user types) and {@link toLegacyColor} (which parses
+* what `resolveTokenValue()` hands back).
+*
+* It lives here rather than in either consumer because the two need the same
+* grammar and disagreeing about it is invisible: a component this parser fails
+* to recognise does not throw, it makes the whole color unparseable, and the
+* caller falls back to something that merely looks plausible. The cases that
+* actually show up — a negative hue, a `none` component, scientific notation
+* out of a serializer, `oklch(from …)` relative syntax — are exactly the ones a
+* hand-rolled regex misses.
+*
+* Named CSS colors (`red`, `rebeccapurple`) are deliberately not supported,
+* matching `glaze.color()`. `transparent` is the one exception, because the kit
+* declares it: `#clear` is `transparent`.
+*/
+const FUNCTION_RE = /^([a-z]+)\(([^()]+)\)$/;
+/**
+* A number with an optional unit, both captured in one pass.
+*
+* This runs on whatever the user types, so it is written to stay linear in two
+* separate ways. The integer and fraction parts are arranged so that no two
+* quantifiers can consume the same digit — `\d+(?:\.\d*)?` rather than
+* `\d+\.?\d*`, whose `\d+` and `\d*` can split a digit run n ways and make
+* rejecting a long one quadratic. And the unit is a capture group here rather
+* than a second, unanchored scan: reading it back with `/[a-z%]+$/` is itself
+* polynomial (CodeQL `js/polynomial-redos`), because every start position
+* re-walks the run of unit characters before failing at `$` — quadratic on a
+* string of many `%`.
+*/
+const NUMBER_RE = /^([+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?)(%|deg|rad|grad|turn)?$/;
+/** Degrees per unit, for the angle units `<hue>` accepts. */
+const ANGLE_UNITS = {
+	deg: 1,
+	rad: 180 / Math.PI,
+	grad: .9,
+	turn: 360
+};
+/**
+* `none` is a real component value, not a parse failure. Outside interpolation
+* and relative-color syntax CSS Color 4 resolves it to zero, which is what every
+* caller here wants — `oklch(0.5 none 200)` is a grey, and `… / none` is
+* invisible rather than unparseable.
+*/
+const NONE = "none";
+/** A component we can read: a number with an optional unit, or `none`. */
+function isComponent(arg) {
+	return arg === NONE || NUMBER_RE.test(arg);
+}
+/** Read a numeric component and its unit together, or `null` if it is neither. */
+function readNumber(arg) {
+	const match = NUMBER_RE.exec(arg);
+	return match ? {
+		value: parseFloat(match[1]),
+		unit: match[2] ?? ""
+	} : null;
+}
+function normalizeHue(hue) {
+	if (!Number.isFinite(hue)) return 0;
+	return (hue % 360 + 360) % 360;
+}
+/**
+* Split a color-function literal into its name, components and alpha. Both the
+* modern space-separated (`rgb(0 0 0 / 50%)`) and legacy comma-separated
+* (`rgba(0, 0, 0, 0.5)`) syntaxes are accepted.
+*
+* Returns `null` for anything that is not a plain color-function call, which
+* includes the two forms whose value cannot be worked out without a CSS engine:
+* relative syntax (`oklch(from var(--x) l c h)`) and `color-mix()`. Rejecting
+* them is the point — passing them through unchanged is what makes a consumer
+* silently drop the color.
+*/
+function parseColorFunction(input) {
+	const match = FUNCTION_RE.exec(input.trim().toLowerCase());
+	if (!match) return null;
+	const [, name, body] = match;
+	const [components, ...rest] = body.split("/");
+	if (rest.length > 1) return null;
+	let alpha = rest.length ? rest[0].trim() : null;
+	const args = components.trim().split(components.includes(",") ? "," : /\s+/).map((part) => part.trim()).filter(Boolean);
+	if (args.length === 4) {
+		if (alpha !== null) return null;
+		alpha = args.pop();
+	}
+	if (alpha !== null && !isComponent(alpha)) return null;
+	return args.every(isComponent) ? {
+		name,
+		args,
+		alpha
+	} : null;
+}
+/**
+* Read a non-hue component. `scale` is what `100%` means in this position;
+* `none` is zero, and an angle is not a value this position accepts.
+*/
+function readComponent(arg, scale) {
+	if (arg === NONE) return 0;
+	const parsed = readNumber(arg);
+	if (!parsed) return NaN;
+	if (parsed.unit === "%") return parsed.value / 100 * scale;
+	return parsed.unit ? NaN : parsed.value;
+}
+/** Read a `<hue>`: any angle unit, or a bare number of degrees. Normalized. */
+function readHue(arg) {
+	if (arg === NONE) return 0;
+	const parsed = readNumber(arg);
+	if (!parsed) return NaN;
+	if (parsed.unit === "%") return NaN;
+	const perDegree = parsed.unit ? ANGLE_UNITS[parsed.unit] : 1;
+	return perDegree === void 0 ? NaN : normalizeHue(parsed.value * perDegree);
+}
+/** Read an `<alpha-value>`. A missing alpha is opaque; out of range is clamped. */
+function readAlpha(arg) {
+	if (arg === null) return 1;
+	const alpha = readComponent(arg, 1);
+	return Number.isFinite(alpha) ? clamp(alpha, 0, 1) : NaN;
+}
+function clamp(value, min, max) {
+	return value < min ? min : value > max ? max : value;
+}
+function anyNaN(...values) {
+	return values.some((value) => !Number.isFinite(value));
+}
+/**
+* The largest OKLCh chroma that stays inside the sRGB gamut for the given hue
+* and OKHSL lightness — that is exactly what OKHSL saturation `1` means.
+*/
+function maxChroma(hue, lightness) {
+	return okhslToOklch(normalizeHue(hue), 1, clamp(lightness, 0, 1))[1];
+}
+/**
+* OKLCh addresses colors outside the sRGB gamut, so chroma is clipped to the
+* gamut boundary at the requested lightness. Hue is taken from the input rather
+* than from the conversion, which loses it at zero chroma.
+*/
+function oklchToOkhsl(color) {
+	const h = normalizeHue(color.h);
+	const c = Math.max(color.c, 0);
+	const radians = h * Math.PI / 180;
+	const [, s, l] = oklabToOkhsl([
+		clamp(color.l, 0, 1),
+		c * Math.cos(radians),
+		c * Math.sin(radians)
+	]);
+	const limit = maxChroma(h, l);
+	return {
+		h,
+		s: limit > 0 ? c >= limit ? 1 : clamp(s, 0, 1) : 0,
+		l: clamp(l, 0, 1)
+	};
+}
+function rgbFromSrgb([r, g, b]) {
+	return {
+		r: r * 255,
+		g: g * 255,
+		b: b * 255
+	};
+}
+/**
+* Read any color literal the kit can emit or accept into gamma-encoded sRGB
+* channels plus alpha — the space every legacy consumer speaks.
+*
+* Returns `null` when the input is not a color, or is one whose value depends on
+* a CSS engine we do not have (see {@link parseColorFunction}).
+*/
+function parseSrgbColor(input) {
+	const text = input.trim().toLowerCase();
+	if (!text) return null;
+	if (text === "transparent") return {
+		rgb: [
+			0,
+			0,
+			0
+		],
+		alpha: 0
+	};
+	if (text.startsWith("#")) {
+		const parsed = parseHexAlpha(text);
+		return parsed ? {
+			rgb: parsed.rgb,
+			alpha: parsed.alpha ?? 1
+		} : null;
+	}
+	const parsed = parseColorFunction(text);
+	if (!parsed || parsed.args.length !== 3) return null;
+	const { name, args } = parsed;
+	const alpha = readAlpha(parsed.alpha);
+	if (!Number.isFinite(alpha)) return null;
+	const rgb = toSrgbChannels(name, args);
+	return rgb ? {
+		rgb,
+		alpha
+	} : null;
+}
+function toSrgbChannels(name, args) {
+	switch (name) {
+		case "rgb":
+		case "rgba": {
+			const [r, g, b] = args.map((arg) => readComponent(arg, 255));
+			if (anyNaN(r, g, b)) return null;
+			return [
+				clamp(r / 255, 0, 1),
+				clamp(g / 255, 0, 1),
+				clamp(b / 255, 0, 1)
+			];
+		}
+		case "hsl":
+		case "hsla": {
+			const h = readHue(args[0]);
+			const s = readComponent(args[1], 100) / 100;
+			const l = readComponent(args[2], 100) / 100;
+			if (anyNaN(h, s, l)) return null;
+			return hslToSrgb(h, clamp(s, 0, 1), clamp(l, 0, 1));
+		}
+		case "okhsl": {
+			const h = readHue(args[0]);
+			const s = readComponent(args[1], 100) / 100;
+			const l = readComponent(args[2], 100) / 100;
+			if (anyNaN(h, s, l)) return null;
+			return okhslToSrgb(h, clamp(s, 0, 1), clamp(l, 0, 1));
+		}
+		case "okhst": {
+			const h = readHue(args[0]);
+			const s = readComponent(args[1], 100) / 100;
+			const t = readComponent(args[2], 100) / 100;
+			if (anyNaN(h, s, t)) return null;
+			const okhsl = okhstToOkhsl({
+				h,
+				s: clamp(s, 0, 1),
+				t: clamp(t, 0, 1)
+			});
+			return okhslToSrgb(normalizeHue(okhsl.h), clamp(okhsl.s, 0, 1), clamp(okhsl.l, 0, 1));
+		}
+		case "oklch": {
+			const l = readComponent(args[0], 1);
+			const c = readComponent(args[1], .4);
+			const h = readHue(args[2]);
+			if (anyNaN(l, c, h)) return null;
+			const okhsl = oklchToOkhsl({
+				l,
+				c,
+				h
+			});
+			return okhslToSrgb(okhsl.h, okhsl.s, okhsl.l);
+		}
+		default: return null;
+	}
+}
+
+//#endregion
+export { anyNaN, clamp, maxChroma, normalizeHue, oklchToOkhsl, parseColorFunction, parseSrgbColor, readComponent, readHue, rgbFromSrgb };
+//# sourceMappingURL=colors.js.map

package/dist/utils/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","names":[],"sources":["../../src/utils/colors.ts"],"sourcesContent":["import {\n  hslToSrgb,\n  okhslToOklch,\n  okhslToSrgb,\n  okhstToOkhsl,\n  oklabToOkhsl,\n  parseHexAlpha,\n} from '@tenphi/glaze';\n\nimport type { OkhslColor, OklchColor, RgbColor } from '@tenphi/glaze';\n\n/**\n * Reading a CSS color *literal* into channels — the layer under both the color\n * fields (which parse what a user types) and {@link toLegacyColor} (which parses\n * what `resolveTokenValue()` hands back).\n *\n * It lives here rather than in either consumer because the two need the same\n * grammar and disagreeing about it is invisible: a component this parser fails\n * to recognise does not throw, it makes the whole color unparseable, and the\n * caller falls back to something that merely looks plausible. The cases that\n * actually show up — a negative hue, a `none` component, scientific notation\n * out of a serializer, `oklch(from …)` relative syntax — are exactly the ones a\n * hand-rolled regex misses.\n *\n * Named CSS colors (`red`, `rebeccapurple`) are deliberately not supported,\n * matching `glaze.color()`. `transparent` is the one exception, because the kit\n * declares it: `#clear` is `transparent`.\n */\n\nconst FUNCTION_RE = /^([a-z]+)\\(([^()]+)\\)$/;\n\n/**\n * A number with an optional unit, both captured in one pass.\n *\n * This runs on whatever the user types, so it is written to stay linear in two\n * separate ways. The integer and fraction parts are arranged so that no two\n * quantifiers can consume the same digit — `\\d+(?:\\.\\d*)?` rather than\n * `\\d+\\.?\\d*`, whose `\\d+` and `\\d*` can split a digit run n ways and make\n * rejecting a long one quadratic. And the unit is a capture group here rather\n * than a second, unanchored scan: reading it back with `/[a-z%]+$/` is itself\n * polynomial (CodeQL `js/polynomial-redos`), because every start position\n * re-walks the run of unit characters before failing at `$` — quadratic on a\n * string of many `%`.\n */\nconst NUMBER_RE =\n  /^([+-]?(?:\\d+(?:\\.\\d*)?|\\.\\d+)(?:e[+-]?\\d+)?)(%|deg|rad|grad|turn)?$/;\n\n/** Degrees per unit, for the angle units `<hue>` accepts. */\nconst ANGLE_UNITS: Record<string, number> = {\n  deg: 1,\n  rad: 180 / Math.PI,\n  grad: 0.9,\n  turn: 360,\n};\n\n/**\n * `none` is a real component value, not a parse failure. Outside interpolation\n * and relative-color syntax CSS Color 4 resolves it to zero, which is what every\n * caller here wants — `oklch(0.5 none 200)` is a grey, and `… / none` is\n * invisible rather than unparseable.\n */\nconst NONE = 'none';\n\n/** A component we can read: a number with an optional unit, or `none`. */\nfunction isComponent(arg: string): boolean {\n  return arg === NONE || NUMBER_RE.test(arg);\n}\n\n/** A component's magnitude and its unit, `''` when it is a bare number. */\ninterface NumericComponent {\n  value: number;\n  unit: string;\n}\n\n/** Read a numeric component and its unit together, or `null` if it is neither. */\nfunction readNumber(arg: string): NumericComponent | null {\n  const match = NUMBER_RE.exec(arg);\n\n  return match ? { value: parseFloat(match[1]), unit: match[2] ?? '' } : null;\n}\n\nexport function normalizeHue(hue: number): number {\n  if (!Number.isFinite(hue)) return 0;\n\n  return ((hue % 360) + 360) % 360;\n}\n\n/**\n * A color-function call split into its parts, with alpha separated out. Each\n * component keeps its unit, so the caller can tell `50%` from `50` — what a\n * percentage means is per space and per position (`oklch()`'s `100%` is `1` for\n * lightness and `0.4` for chroma), so only the caller can scale it.\n */\nexport interface ColorFunction {\n  /** Lowercased function name — `'oklch'`, `'rgba'`, `'okhst'`. */\n  name: string;\n  /** The color components, alpha excluded. */\n  args: string[];\n  /** The alpha component as written, or `null` when the call omits it. */\n  alpha: string | null;\n}\n\n/**\n * Split a color-function literal into its name, components and alpha. Both the\n * modern space-separated (`rgb(0 0 0 / 50%)`) and legacy comma-separated\n * (`rgba(0, 0, 0, 0.5)`) syntaxes are accepted.\n *\n * Returns `null` for anything that is not a plain color-function call, which\n * includes the two forms whose value cannot be worked out without a CSS engine:\n * relative syntax (`oklch(from var(--x) l c h)`) and `color-mix()`. Rejecting\n * them is the point — passing them through unchanged is what makes a consumer\n * silently drop the color.\n */\nexport function parseColorFunction(input: string): ColorFunction | null {\n  const match = FUNCTION_RE.exec(input.trim().toLowerCase());\n\n  if (!match) return null;\n\n  const [, name, body] = match;\n  const [components, ...rest] = body.split('/');\n\n  // More than one slash is never valid syntax.\n  if (rest.length > 1) return null;\n\n  let alpha: string | null = rest.length ? rest[0].trim() : null;\n\n  const args = components\n    .trim()\n    .split(components.includes(',') ? ',' : /\\s+/)\n    .map((part) => part.trim())\n    .filter(Boolean);\n\n  // A fourth component is alpha — that is the legacy `rgba(r, g, b, a)` /\n  // `hsla(h, s, l, a)` form, and the same reading is the useful one for a\n  // space-separated four-tuple someone typed without the slash.\n  if (args.length === 4) {\n    // `rgba(0, 0, 0, 1 / 0.5)` names alpha twice.\n    if (alpha !== null) return null;\n\n    alpha = args.pop()!;\n  }\n\n  if (alpha !== null && !isComponent(alpha)) return null;\n\n  return args.every(isComponent) ? { name, args, alpha } : null;\n}\n\n/**\n * Read a non-hue component. `scale` is what `100%` means in this position;\n * `none` is zero, and an angle is not a value this position accepts.\n */\nexport function readComponent(arg: string, scale: number): number {\n  if (arg === NONE) return 0;\n\n  const parsed = readNumber(arg);\n\n  if (!parsed) return NaN;\n\n  if (parsed.unit === '%') return (parsed.value / 100) * scale;\n\n  return parsed.unit ? NaN : parsed.value;\n}\n\n/** Read a `<hue>`: any angle unit, or a bare number of degrees. Normalized. */\nexport function readHue(arg: string): number {\n  if (arg === NONE) return 0;\n\n  const parsed = readNumber(arg);\n\n  if (!parsed) return NaN;\n\n  // A percentage is not a valid hue angle.\n  if (parsed.unit === '%') return NaN;\n\n  // Every unit {@link NUMBER_RE} captures other than `%` is an angle, so the\n  // guard is unreachable today. It stays because a unit added there later — a\n  // length, say — would otherwise arrive here and be read as degrees.\n  const perDegree = parsed.unit ? ANGLE_UNITS[parsed.unit] : 1;\n\n  return perDegree === undefined ? NaN : normalizeHue(parsed.value * perDegree);\n}\n\n/** Read an `<alpha-value>`. A missing alpha is opaque; out of range is clamped. */\nexport function readAlpha(arg: string | null): number {\n  if (arg === null) return 1;\n\n  const alpha = readComponent(arg, 1);\n\n  return Number.isFinite(alpha) ? clamp(alpha, 0, 1) : NaN;\n}\n\nexport function clamp(value: number, min: number, max: number): number {\n  return value < min ? min : value > max ? max : value;\n}\n\nexport function anyNaN(...values: number[]): boolean {\n  return values.some((value) => !Number.isFinite(value));\n}\n\n/**\n * The largest OKLCh chroma that stays inside the sRGB gamut for the given hue\n * and OKHSL lightness — that is exactly what OKHSL saturation `1` means.\n */\nexport function maxChroma(hue: number, lightness: number): number {\n  return okhslToOklch(normalizeHue(hue), 1, clamp(lightness, 0, 1))[1];\n}\n\n/**\n * OKLCh addresses colors outside the sRGB gamut, so chroma is clipped to the\n * gamut boundary at the requested lightness. Hue is taken from the input rather\n * than from the conversion, which loses it at zero chroma.\n */\nexport function oklchToOkhsl(color: OklchColor): OkhslColor {\n  const h = normalizeHue(color.h);\n  const c = Math.max(color.c, 0);\n  const radians = (h * Math.PI) / 180;\n  const [, s, l] = oklabToOkhsl([\n    clamp(color.l, 0, 1),\n    c * Math.cos(radians),\n    c * Math.sin(radians),\n  ]);\n  const limit = maxChroma(h, l);\n\n  return {\n    h,\n    s: limit > 0 ? (c >= limit ? 1 : clamp(s, 0, 1)) : 0,\n    l: clamp(l, 0, 1),\n  };\n}\n\nexport function rgbFromSrgb([r, g, b]: [number, number, number]): RgbColor {\n  return { r: r * 255, g: g * 255, b: b * 255 };\n}\n\n/** Gamma-encoded sRGB channels in 0–1, plus alpha in 0–1. */\nexport interface SrgbColor {\n  rgb: [number, number, number];\n  alpha: number;\n}\n\n/**\n * Read any color literal the kit can emit or accept into gamma-encoded sRGB\n * channels plus alpha — the space every legacy consumer speaks.\n *\n * Returns `null` when the input is not a color, or is one whose value depends on\n * a CSS engine we do not have (see {@link parseColorFunction}).\n */\nexport function parseSrgbColor(input: string): SrgbColor | null {\n  const text = input.trim().toLowerCase();\n\n  if (!text) return null;\n\n  // The one named color the kit declares: `#clear` is `transparent`. Browsers\n  // compute it to `rgba(0, 0, 0, 0)`, but a token block read outside a browser\n  // hands back the keyword as authored.\n  if (text === 'transparent') return { rgb: [0, 0, 0], alpha: 0 };\n\n  if (text.startsWith('#')) {\n    const parsed = parseHexAlpha(text);\n\n    return parsed ? { rgb: parsed.rgb, alpha: parsed.alpha ?? 1 } : null;\n  }\n\n  const parsed = parseColorFunction(text);\n\n  if (!parsed || parsed.args.length !== 3) return null;\n\n  const { name, args } = parsed;\n  const alpha = readAlpha(parsed.alpha);\n\n  if (!Number.isFinite(alpha)) return null;\n\n  const rgb = toSrgbChannels(name, args);\n\n  return rgb ? { rgb, alpha } : null;\n}\n\nfunction toSrgbChannels(\n  name: string,\n  args: string[],\n): [number, number, number] | null {\n  switch (name) {\n    case 'rgb':\n    case 'rgba': {\n      const [r, g, b] = args.map((arg) => readComponent(arg, 255));\n\n      if (anyNaN(r, g, b)) return null;\n\n      return [clamp(r / 255, 0, 1), clamp(g / 255, 0, 1), clamp(b / 255, 0, 1)];\n    }\n    case 'hsl':\n    case 'hsla': {\n      const h = readHue(args[0]);\n      const s = readComponent(args[1], 100) / 100;\n      const l = readComponent(args[2], 100) / 100;\n\n      if (anyNaN(h, s, l)) return null;\n\n      return hslToSrgb(h, clamp(s, 0, 1), clamp(l, 0, 1));\n    }\n    case 'okhsl': {\n      const h = readHue(args[0]);\n      const s = readComponent(args[1], 100) / 100;\n      const l = readComponent(args[2], 100) / 100;\n\n      if (anyNaN(h, s, l)) return null;\n\n      return okhslToSrgb(h, clamp(s, 0, 1), clamp(l, 0, 1));\n    }\n    case 'okhst': {\n      const h = readHue(args[0]);\n      const s = readComponent(args[1], 100) / 100;\n      const t = readComponent(args[2], 100) / 100;\n\n      if (anyNaN(h, s, t)) return null;\n\n      const okhsl = okhstToOkhsl({\n        h,\n        s: clamp(s, 0, 1),\n        t: clamp(t, 0, 1),\n      });\n\n      return okhslToSrgb(\n        normalizeHue(okhsl.h),\n        clamp(okhsl.s, 0, 1),\n        clamp(okhsl.l, 0, 1),\n      );\n    }\n    case 'oklch': {\n      // In `oklch()` a percentage means 1 for lightness and 0.4 for chroma.\n      const l = readComponent(args[0], 1);\n      const c = readComponent(args[1], 0.4);\n      const h = readHue(args[2]);\n\n      if (anyNaN(l, c, h)) return null;\n\n      const okhsl = oklchToOkhsl({ l, c, h });\n\n      return okhslToSrgb(okhsl.h, okhsl.s, okhsl.l);\n    }\n    default:\n      return null;\n  }\n}\n"],"mappings":"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"}

package/dist/utils/is-dev-env.js

@@ -1,15 +1,73 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 //#region src/utils/is-dev-env.ts
-function isDevEnv() {
-	if (typeof window !== "undefined" && window.localStorage) try {
-		const flag = window.localStorage.getItem("UIKIT_DEBUG");
-		if (flag !== null && flag.toLowerCase() === "true") return true;
+/**
+* `NODE_ENV` as the environment that is actually running reports it, or
+* `undefined` when nothing can say.
+*
+* The one place in ui-kit allowed to read `NODE_ENV`, because it is the one
+* place that has to survive the build unfolded. A comparison compiled into
+* `dist` freezes whatever `NODE_ENV` the release machine exported and hands
+* every consumer the same answer, so `tsdown.config.ts` defines the expression
+* as itself to stop rolldown inlining it - see the comment there.
+*/
+function readNodeEnv() {
+	try {
+		return process.env.NODE_ENV;
+	} catch {
+		return;
+	}
+}
+/**
+* `localStorage.UIKIT_DEBUG` as a tri-state: an explicit `"true"` forces ui-kit's
+* diagnostics on and an explicit `"false"` forces them off, in any environment.
+*
+* The escape hatch in both directions. Consumers whose production build somehow
+* resolves to development can silence us without waiting for a release, and
+* anyone debugging a built app can switch us back on.
+*/
+function readDebugFlag() {
+	if (typeof window === "undefined" || !window.localStorage) return void 0;
+	try {
+		const flag = window.localStorage.getItem("UIKIT_DEBUG")?.toLowerCase();
+		if (flag === "true") return true;
+		if (flag === "false") return false;
 	} catch {}
-	if (typeof process === "undefined") return false;
-	const nodeEnv = "development";
+}
+/**
+* Whether to run diagnostics that only a human looking at the page can act on -
+* a warning drawn into the layout, a complaint about a measurement.
+*
+* Off under `test`: jsdom reports `offsetHeight: 0` for everything, so anything
+* keyed off a measurement is not just noisy in a consumer's test run but wrong.
+* Off under `production`, and off when nobody could say what `NODE_ENV` is -
+* a diagnostic shown to end users is worse than a missing one shown to a
+* developer, who still has `UIKIT_DEBUG`.
+*
+* Use {@link isDevEnvOrTest} instead for diagnostics a test run should surface.
+*/
+function isDevEnv() {
+	const flag = readDebugFlag();
+	if (flag !== void 0) return flag;
+	const nodeEnv = readNodeEnv();
+	if (nodeEnv === void 0) return false;
 	return nodeEnv !== "test" && nodeEnv !== "production";
 }
+/**
+* Like {@link isDevEnv}, but on under `test` as well.
+*
+* For diagnostics a consumer's test run should still surface - deprecation
+* warnings above all. "You are passing a prop we are about to remove" is worth
+* hearing from CI, and unlike a collapsed-height complaint it cannot be wrong
+* just because jsdom has no layout.
+*/
+function isDevEnvOrTest() {
+	const flag = readDebugFlag();
+	if (flag !== void 0) return flag;
+	const nodeEnv = readNodeEnv();
+	if (nodeEnv === void 0) return false;
+	return nodeEnv !== "production";
+}
 
 //#endregion
-export { isDevEnv };
+export { isDevEnv, isDevEnvOrTest };
 //# sourceMappingURL=is-dev-env.js.map

package/dist/utils/is-dev-env.js.map

@@ -1 +1 @@
-{"version":3,"file":"is-dev-env.js","names":[],"sources":["../../src/utils/is-dev-env.ts"],"sourcesContent":["export function isDevEnv(): boolean {\n  if (typeof window !== 'undefined' && window.localStorage) {\n    try {\n      const flag = window.localStorage.getItem('UIKIT_DEBUG');\n      if (flag !== null && flag.toLowerCase() === 'true') return true;\n    } catch {\n      // localStorage might not be available (private browsing, etc.)\n    }\n  }\n  if (typeof process === 'undefined') return false;\n  const nodeEnv = process.env?.['NODE_ENV'];\n  return nodeEnv !== 'test' && nodeEnv !== 'production';\n}\n"],"mappings":";;AAAA,SAAgB,WAAoB;AAClC,KAAI,OAAO,WAAW,eAAe,OAAO,aAC1C,KAAI;EACF,MAAM,OAAO,OAAO,aAAa,QAAQ,cAAc;AACvD,MAAI,SAAS,QAAQ,KAAK,aAAa,KAAK,OAAQ,QAAO;SACrD;AAIV,KAAI,OAAO,YAAY,YAAa,QAAO;CAC3C,MAAM;AACN,QAAO,YAAY,UAAU,YAAY"}
+{"version":3,"file":"is-dev-env.js","names":[],"sources":["../../src/utils/is-dev-env.ts"],"sourcesContent":["/**\n * `NODE_ENV` as the environment that is actually running reports it, or\n * `undefined` when nothing can say.\n *\n * The one place in ui-kit allowed to read `NODE_ENV`, because it is the one\n * place that has to survive the build unfolded. A comparison compiled into\n * `dist` freezes whatever `NODE_ENV` the release machine exported and hands\n * every consumer the same answer, so `tsdown.config.ts` defines the expression\n * as itself to stop rolldown inlining it - see the comment there.\n */\nfunction readNodeEnv(): string | undefined {\n  try {\n    // Deliberately unguarded by `typeof process`: a guard would also gate the\n    // *substituted* value, and browser bundlers replace this read without\n    // defining `process` itself - so `typeof process === 'undefined'` is true\n    // in a Vite dev build that just told us NODE_ENV is \"development\". The\n    // catch covers the case the guard was there for: no substitution and no\n    // `process` to dereference, e.g. an unbundled `<script type=\"module\">`.\n    return process.env.NODE_ENV;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * `localStorage.UIKIT_DEBUG` as a tri-state: an explicit `\"true\"` forces ui-kit's\n * diagnostics on and an explicit `\"false\"` forces them off, in any environment.\n *\n * The escape hatch in both directions. Consumers whose production build somehow\n * resolves to development can silence us without waiting for a release, and\n * anyone debugging a built app can switch us back on.\n */\nfunction readDebugFlag(): boolean | undefined {\n  if (typeof window === 'undefined' || !window.localStorage) return undefined;\n\n  try {\n    const flag = window.localStorage.getItem('UIKIT_DEBUG')?.toLowerCase();\n\n    if (flag === 'true') return true;\n    if (flag === 'false') return false;\n  } catch {\n    // localStorage might not be available (private browsing, etc.)\n  }\n\n  return undefined;\n}\n\n/**\n * Whether to run diagnostics that only a human looking at the page can act on -\n * a warning drawn into the layout, a complaint about a measurement.\n *\n * Off under `test`: jsdom reports `offsetHeight: 0` for everything, so anything\n * keyed off a measurement is not just noisy in a consumer's test run but wrong.\n * Off under `production`, and off when nobody could say what `NODE_ENV` is -\n * a diagnostic shown to end users is worse than a missing one shown to a\n * developer, who still has `UIKIT_DEBUG`.\n *\n * Use {@link isDevEnvOrTest} instead for diagnostics a test run should surface.\n */\nexport function isDevEnv(): boolean {\n  const flag = readDebugFlag();\n\n  if (flag !== undefined) return flag;\n\n  const nodeEnv = readNodeEnv();\n\n  if (nodeEnv === undefined) return false;\n\n  return nodeEnv !== 'test' && nodeEnv !== 'production';\n}\n\n/**\n * Like {@link isDevEnv}, but on under `test` as well.\n *\n * For diagnostics a consumer's test run should still surface - deprecation\n * warnings above all. \"You are passing a prop we are about to remove\" is worth\n * hearing from CI, and unlike a collapsed-height complaint it cannot be wrong\n * just because jsdom has no layout.\n */\nexport function isDevEnvOrTest(): boolean {\n  const flag = readDebugFlag();\n\n  if (flag !== undefined) return flag;\n\n  const nodeEnv = readNodeEnv();\n\n  if (nodeEnv === undefined) return false;\n\n  return nodeEnv !== 'production';\n}\n"],"mappings":";;;;;;;;;;;;AAUA,SAAS,cAAkC;AACzC,KAAI;AAOF;SACM;AACN;;;;;;;;;;;AAYJ,SAAS,gBAAqC;AAC5C,KAAI,OAAO,WAAW,eAAe,CAAC,OAAO,aAAc,QAAO;AAElE,KAAI;EACF,MAAM,OAAO,OAAO,aAAa,QAAQ,cAAc,EAAE,aAAa;AAEtE,MAAI,SAAS,OAAQ,QAAO;AAC5B,MAAI,SAAS,QAAS,QAAO;SACvB;;;;;;;;;;;;;;AAmBV,SAAgB,WAAoB;CAClC,MAAM,OAAO,eAAe;AAE5B,KAAI,SAAS,OAAW,QAAO;CAE/B,MAAM,UAAU,aAAa;AAE7B,KAAI,YAAY,OAAW,QAAO;AAElC,QAAO,YAAY,UAAU,YAAY;;;;;;;;;;AAW3C,SAAgB,iBAA0B;CACxC,MAAM,OAAO,eAAe;AAE5B,KAAI,SAAS,OAAW,QAAO;CAE/B,MAAM,UAAU,aAAa;AAE7B,KAAI,YAAY,OAAW,QAAO;AAElC,QAAO,YAAY"}

package/dist/utils/modules.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 //#region src/utils/modules.ts
 function extractModule(promise) {
 	return promise.then((module) => module.default || module);

package/dist/utils/promise.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 //#region src/utils/promise.ts
 function timeout(ms = 30) {
 	return new Promise((resolve) => {

package/dist/utils/raf.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 //#region src/utils/raf.ts
 /**
 * Chains N requestAnimationFrame calls and returns a cancel function.

package/dist/utils/random.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 //#region src/utils/random.ts
 function random(min, max) {
 	const realMin = min < max ? min : max;

package/dist/utils/range.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 //#region src/utils/range.ts
 function range(count) {
 	return Array.from({ length: count }, (_, i) => i);

package/dist/utils/react/RenderCache.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 import { useRef } from "react";
 import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
 

package/dist/utils/react/Slots.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 import { mergeProps } from "./mergeProps.js";
 import { Children, cloneElement, createContext, useContext, useMemo } from "react";
 import { jsx } from "react/jsx-runtime";

package/dist/utils/react/chain.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 //#region src/utils/react/chain.ts
 /**
 * Calls all functions in the order they were chained with the same arguments.

package/dist/utils/react/disabledProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 //#region src/utils/react/disabledProps.ts
 /**
 * Tags where `disabled` is a real HTML attribute. Browsers refuse to dispatch

package/dist/utils/react/forwardRefWithGenerics.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 //#region src/utils/react/forwardRefWithGenerics.tsx
 /**
 * A helper for creating forwardRef components with generic types.

package/dist/utils/react/index.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 import { chain } from "./chain.js";
 import { getDisabledElementProps, omitActivationEventProps } from "./disabledProps.js";
 import { forwardRefWithGenerics } from "./forwardRefWithGenerics.js";

package/dist/utils/react/interactions.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 import { useState } from "react";
 import { useFocus, useFocusVisible } from "react-aria";
 

package/dist/utils/react/isTextOnly.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 import { Children, isValidElement } from "react";
 
 //#region src/utils/react/isTextOnly.ts

package/dist/utils/react/mapProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 //#region src/utils/react/mapProps.ts
 /** Converts AriaButtonProps to CubeButtonProps */
 function ariaToCubeButtonProps(props) {

package/dist/utils/react/mergeProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 import { chain } from "./chain.js";
 import { mergeIds } from "./useId.js";
 import { mergeStyles } from "@tenphi/tasty";

package/dist/utils/react/nullableValue.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
 //#region src/utils/react/nullableValue.ts
 function castNullableStringValue(props) {
 	return castNullableField(props, ["value", "defaultValue"], "string", (v) => String(v));