@cube-dev/ui-kit 0.176.0 → 0.177.0

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.177.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.177.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.177.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.177.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.177.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.177.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.177.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.177.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.177.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.177.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.177.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.177.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.177.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.177.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.177.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.177.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.177.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.177.0 | Cube Dev Team */
 //#region src/utils/react/nullableValue.ts
 function castNullableStringValue(props) {
 	return castNullableField(props, ["value", "defaultValue"], "string", (v) => String(v));

package/dist/utils/react/resolveIcon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.177.0 | Cube Dev Team */
 //#region src/utils/react/resolveIcon.ts
 /**
 * Resolves a dynamic icon prop to its content and slot state.

package/dist/utils/react/sharedStore.js

@@ -1,5 +1,6 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.177.0 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
+import { isDevEnv } from "../is-dev-env.js";
 import { useSyncExternalStore } from "react";
 
 //#region src/utils/react/sharedStore.ts
@@ -16,7 +17,7 @@ function createSharedStore(name, initialState) {
 		state: initialState,
 		listeners: /* @__PURE__ */ new Set()
 	};
-	if (existing && existing.state !== initialState) console.warn(`[createSharedStore] Store "${name}" already exists – the new initialState is ignored to preserve hot-reload state.`);
+	if (isDevEnv() && existing && existing.state !== initialState) console.warn(`[createSharedStore] Store "${name}" already exists – the new initialState is ignored to preserve hot-reload state.`);
 	if (cacheKey && !existing) globalThis[cacheKey] = holder;
 	const getSnapshot = () => holder.state;
 	const subscribe = (cb) => {

package/dist/utils/react/sharedStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"sharedStore.js","names":[],"sources":["../../../src/utils/react/sharedStore.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\n\nimport { useEvent } from '../../_internal/hooks/use-event';\n\n/** Like React.setState: either a value or a function of the previous value */\ntype Updater<S> = S | ((prev: S) => S);\n\n/* Internal shape kept on globalThis */\ninterface StoreHolder<S> {\n  state: S;\n  listeners: Set<() => void>;\n}\n\n/**\n * Create a shared store that survives hot-reloads.\n *\n * Pass a unique `name` once per logical store module:\n *   export const useSidebarStore = createSharedStore('sidebar', { open: false });\n */\nexport function createSharedStore<S>(\n  name: string,\n  initialState: S,\n): UseSharedStoreHook<S> {\n  const cacheKey = `__sharedStore_${name}__`;\n  const existing: StoreHolder<S> | undefined =\n    cacheKey && (globalThis as any)[cacheKey];\n\n  const holder: StoreHolder<S> = existing ?? {\n    state: initialState,\n    listeners: new Set<() => void>(),\n  };\n\n  /* Warn if someone tries to “re-initialise” with a different value */\n  if (\n    process.env.NODE_ENV === 'development' &&\n    existing &&\n    existing.state !== initialState\n  ) {\n    console.warn(\n      `[createSharedStore] Store \"${name}\" already exists – ` +\n        'the new initialState is ignored to preserve hot-reload state.',\n    );\n  }\n\n  if (cacheKey && !existing) {\n    (globalThis as any)[cacheKey] = holder;\n  }\n\n  const getSnapshot = () => holder.state;\n\n  const subscribe = (cb: () => void) => {\n    holder.listeners.add(cb);\n\n    return () => holder.listeners.delete(cb);\n  };\n\n  const setStore = (update: Updater<S>) => {\n    holder.state =\n      typeof update === 'function'\n        ? (update as (prev: S) => S)(holder.state)\n        : update;\n\n    holder.listeners.forEach((l) => l());\n  };\n\n  const useSharedStore: UseSharedStoreHook<S> = () => {\n    return [useSyncExternalStore(subscribe, getSnapshot), useEvent(setStore)];\n  };\n\n  return useSharedStore;\n}\n\ntype UseSharedStoreHook<S> = () => readonly [S, (u: Updater<S>) => void];\n"],"mappings":";;;;;;;;;;;AAmBA,SAAgB,kBACd,MACA,cACuB;CACvB,MAAM,WAAW,iBAAiB,KAAK;CACvC,MAAM,WACJ,YAAa,WAAmB;CAElC,MAAM,SAAyB,YAAY;EACzC,OAAO;EACP,2BAAW,IAAI,KAAiB;EACjC;AAGD,KAEE,YACA,SAAS,UAAU,aAEnB,SAAQ,KACN,8BAA8B,KAAK,kFAEpC;AAGH,KAAI,YAAY,CAAC,SACf,CAAC,WAAmB,YAAY;CAGlC,MAAM,oBAAoB,OAAO;CAEjC,MAAM,aAAa,OAAmB;AACpC,SAAO,UAAU,IAAI,GAAG;AAExB,eAAa,OAAO,UAAU,OAAO,GAAG;;CAG1C,MAAM,YAAY,WAAuB;AACvC,SAAO,QACL,OAAO,WAAW,aACb,OAA0B,OAAO,MAAM,GACxC;AAEN,SAAO,UAAU,SAAS,MAAM,GAAG,CAAC;;CAGtC,MAAM,uBAA8C;AAClD,SAAO,CAAC,qBAAqB,WAAW,YAAY,EAAE,SAAS,SAAS,CAAC;;AAG3E,QAAO"}
+{"version":3,"file":"sharedStore.js","names":[],"sources":["../../../src/utils/react/sharedStore.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\n\nimport { useEvent } from '../../_internal/hooks/use-event';\nimport { isDevEnv } from '../is-dev-env';\n\n/** Like React.setState: either a value or a function of the previous value */\ntype Updater<S> = S | ((prev: S) => S);\n\n/* Internal shape kept on globalThis */\ninterface StoreHolder<S> {\n  state: S;\n  listeners: Set<() => void>;\n}\n\n/**\n * Create a shared store that survives hot-reloads.\n *\n * Pass a unique `name` once per logical store module:\n *   export const useSidebarStore = createSharedStore('sidebar', { open: false });\n */\nexport function createSharedStore<S>(\n  name: string,\n  initialState: S,\n): UseSharedStoreHook<S> {\n  const cacheKey = `__sharedStore_${name}__`;\n  const existing: StoreHolder<S> | undefined =\n    cacheKey && (globalThis as any)[cacheKey];\n\n  const holder: StoreHolder<S> = existing ?? {\n    state: initialState,\n    listeners: new Set<() => void>(),\n  };\n\n  /* Warn if someone tries to “re-initialise” with a different value */\n  if (isDevEnv() && existing && existing.state !== initialState) {\n    console.warn(\n      `[createSharedStore] Store \"${name}\" already exists – ` +\n        'the new initialState is ignored to preserve hot-reload state.',\n    );\n  }\n\n  if (cacheKey && !existing) {\n    (globalThis as any)[cacheKey] = holder;\n  }\n\n  const getSnapshot = () => holder.state;\n\n  const subscribe = (cb: () => void) => {\n    holder.listeners.add(cb);\n\n    return () => holder.listeners.delete(cb);\n  };\n\n  const setStore = (update: Updater<S>) => {\n    holder.state =\n      typeof update === 'function'\n        ? (update as (prev: S) => S)(holder.state)\n        : update;\n\n    holder.listeners.forEach((l) => l());\n  };\n\n  const useSharedStore: UseSharedStoreHook<S> = () => {\n    return [useSyncExternalStore(subscribe, getSnapshot), useEvent(setStore)];\n  };\n\n  return useSharedStore;\n}\n\ntype UseSharedStoreHook<S> = () => readonly [S, (u: Updater<S>) => void];\n"],"mappings":";;;;;;;;;;;;AAoBA,SAAgB,kBACd,MACA,cACuB;CACvB,MAAM,WAAW,iBAAiB,KAAK;CACvC,MAAM,WACJ,YAAa,WAAmB;CAElC,MAAM,SAAyB,YAAY;EACzC,OAAO;EACP,2BAAW,IAAI,KAAiB;EACjC;AAGD,KAAI,UAAU,IAAI,YAAY,SAAS,UAAU,aAC/C,SAAQ,KACN,8BAA8B,KAAK,kFAEpC;AAGH,KAAI,YAAY,CAAC,SACf,CAAC,WAAmB,YAAY;CAGlC,MAAM,oBAAoB,OAAO;CAEjC,MAAM,aAAa,OAAmB;AACpC,SAAO,UAAU,IAAI,GAAG;AAExB,eAAa,OAAO,UAAU,OAAO,GAAG;;CAG1C,MAAM,YAAY,WAAuB;AACvC,SAAO,QACL,OAAO,WAAW,aACb,OAA0B,OAAO,MAAM,GACxC;AAEN,SAAO,UAAU,SAAS,MAAM,GAAG,CAAC;;CAGtC,MAAM,uBAA8C;AAClD,SAAO,CAAC,qBAAqB,WAAW,YAAY,EAAE,SAAS,SAAS,CAAC;;AAG3E,QAAO"}

