@cube-dev/ui-kit 0.0.0-canary-1b2d462 → 0.0.0-canary-740dafc

package/dist/utils/react/index.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { isDevEnv } from "../is-dev-env.js";
 import { useSyncExternalStore } from "react";

package/dist/utils/react/useBufferedValue.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | 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.0.0-canary-1b2d462 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-740dafc | Cube Dev Team */
 //#region src/version.ts
-const VERSION = "0.0.0-canary-1b2d462";
+const VERSION = "0.0.0-canary-740dafc";
 const TASTY_VERSION = "3.9.2";
 if (typeof window !== "undefined") {
 	const version = VERSION;

package/docs/CreateComponent.md

@@ -15,7 +15,7 @@ Creating a component involves several optional but recommended elements:
 
 Everything is optional - you can create simplified components without all features, but exported UI Kit components should be feature-rich and consistent.
 
-Form-aware inputs continue to use the existing `useFieldProps` integration. The modern Form migration currently exposes controller creation and selectors for state consumers; modern field binding is a later phase. Do not register a modern field during render or connect a modern controller through the legacy input path. See [Form](./components/form/Form.md) for the current integration boundary.
+Form-aware inputs use `useFieldProps` for both legacy instances and modern controllers. Map the control’s value API with `valuePropsMapper` and pass the resolved props to `wrapWithField`. The hook owns modern registration after commit, narrow subscriptions, cleanup, and unique accessible ids. Do not register during render, call the legacy adapter directly, or wrap a modern control in `Form.Item`. See [Form](./components/form/Form.md) for the current integration boundary.
 
 ## Core Concepts
 

package/docs/Usage.md

@@ -471,7 +471,7 @@ const [form] = useForm();
 
 ### useForm Hook
 
-`Form.useController()` is the explicit modern alternative. Its creator does not subscribe; use `Form.useSelector(controller, selector, { isEqual })` or `<Form.Subscribe>` for reactive reads, and `Form.useControllerContext()` for descendant access. This migration preview supports controller commands and subscriptions; named UI Kit fields and submission still require the legacy `Form.useForm()` backend. See the [Form documentation](./components/form/Form.md) for scope, defaults, and SSR contracts.
+`Form.useController()` is the explicit modern alternative. Its creator does not subscribe; use `Form.useSelector(controller, selector, { isEqual })` or `<Form.Subscribe>` for reactive reads, and `Form.useControllerContext()` for descendant access. Named UI Kit inputs bind to modern controllers through commit-time registration and per-field subscriptions. Custom controls use `useFieldProps`; `Form.Item` remains legacy-only. Validation and submission still require the legacy `Form.useForm()` backend in this migration preview. See the [Form documentation](./components/form/Form.md) for scope, defaults, and SSR contracts.
 
 Returns a `CubeFormInstance` with:
 

package/docs/components/form/Form.md

@@ -14,6 +14,7 @@ function AmountPreview() {
 
   return (
     <Form form={form}>
+      <NumberInput name="amount" label="Amount" />
       <button type="button" onClick={() => form.setValue('amount', 20)}>
         Set amount
       </button>
@@ -31,7 +32,9 @@ The creator does not subscribe its owner. `Form.useSelector(form, selector, { is
 
 Use selectors for render-time state. `getValue`, `getValues`, `getActiveValues`, `getFieldSnapshot`, and `getSnapshot` are imperative reads; `subscribe` supports imperative observers. `values` contains retained data and `activeValues` contains registered fields. Commands include `setValue`, `setValues`, `batch`, `touch`, the defaults/reset commands, and explicit field/submit error setters. String paths are literal names; tuples such as `['rows', 0, 'amount']` address nested data. `setValue` accepts `{ source, touch, notify }`; programmatic changes do not touch or notify `onValuesChange` unless requested, while user changes do both by default. The creation-time `onValuesChange(values, change)` callback receives retained values and `{ names, source, kind }`.
 
-The current modern root supplies presentation and controller context only. Named UI Kit inputs, `Form.Item`, `Form.Submit`, `Form.Reset`, `Form.SubmitError`, validation rules, and submission orchestration are not yet supported. Keep production input forms on `Form.useForm()` until those migration phases land. Modern roots reject `defaultValues` and root callback props; use controller creation options for defaults and `onValuesChange`. A root with a native `action` keeps browser submission; without an action, submission is prevented until the modern pipeline is available. Legacy wrappers such as `DialogForm` keep legacy-only types.
+Named UI Kit inputs bind to the modern controller automatically; `<TextInput name="email" form={form} />` also works outside a root. Inputs subscribe only to their own value, errors, and validation status. Custom controls use `useFieldProps` and `wrapWithField`; `Form.Item` stays legacy-only. Controller values and defaults win over field defaults, including explicit `undefined` and `null`. Duplicate fields share a value but receive unique accessible ids. Groups register once and keep their options detached.
+
+Removing a field removes it from `activeValues` immediately and retains its value by default. Use `preserve={false}` to remove its retained value after cleanup; the baseline remains available to reset. Changing a name or controller releases the old registration. Explicit `form={undefined}` detaches an input. Modern validation rules, submission orchestration, `Form.Submit`, `Form.Reset`, and `Form.SubmitError` remain migration work; use the legacy backend when those features are needed. Modern roots reject `defaultValues` and root callback props; use controller creation options for defaults and `onValuesChange`. A root with a native `action` keeps browser submission; without an action, submission is prevented until the modern pipeline is available. Legacy wrappers such as `DialogForm` keep legacy-only types.
 
 For SSR, seed the controller with the same serializable `defaultValues` on server and client. Server rendering and initial hydration select the cached creation snapshot; after hydration, subscribers catch up to current client state. Prepare server data before creating the controller. Each mount owns a separate controller, and subscriptions clean up on unmount; Strict Mode effect replay does not dispose live controllers.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cube-dev/ui-kit",
-  "version": "0.0.0-canary-1b2d462",
+  "version": "0.0.0-canary-740dafc",
   "type": "module",
   "description": "UIKit for Cube Projects",
   "repository": {