@cube-dev/ui-kit 0.195.0 → 0.196.0

package/dist/providers/navigation-url.js

@@ -1,11 +1,23 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 //#region src/providers/navigation-url.ts
 const URL_SCHEME = /^[a-z][a-z\d+.-]*:/i;
+/**
+* Strips what the URL parser strips: leading and trailing C0 controls and
+* spaces. Not `trim()`, which also drops a no-break space the parser keeps.
+*/
+function normalizeNavigationUrl(url) {
+	let start = 0;
+	let end = url.length;
+	while (start < end && url.charCodeAt(start) <= 32) start++;
+	while (end > start && url.charCodeAt(end - 1) <= 32) end--;
+	return url.slice(start, end);
+}
 /** A URL scheme or protocol-relative host, rather than an application path. */
 function isExternalUrl(url) {
-	return URL_SCHEME.test(url) || url.startsWith("//");
+	const value = normalizeNavigationUrl(url);
+	return URL_SCHEME.test(value) || value.startsWith("//");
 }
 
 //#endregion
-export { isExternalUrl };
+export { isExternalUrl, normalizeNavigationUrl };
 //# sourceMappingURL=navigation-url.js.map

package/dist/providers/navigation-url.js.map

@@ -1 +1 @@
-{"version":3,"file":"navigation-url.js","names":["URL_SCHEME","isExternalUrl","url","test","startsWith"],"sources":["../../src/providers/navigation-url.ts"],"sourcesContent":["const URL_SCHEME = /^[a-z][a-z\\d+.-]*:/i;\n\n/** A URL scheme or protocol-relative host, rather than an application path. */\nexport function isExternalUrl(url: string): boolean {\n  return URL_SCHEME.test(url) || url.startsWith('//');\n}\n"],"mappings":";;AAAA,MAAMA,aAAa;;AAGnB,SAAgBC,cAAcC,KAAsB;AAClD,QAAOF,WAAWG,KAAKD,IAAI,IAAIA,IAAIE,WAAW,KAAK"}
+{"version":3,"file":"navigation-url.js","names":["URL_SCHEME","normalizeNavigationUrl","url","start","end","length","charCodeAt","slice","isExternalUrl","value","test","startsWith"],"sources":["../../src/providers/navigation-url.ts"],"sourcesContent":["const URL_SCHEME = /^[a-z][a-z\\d+.-]*:/i;\n\n/**\n * Strips what the URL parser strips: leading and trailing C0 controls and\n * spaces. Not `trim()`, which also drops a no-break space the parser keeps.\n */\nexport function normalizeNavigationUrl(url: string): string {\n  let start = 0;\n  let end = url.length;\n\n  while (start < end && url.charCodeAt(start) <= 0x20) start++;\n  while (end > start && url.charCodeAt(end - 1) <= 0x20) end--;\n\n  return url.slice(start, end);\n}\n\n/** A URL scheme or protocol-relative host, rather than an application path. */\nexport function isExternalUrl(url: string): boolean {\n  const value = normalizeNavigationUrl(url);\n\n  return URL_SCHEME.test(value) || value.startsWith('//');\n}\n"],"mappings":";;AAAA,MAAMA,aAAa;;;;;AAMnB,SAAgBC,uBAAuBC,KAAqB;CAC1D,IAAIC,QAAQ;CACZ,IAAIC,MAAMF,IAAIG;AAEd,QAAOF,QAAQC,OAAOF,IAAII,WAAWH,MAAM,IAAI,GAAMA;AACrD,QAAOC,MAAMD,SAASD,IAAII,WAAWF,MAAM,EAAE,IAAI,GAAMA;AAEvD,QAAOF,IAAIK,MAAMJ,OAAOC,IAAI;;;AAI9B,SAAgBI,cAAcN,KAAsB;CAClD,MAAMO,QAAQR,uBAAuBC,IAAI;AAEzC,QAAOF,WAAWU,KAAKD,MAAM,IAAIA,MAAME,WAAW,KAAK"}