package/dist/utils/react/useBufferedValue.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.177.0 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "./useLayoutEffect.js";
 import { useCallback, useRef, useState } from "react";
 

package/dist/utils/react/useCombinedRefs.js

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

package/dist/utils/react/useControlledFocusVisible.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.177.0 | Cube Dev Team */
 import { createSharedStore } from "./sharedStore.js";
 import { useEffect } from "react";
 import { useFocusVisible } from "react-aria";

package/dist/utils/react/useEventBus.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.177.0 | Cube Dev Team */
 import React, { createContext, useCallback, useContext, useEffect, useMemo, useRef } from "react";
 
 //#region src/utils/react/useEventBus.ts

package/dist/utils/react/useId.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.177.0 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "./useLayoutEffect.js";
 import { useEffect, useRef, useState } from "react";
 import { useSSRSafeId } from "@react-aria/ssr";

package/dist/utils/react/useIsDarwin.js

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

package/dist/utils/react/useKeySymbols.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.177.0 | Cube Dev Team */
 import { useIsDarwin } from "./useIsDarwin.js";
 import { useMemo } from "react";
 

package/dist/utils/react/useLayoutEffect.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.177.0 | Cube Dev Team */
 import * as React$1 from "react";
 
 //#region src/utils/react/useLayoutEffect.tsx

package/dist/utils/react/useLocalStorage.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.177.0 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { useCallback, useSyncExternalStore } from "react";
 

package/dist/utils/react/useMergeStyles.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.177.0 | Cube Dev Team */
 import { mergeStyles } from "@tenphi/tasty";
 import { useMemo } from "react";
 

package/dist/utils/react/usePopoverSync.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.176.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.177.0 | Cube Dev Team */
 import { EventBusContext, useEventBus } from "./useEventBus.js";
 import { useCallback, useContext, useEffect, useRef } from "react";