@cube-dev/ui-kit 0.172.0 → 0.174.0

package/dist/icons/WarningFilledIcon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.0 | Cube Dev Team */
 import { wrapIcon } from "./wrap-icon.js";
 import { jsx } from "react/jsx-runtime";
 import { IconAlertTriangleFilled } from "@tabler/icons-react";

package/dist/icons/WarningIcon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.0 | Cube Dev Team */
 import { wrapIcon } from "./wrap-icon.js";
 import { jsx } from "react/jsx-runtime";
 import { IconAlertTriangle } from "@tabler/icons-react";

package/dist/icons/wrap-icon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.0 | Cube Dev Team */
 import { Icon } from "./Icon.js";
 import { jsx } from "react/jsx-runtime";
 

package/dist/index.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.0 | Cube Dev Team */
 import { extractStyles } from "./utils/styles.js";
 import { chain } from "./utils/react/chain.js";
 import { getDisabledElementProps, omitActivationEventProps } from "./utils/react/disabledProps.js";

package/dist/probe/canonicalize.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.0 | Cube Dev Team */
 //#region src/probe/canonicalize.ts
 /**
 * Normalising generated identifiers out of rendered output.

package/dist/probe/css.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.0 | Cube Dev Team */
 import { getCSSTextForNode } from "@tenphi/tasty";
 
 //#region src/probe/css.ts

package/dist/probe/index.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.0 | Cube Dev Team */
 import { canonicalize, canonicalizeClassNames, canonicalizeIds } from "./canonicalize.js";
 import { captureCss, diffRules, splitRules } from "./css.js";
 

package/dist/provider.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.0 | Cube Dev Team */
 import { EventBusProvider } from "./utils/react/useEventBus.js";
 import { defaultNavigationAdapter } from "./providers/navigationAdapter.default.js";
 import { createContext, useContext, useMemo } from "react";

package/dist/providers/TrackingProvider.js

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

package/dist/providers/navigationAdapter.default.js

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

package/dist/shared/form.d.ts

@@ -15,7 +15,10 @@ interface ValidationResult {
 }
 /** Where to place label relative to input */
 type LabelPosition = 'side' | 'top' | 'split';
-/** The type of necessity indicator */
+/**
+ * The type of necessity indicator: `'icon'` renders the asterisk, `'label'` the
+ * `(required)` / `(optional)` text. `null` suppresses the indicator entirely.
+ */
 type NecessityIndicator = 'icon' | 'label';
 /**
  * The validation state of the field
@@ -56,8 +59,18 @@ interface FieldCoreProps {
   description?: ReactNode;
   /** Error message for the field. Always displayed in danger state regardless of validation state */
   errorMessage?: ReactNode;
-  /** Whether the field is required */
+  /**
+   * Whether the field is required. Drives `aria-required`, adds a `required`
+   * validation rule, and — unlike a `required` rule on its own — marks the
+   * label with the necessity indicator.
+   */
   isRequired?: boolean;
+  /**
+   * Whether the field is optional. Purely presentational: it marks the label
+   * with an `(optional)` note and changes no validation behaviour. Ignored when
+   * the field is required.
+   */
+  isOptional?: boolean;
   /** Custom label props */
   labelProps?: Props;
 }