package/dist/providers/navigationAdapter.default.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 //#region src/providers/navigationAdapter.default.ts
 /**
 * Converts a Path object to a string URL

package/dist/providers/use-navigation.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { defaultNavigationAdapter } from "./navigationAdapter.default.js";
 import { UIKitContext } from "../provider.js";
 import { useContext } from "react";

package/dist/shared/form.d.ts

@@ -75,12 +75,15 @@ interface FieldCoreProps<Value = unknown> {
   isEqual?: (previous: unknown, next: unknown) => boolean;
   /**
    * @deprecated Use `errorMessage` for error messages and `description` for field descriptions instead.
-   * Message for the field. Some additional information or error notice
+   * Fallback text used only when errorMessage is undefined.
    */
   message?: ReactNode;
   /** Description for the field. Will be placed below the label */
   description?: ReactNode;
-  /** Error message for the field. Always displayed in danger state regardless of validation state */
+  /**
+   * Error text shown in danger state. Undefined allows the generated error or
+   * message fallback; null, false or an empty string explicitly suppresses it.
+   */
   errorMessage?: ReactNode;
   /**
    * Whether the field is required. Drives `aria-required`, adds a `required`
@@ -165,19 +168,15 @@ interface FieldBaseProps<Value = unknown> extends FormBaseProps, FieldCoreProps<
   fieldStyles?: Styles;
   messageStyles?: Styles;
   /**
-   * Renders a field without a `label` as the bare control, for inline use.
-   * Without it, such a field renders the field wrapper when it is bound to a
-   * form or is passed `description`, `errorMessage` or `message`. With it,
-   * those texts are not shown, while the control keeps its invalid state. No
-   * effect on a field with a `label`.
+   * Renders only the control, without field layout, description or messages.
+   * A supplied label stays accessible but visually hidden. Binding and invalid
+   * state are unaffected. Field chrome is the default, even without a label.
+   * @default false
    */
   isBare?: boolean;
   /**
-   * Renders the field wrapper even when the field has no `label`.
-   *
-   * @deprecated A field without a `label` renders the wrapper by itself when
-   * it is bound to a form or is passed `description`, `errorMessage` or
-   * `message`. Pass `isBare` to keep the bare control instead.
+   * @deprecated Fields render chrome by default. Remove this prop; use `isBare`
+   * to opt out. It has no presentation effect.
    */
   forceField?: boolean;
 }

package/dist/tokens/all-tokens.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { getPaletteVersion } from "./palette-config.js";
 import { BASE_TOKENS } from "./base.js";
 import { lazyStyles } from "./lazy-styles.js";

