npm - @cube-dev/ui-kit - Versions diffs - 0.173.0 → 0.174.0 - Mend

@cube-dev/ui-kit 0.173.0 → 0.174.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (554) hide show

package/dist/tokens/colors.js CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.173.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 CHANGED Viewed

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

package/docs/FieldProperties.md CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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

package/docs/components/form/Form.md CHANGED Viewed

@@ -33,8 +33,7 @@ These properties are inherited by all input components within the form:
 - **`labelPosition`** `'top' | 'side' | 'split'` (default: `top`) — Where to place labels relative to inputs. `'top'` places labels above inputs, `'side'` places labels beside inputs with fixed width, `'split'` places labels and inputs on opposite sides without fixed label width
 - **`labelStyles`** `Styles` — Styles applied to field labels
 - **`requiredMark`** `boolean` (default: `true`) — Whether to show required field indicators
-- **`necessityIndicator`** `'icon' | 'label'` (default: `icon`) — Type of necessity indicator
-- **`necessityLabel`** `ReactNode` — Custom label to replace the default necessity indicator text
+- **`necessityIndicator`** `'icon' | 'label' | null` (default: `icon`) — Type of necessity indicator. `null` suppresses it
 - **`isReadOnly`** `boolean` (default: `false`) — Whether fields are read-only by default
 - **`isInvalid`** `boolean` — Invalid state for all fields
 - **`isValid`** `boolean` — Valid state for all fields
@@ -168,7 +167,8 @@ All input components within a Form accept these field-related properties:
 - **`description`** `ReactNode` — Help text displayed below the field
 - **`errorMessage`** `ReactNode` — Error message displayed when validation fails
 - **`rules`** `ValidationRule[]` — Validation rules array (see [Validation Rules](#validation-rules))
-- **`isRequired`** `boolean` — Whether the field is required
+- **`isRequired`** `boolean` — Whether the field is required. Marks the label, unlike a bare `required` rule — see [Necessity Indicators](../../FieldProperties.md#necessity-indicators)
+- **`isOptional`** `boolean` — Marks the label with an `(optional)` note. Presentational only
 - **`extra`** `ReactNode` — Additional content displayed next to the label
 - **`tooltip`** `ReactNode` — Tooltip content for the field label
 - **`labelSuffix`** `ReactNode` — Content appended after the label

package/docs/components/overlays/DialogForm.md CHANGED Viewed

@@ -39,7 +39,6 @@ DialogForm combines [Dialog](./Dialog.md) and [Form](../form/Form.md) functional
 - **`labelStyles`** `Styles` — Styles for the label
 - **`requiredMark`** `boolean` — Whether the field presents required mark
 - **`necessityIndicator`** `NecessityIndicator` — The type of necessity indicator
-- **`necessityLabel`** `ReactNode` — Custom necessity label
 - **`isReadOnly`** `boolean` — Whether the form is read only
 - **`isInvalid`** `boolean` — Invalid state for all fields in the form
 - **`isValid`** `boolean` — Valid state for all fields in the form

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@cube-dev/ui-kit",
-  "version": "0.173.0",
+  "version": "0.174.0",
   "type": "module",
   "description": "UIKit for Cube Projects",
   "repository": {