@@ -92,8 +105,7 @@ interface FieldBaseProps extends FormBaseProps, FieldCoreProps {
   label?: ReactNode;
   /** An additional content next to the label */
   extra?: ReactNode;
-  necessityIndicator?: NecessityIndicator;
-  necessityLabel?: ReactNode;
+  necessityIndicator?: NecessityIndicator | null;
   labelSuffix?: ReactNode;
   /** A tooltip that is shown inside the label */
   tooltip?: ReactNode;
@@ -123,9 +135,7 @@ interface FormBaseProps extends ValidationProps {
   /** Whether the field presents required mark */
   requiredMark?: boolean;
   /** The type of necessity indicator */
-  necessityIndicator?: NecessityIndicator;
-  /** That can replace the necessity label */
-  necessityLabel?: ReactNode;
+  necessityIndicator?: NecessityIndicator | null;
   /** Whether the field is read only */
   isReadOnly?: boolean;
   /**

package/dist/tokens/all-tokens.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.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.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.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.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.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.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.0 | Cube Dev Team */
 import { colorSeed } from "./color-seed.js";
 import { DEFAULT_HUE, DEFAULT_SATURATION, getPaletteConfig, getPaletteVersion, usePaletteVersion } 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.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.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.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.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.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.0 | Cube Dev Team */
 //#region src/tokens/lazy-styles.ts
 /**
 * Proxy that defers to `factory()` on every property / enumeration access.

package/dist/tokens/palette-config.js

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

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

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.0 | Cube Dev Team */
 //#region src/utils/is-dev-env.ts
 function isDevEnv() {
 	if (typeof window !== "undefined" && window.localStorage) try {

package/dist/utils/modules.js

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

package/dist/utils/react/useBufferedValue.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.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.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.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.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.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.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.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.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.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.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.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.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.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.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.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.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.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.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.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.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.0 | Cube Dev Team */
 import { EventBusContext, useEventBus } from "./useEventBus.js";
 import { useCallback, useContext, useEffect, useRef } from "react";
 

package/dist/utils/react/useQaProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.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.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.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.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.0 | Cube Dev Team */
 import { useEffect, useState } from "react";
 
 //#region src/utils/react/useViewportSize.ts

package/dist/utils/react/wrapNodeIfPlain.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.0 | Cube Dev Team */
 import { isValidElement } from "react";
 import { isFragment } from "react-is";
 

package/dist/utils/selection.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.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.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.0 | Cube Dev Team */
 //#region src/utils/styles.ts
 /**
 * Split properties into style and non-style properties.

package/dist/utils/tree.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.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.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.0 | Cube Dev Team */
 //#region src/utils/warnings.ts
 const SUGGESTED_PROP_MAP = {
 	disabled: "isDisabled",

package/dist/version.js

@@ -1,7 +1,7 @@
-/** @license MIT | @cube-dev/ui-kit v0.172.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.174.0 | Cube Dev Team */
 //#region src/version.ts
-const VERSION = "0.172.0";
-const TASTY_VERSION = "3.3.1";
+const VERSION = "0.174.0";
+const TASTY_VERSION = "3.5.0";
 if (typeof window !== "undefined") {
 	const version = VERSION;
 	const tastyVersion = TASTY_VERSION;

package/docs/FieldProperties.md

@@ -25,9 +25,31 @@ When used inside a [Form](./components/form/Form.md), these properties are autom
 
 ## Necessity Indicators
 
-- **`isRequired`** `boolean` (default: `false`) — Whether user input is required before form submission.
-- **`necessityIndicator`** `'icon' | 'label'` — Type of necessity indicator shown next to the label.
-- **`necessityLabel`** `ReactNode` — Custom text for the necessity indicator (e.g., "Required" or "Optional").
+- **`isRequired`** `boolean` (default: `false`) — Whether user input is required before form submission. Marks the label, sets `aria-required` on the input, and adds a `required` validation rule.
+- **`isOptional`** `boolean` (default: `false`) — Marks the label with a quiet `(optional)` note. Presentational only: it changes no validation behaviour, and it is ignored when the field is required.
+- **`necessityIndicator`** `'icon' | 'label' | null` (default: `icon`) — Shape of the marker. `'icon'` renders the asterisk, `'label'` the `(required)` text, `null` suppresses it. `(optional)` has no icon form and always renders as text.
+- **`requiredMark`** `boolean` (default: `true`) — Set it to `false` — usually on the `Form` — to drop the required marker across fields that ask for one.
+
+**The marker is opt-in.** A `{ required: true }` rule states how the field _behaves_: it is what validation runs, and `aria-required` is its programmatic mirror, so both stay in place. It does not decorate the label. Pass `isRequired` when you want the marker too — it adds the rule for you, so the two are interchangeable as far as validation goes:
+
+```jsx
+{/* Validated and announced as required, but the label is left alone */}
+<TextInput name="email" label="Email" rules={[{ required: true }]} />
+
+{/* The same validation, plus the marker */}
+<TextInput name="email" label="Email" isRequired />
+
+{/* Asking for the marker on a rule-required field, without repeating the rule */}
+<TextInput
+  name="email"
+  label="Email"
+  necessityIndicator="icon"
+  rules={[{ required: true }]}
+/>
+
+{/* Optional is a note, never a rule */}
+<TextInput name="nickname" label="Nickname" isOptional />
+```
 
 ## State
 

package/docs/components/form/Field.md

@@ -23,9 +23,9 @@ The Field component is a **legacy wrapper** for form inputs that provides field-
 - **`defaultValue`** `string` — Default field value
 - **`rules`** — Validation rules array
 - **`labelPosition`** `'top' | 'side' | 'split'` (default: `top`) — Position of the field label
-- **`necessityIndicator`** `'icon' | 'label'` — Type of necessity indicator
-- **`necessityLabel`** `string` — Custom necessity label text
-- **`isRequired`** `boolean` (default: `false`) — Whether the field is required
+- **`necessityIndicator`** `'icon' | 'label' | null` — Type of necessity indicator
+- **`isRequired`** `boolean` (default: `false`) — Whether the field is required. Marks the label, unlike a bare `required` rule
+- **`isOptional`** `boolean` (default: `false`) — Marks the label with an `(optional)` note
 - **`isDisabled`** `boolean` (default: `false`) — Whether the field is disabled
 - **`isLoading`** `boolean` (default: `false`) — Whether the field is in loading state
 - **`isHidden`** `boolean` (default: `false`) — Whether the field is hidden
@@ -85,14 +85,14 @@ These properties allow direct style application without using the `styles` prop:
 ### Presentation Properties
 
 - **`labelPosition`** `'top' | 'side'` — Position of the field label
-- **`necessityIndicator`** `'icon' | 'label'` — Type of necessity indicator
-- **`necessityLabel`** `string` — Custom necessity label text
+- **`necessityIndicator`** `'icon' | 'label' | null` — Type of necessity indicator
+- **`isOptional`** `boolean` — Marks the label with an `(optional)` note
 - **`labelProps`** `object` — Additional props for the label element
 - **`labelSuffix`** `ReactNode` — Content to display after the label
 
 ### State Properties
 
-- **`isRequired`** `boolean` — Whether the field is required
+- **`isRequired`** `boolean` — Whether the field is required. Marks the label, unlike a bare `required` rule
 - **`isDisabled`** `boolean` — Whether the field is disabled
 - **`isLoading`** `boolean` — Whether the field is in loading state
 - **`isReadOnly`** `boolean` — Whether the field is read-only