package/dist/tokens/base.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 //#region src/tokens/base.ts
 /**
 * Base design system tokens.

package/dist/tokens/color-seed.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { glaze } from "@tenphi/glaze";
 
 //#region src/tokens/color-seed.ts

package/dist/tokens/color-theme.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { colorSeed } from "./color-seed.js";
 import { DEFAULT_HUE, DEFAULT_SATURATION, getPaletteConfig, getPaletteVersion, usePaletteValue } from "./palette-config.js";
 import { tintRecipe } from "./palette.js";

package/dist/tokens/colors.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { getPaletteVersion } from "./palette-config.js";
 import { BASE_TOKENS } from "./base.js";
 import { lazyStyles } from "./lazy-styles.js";

package/dist/tokens/layout.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 //#region src/tokens/layout.ts
 /**
 * Layout-related tokens for common UI dimensions.

package/dist/tokens/lazy-styles.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 //#region src/tokens/lazy-styles.ts
 /**
 * Proxy that defers to `factory()` on every property / enumeration access.

package/dist/tokens/legacy-color.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { parseSrgbColor } from "../utils/colors.js";
 import { srgbToHex } from "@tenphi/glaze";
 

package/dist/tokens/palette-config.js

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

package/dist/tokens/palette.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.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.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.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.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.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.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.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.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.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.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.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.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 //#region src/utils/ResizeSensor.ts
 /**
 * Iterate over each of the provided element(s).

package/dist/utils/colors.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { hslToSrgb, okhslToOklch, okhslToSrgb, okhstToOkhsl, oklabToOkhsl, parseHexAlpha } from "@tenphi/glaze";
 
 //#region src/utils/colors.ts

package/dist/utils/dotize.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 //#region src/utils/dotize.ts
 /**
 * Flattens a nested object into dot paths: `{ a: { b: 1 } }` becomes

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

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 //#region src/utils/is-dev-env.ts
 /**
 * `NODE_ENV` as the environment that is actually running reports it, or

package/dist/utils/modules.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.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.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.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.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.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.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.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.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.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.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.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.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { mergeProps } from "./mergeProps.js";
 import { c } from "react/compiler-runtime";
 import { Children, cloneElement, createContext, useContext } from "react";

package/dist/utils/react/chain.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.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.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.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.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 //#region src/utils/react/forwardRefWithGenerics.tsx
 /**
 * @deprecated Declare a ref prop on a generic component, or preserve an

package/dist/utils/react/index.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { chain } from "./chain.js";
 import { useLayoutEffect } from "./useLayoutEffect.js";
 import { mergeProps } from "./mergeProps.js";

package/dist/utils/react/interactions.js

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

package/dist/utils/react/isTextOnly.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.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.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.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.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.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,21 +1,30 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 //#region src/utils/react/nullableValue.ts
-function castNullableStringValue(props) {
-	return castNullableField(props, ["value", "defaultValue"], "string", (v) => String(v));
+function castNullableStringValue(props, emptyValue = "") {
+	return castNullableField(props, ["value", "defaultValue"], "string", (v) => String(v), emptyValue);
 }
 function castNullableNumberValue(props) {
-	return castNullableField(props, ["value", "defaultValue"], "number", (v) => Number(v));
+	return castNullableField(props, ["value", "defaultValue"], "number", (v) => Number(v), NaN);
 }
 function castNullableArrayValue(props) {
-	return castNullableField(props, ["value", "defaultValue"], "object", (v) => Array.isArray(v) ? v : []);
+	return castNullableField(props, ["value", "defaultValue"], "object", (v) => Array.isArray(v) ? v : [], []);
 }
 function castNullableIsSelected(props) {
-	return castNullableField(props, ["isSelected", "defaultSelected"], "boolean", (v) => !!v);
+	return castNullableField(props, ["isSelected", "defaultSelected"], "boolean", (v) => !!v, false);
 }
-function castNullableField(props, keys, type, cast) {
+/**
+* Replaces `null` in `keys` and casts a value of the wrong `type`.
+*
+* The first key is the controlled one, and its `null` becomes `emptyValue`. Pass the control's own
+* empty value (`''`, `NaN`, `[]`, or `null` where React Stately takes it) so that `null` means
+* "controlled, no value": the field stays controlled and clears. Left out, `null` becomes
+* `undefined`, which switches the control to uncontrolled mode and keeps its last value on screen.
+* `null` in the other keys (`defaultValue`) always becomes `undefined`.
+*/
+function castNullableField(props, keys, type, cast, emptyValue) {
 	props = { ...props };
-	keys.forEach((key) => {
-		if (props[key] === null) props[key] = void 0;
+	keys.forEach((key, index) => {
+		if (props[key] === null) props[key] = index === 0 ? emptyValue : void 0;
 		if (type && cast && props[key] != null && typeof props[key] != type) {
 			props[key] = cast(props[key]);
 			console.warn("Wrong value type in", props, "in keys", JSON.stringify(keys));

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

@@ -1 +1 @@
-{"version":3,"file":"nullableValue.js","names":["Props","castNullableStringValue","props","T","castNullableField","v","String","castNullableNumberValue","Number","castNullableArrayValue","Array","isArray","castNullableIsSelected","castNullableSelectedKey","keys","type","cast","k","forEach","key","undefined","console","warn","JSON","stringify","WithNullableValue","Omit","value","defaultValue","WithNullableSelected","isSelected","defaultSelected","WithNullableSelectedKey","selectedKey","defaultSelectedKey"],"sources":["../../../src/utils/react/nullableValue.ts"],"sourcesContent":["import type { Props } from '../../props';\n\nexport function castNullableStringValue<T>(props: T): T {\n  return castNullableField(props, ['value', 'defaultValue'], 'string', (v) =>\n    String(v),\n  );\n}\n\nexport function castNullableNumberValue<T>(props: T): T {\n  return castNullableField(props, ['value', 'defaultValue'], 'number', (v) =>\n    Number(v),\n  );\n}\n\nexport function castNullableArrayValue<T>(props: T): T {\n  return castNullableField(props, ['value', 'defaultValue'], 'object', (v) =>\n    Array.isArray(v) ? v : [],\n  );\n}\n\nexport function castNullableIsSelected<T>(props: T): T {\n  return castNullableField(\n    props,\n    ['isSelected', 'defaultSelected'],\n    'boolean',\n    (v) => !!v,\n  );\n}\n\nexport function castNullableSelectedKey<T>(props: T): T {\n  return castNullableField(props, ['selectedKey', 'defaultSelectedKey']);\n}\n\nexport function castNullableField<T>(\n  props: T,\n  keys: string[],\n  type?: string,\n  cast?: (k: any) => any,\n): T {\n  props = { ...props };\n\n  keys.forEach((key) => {\n    if (props[key] === null) {\n      props[key] = undefined;\n    }\n\n    if (type && cast && props[key] != null && typeof props[key] != type) {\n      props[key] = cast(props[key]);\n\n      console.warn(\n        'Wrong value type in',\n        props,\n        'in keys',\n        JSON.stringify(keys),\n      );\n    }\n  });\n\n  return props;\n}\n\n// Values are intentionally permissive: the helpers above coerce input models.\n// A generic indexed access unioned with `any` has the same type, but declaration\n// emit can inline its type parameter outside the generic scope.\nexport type WithNullableValue<T extends Props> = Omit<\n  T,\n  'value' | 'defaultValue'\n> & {\n  value?: any;\n  defaultValue?: any;\n};\n\nexport type WithNullableSelected<T extends Props> = Omit<\n  T,\n  'isSelected' | 'defaultSelected'\n> & {\n  isSelected?: any;\n  defaultSelected?: any;\n};\n\nexport type WithNullableSelectedKey<T extends Props> = Omit<\n  T,\n  'selectedKey' | 'defaultSelectedKey'\n> & {\n  selectedKey?: any;\n  defaultSelectedKey?: any;\n};\n"],"mappings":";;AAEA,SAAgBC,wBAA2BC,OAAa;AACtD,QAAOE,kBAAkBF,OAAO,CAAC,SAAS,eAAe,EAAE,WAAWG,MACpEC,OAAOD,EACT,CAAC;;AAGH,SAAgBE,wBAA2BL,OAAa;AACtD,QAAOE,kBAAkBF,OAAO,CAAC,SAAS,eAAe,EAAE,WAAWG,MACpEG,OAAOH,EACT,CAAC;;AAGH,SAAgBI,uBAA0BP,OAAa;AACrD,QAAOE,kBAAkBF,OAAO,CAAC,SAAS,eAAe,EAAE,WAAWG,MACpEK,MAAMC,QAAQN,EAAE,GAAGA,IAAI,EACzB,CAAC;;AAGH,SAAgBO,uBAA0BV,OAAa;AACrD,QAAOE,kBACLF,OACA,CAAC,cAAc,kBAAkB,EACjC,YACCG,MAAM,CAAC,CAACA,EACV;;AAOH,SAAgBD,kBACdF,OACAY,MACAC,MACAC,MACG;AACHd,SAAQ,EAAE,GAAGA,OAAO;AAEpBY,MAAKI,SAASC,QAAQ;AACpB,MAAIjB,MAAMiB,SAAS,KACjBjB,OAAMiB,OAAOC;AAGf,MAAIL,QAAQC,QAAQd,MAAMiB,QAAQ,QAAQ,OAAOjB,MAAMiB,QAAQJ,MAAM;AACnEb,SAAMiB,OAAOH,KAAKd,MAAMiB,KAAK;AAE7BE,WAAQC,KACN,uBACApB,OACA,WACAqB,KAAKC,UAAUV,KACjB,CAAC;;GAEH;AAEF,QAAOZ"}
+{"version":3,"file":"nullableValue.js","names":["Props","castNullableStringValue","props","T","emptyValue","castNullableField","v","String","castNullableNumberValue","Number","NaN","castNullableArrayValue","Array","isArray","castNullableIsSelected","castNullableSelectedKey","keys","type","cast","k","forEach","key","index","undefined","console","warn","JSON","stringify","WithNullableValue","Omit","value","defaultValue","WithNullableSelected","isSelected","defaultSelected","WithNullableSelectedKey","selectedKey","defaultSelectedKey"],"sources":["../../../src/utils/react/nullableValue.ts"],"sourcesContent":["import type { Props } from '../../props';\n\n// Each value helper turns a controlled `null` into the control's own empty\n// value, so `null` means \"controlled, no value\"; see `castNullableField`.\n\nexport function castNullableStringValue<T>(\n  props: T,\n  /** `null` for controls whose state takes it, such as a radio group. */\n  emptyValue: string | null = '',\n): T {\n  return castNullableField(\n    props,\n    ['value', 'defaultValue'],\n    'string',\n    (v) => String(v),\n    emptyValue,\n  );\n}\n\nexport function castNullableNumberValue<T>(props: T): T {\n  return castNullableField(\n    props,\n    ['value', 'defaultValue'],\n    'number',\n    (v) => Number(v),\n    NaN,\n  );\n}\n\nexport function castNullableArrayValue<T>(props: T): T {\n  return castNullableField(\n    props,\n    ['value', 'defaultValue'],\n    'object',\n    (v) => (Array.isArray(v) ? v : []),\n    [],\n  );\n}\n\nexport function castNullableIsSelected<T>(props: T): T {\n  return castNullableField(\n    props,\n    ['isSelected', 'defaultSelected'],\n    'boolean',\n    (v) => !!v,\n    false,\n  );\n}\n\nexport function castNullableSelectedKey<T>(props: T): T {\n  return castNullableField(props, ['selectedKey', 'defaultSelectedKey']);\n}\n\n/**\n * Replaces `null` in `keys` and casts a value of the wrong `type`.\n *\n * The first key is the controlled one, and its `null` becomes `emptyValue`. Pass the control's own\n * empty value (`''`, `NaN`, `[]`, or `null` where React Stately takes it) so that `null` means\n * \"controlled, no value\": the field stays controlled and clears. Left out, `null` becomes\n * `undefined`, which switches the control to uncontrolled mode and keeps its last value on screen.\n * `null` in the other keys (`defaultValue`) always becomes `undefined`.\n */\nexport function castNullableField<T>(\n  props: T,\n  keys: string[],\n  type?: string,\n  cast?: (k: any) => any,\n  emptyValue?: unknown,\n): T {\n  props = { ...props };\n\n  keys.forEach((key, index) => {\n    if (props[key] === null) {\n      props[key] = index === 0 ? emptyValue : undefined;\n    }\n\n    if (type && cast && props[key] != null && typeof props[key] != type) {\n      props[key] = cast(props[key]);\n\n      console.warn(\n        'Wrong value type in',\n        props,\n        'in keys',\n        JSON.stringify(keys),\n      );\n    }\n  });\n\n  return props;\n}\n\n// Values are intentionally permissive: the helpers above coerce input models.\n// A generic indexed access unioned with `any` has the same type, but declaration\n// emit can inline its type parameter outside the generic scope.\nexport type WithNullableValue<T extends Props> = Omit<\n  T,\n  'value' | 'defaultValue'\n> & {\n  value?: any;\n  defaultValue?: any;\n};\n\nexport type WithNullableSelected<T extends Props> = Omit<\n  T,\n  'isSelected' | 'defaultSelected'\n> & {\n  isSelected?: any;\n  defaultSelected?: any;\n};\n\nexport type WithNullableSelectedKey<T extends Props> = Omit<\n  T,\n  'selectedKey' | 'defaultSelectedKey'\n> & {\n  selectedKey?: any;\n  defaultSelectedKey?: any;\n};\n"],"mappings":";;AAKA,SAAgBC,wBACdC,OAEAE,aAA4B,IACzB;AACH,QAAOC,kBACLH,OACA,CAAC,SAAS,eAAe,EACzB,WACCI,MAAMC,OAAOD,EAAE,EAChBF,WACD;;AAGH,SAAgBI,wBAA2BN,OAAa;AACtD,QAAOG,kBACLH,OACA,CAAC,SAAS,eAAe,EACzB,WACCI,MAAMG,OAAOH,EAAE,EAChBI,IACD;;AAGH,SAAgBC,uBAA0BT,OAAa;AACrD,QAAOG,kBACLH,OACA,CAAC,SAAS,eAAe,EACzB,WACCI,MAAOM,MAAMC,QAAQP,EAAE,GAAGA,IAAI,EAAG,EAClC,EACF,CAAC;;AAGH,SAAgBQ,uBAA0BZ,OAAa;AACrD,QAAOG,kBACLH,OACA,CAAC,cAAc,kBAAkB,EACjC,YACCI,MAAM,CAAC,CAACA,GACT,MACD;;;;;;;;;;;AAgBH,SAAgBD,kBACdH,OACAc,MACAC,MACAC,MACAd,YACG;AACHF,SAAQ,EAAE,GAAGA,OAAO;AAEpBc,MAAKI,SAASC,KAAKC,UAAU;AAC3B,MAAIpB,MAAMmB,SAAS,KACjBnB,OAAMmB,OAAOC,UAAU,IAAIlB,aAAamB;AAG1C,MAAIN,QAAQC,QAAQhB,MAAMmB,QAAQ,QAAQ,OAAOnB,MAAMmB,QAAQJ,MAAM;AACnEf,SAAMmB,OAAOH,KAAKhB,MAAMmB,KAAK;AAE7BG,WAAQC,KACN,uBACAvB,OACA,WACAwB,KAAKC,UAAUX,KACjB,CAAC;;GAEH;AAEF,QAAOd"}

package/dist/utils/react/overlayKeyPropagation.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 //#region src/utils/react/overlayKeyPropagation.ts
 /**
 * Keys whose final handling belongs to the overlay around a control, not to

package/dist/utils/react/programmaticFocus.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 //#region src/utils/react/programmaticFocus.ts
 /**
 * Telling focus the user moved from focus a component moved for them.

package/dist/utils/react/resolveIcon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.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,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { isDevEnv } from "../is-dev-env.js";
 import { c } from "react/compiler-runtime";

package/dist/utils/react/useBufferedValue.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.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.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { c } from "react/compiler-runtime";
 import { useEffect, useRef } from "react";
 

package/dist/utils/react/useControlledFocusVisible.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { createSharedStore } from "./sharedStore.js";
 import { c } from "react/compiler-runtime";
 import { useEffect } from "react";

package/dist/utils/react/useEventBus.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { c } from "react/compiler-runtime";
 import React, { createContext, useCallback, useContext, useEffect, useMemo, useRef } from "react";
 

package/dist/utils/react/useId.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "./useLayoutEffect.js";
 import { c } from "react/compiler-runtime";
 import { useEffect, useRef, useState } from "react";

package/dist/utils/react/useIsDarwin.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { c } from "react/compiler-runtime";
 import { useEffect, useState } from "react";
 

package/dist/utils/react/useKeySymbols.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { useIsDarwin } from "./useIsDarwin.js";
 import { c } from "react/compiler-runtime";
 

package/dist/utils/react/useLayoutEffect.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.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.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { c } from "react/compiler-runtime";
 import { useSyncExternalStore } from "react";

package/dist/utils/react/useMergeStyles.js

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

package/dist/utils/react/useOverlayEscapeGuard.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { c } from "react/compiler-runtime";
 import { getEventTarget, nodeContains } from "@react-aria/utils";

package/dist/utils/react/usePopoverSync.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { EventBusContext, useEventBus } from "./useEventBus.js";
 import { c } from "react/compiler-runtime";
 import { useContext, useEffect, useEffectEvent, useRef } from "react";

package/dist/utils/react/useQaProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 //#region src/utils/react/useQaProps.ts
 /**
 * Processes QA props.

package/dist/utils/react/useScheme.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { useSyncExternalStore } from "react";
 
 //#region src/utils/react/useScheme.ts

package/dist/utils/react/useViewportSize.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { c } from "react/compiler-runtime";
 import { useEffect, useState } from "react";
 

package/dist/utils/react/wrapNodeIfPlain.js

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

package/dist/utils/selection.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 //#region src/utils/selection.ts
 /**
 * Deduplicate/toggle keys in a selection: if a key appears twice it is

package/dist/utils/styles.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { isSelector, mergeStyles } from "@tenphi/tasty";
 
 //#region src/utils/styles.ts

package/dist/utils/tree.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 //#region src/utils/tree.ts
 function toFlatTree(tree, includingFolders) {
 	return tree.reduce((result, node) => {

package/dist/utils/warnings.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 import { isDevEnvOrTest } from "./is-dev-env.js";
 
 //#region src/utils/warnings.ts

package/dist/version.js

@@ -1,6 +1,6 @@
-/** @license MIT | @cube-dev/ui-kit v0.195.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
 //#region src/version.ts
-const VERSION = "0.195.0";
+const VERSION = "0.196.0";
 const TASTY_VERSION = "3.9.9";
 if (typeof window !== "undefined") {
 	const version = VERSION;