@cube-dev/ui-kit 0.178.0 → 0.180.0

package/dist/components/form/Form/SubmitButton/SubmitButton.js.map

@@ -1 +1 @@
-{"version":3,"file":"SubmitButton.js","names":[],"sources":["../../../../../src/components/form/Form/SubmitButton/SubmitButton.tsx"],"sourcesContent":["import { FocusableRef } from '@react-types/shared';\nimport { forwardRef } from 'react';\n\nimport { useProviderProps } from '../../../../provider';\nimport { Button, CubeButtonProps } from '../../../actions/Button/Button';\nimport { useFormProps } from '../Form';\nimport { FieldTypes } from '../types';\nimport { CubeFormInstance } from '../use-form';\n\nexport interface CubeSubmitButtonProps<T extends FieldTypes = FieldTypes>\n  extends CubeButtonProps {\n  form?: CubeFormInstance<T>;\n}\n\nfunction SubmitButton(\n  props: CubeSubmitButtonProps,\n  ref: FocusableRef<HTMLElement>,\n) {\n  const providerProps = useProviderProps({} as CubeButtonProps);\n\n  props = useFormProps(props);\n\n  const { isDisabled: isContextDisabled } = providerProps;\n\n  props = useFormProps(props);\n\n  const { form, isDisabled, ...otherProps } = props;\n  const isSomethingDisabled = isDisabled || isContextDisabled;\n\n  return (\n    <Button\n      ref={ref}\n      type=\"primary\"\n      htmlType=\"submit\"\n      isLoading={form?.isSubmitting}\n      isDisabled={\n        isSomethingDisabled || form?.isSubmitting ? true : form?.isInvalid\n      }\n      {...otherProps}\n    />\n  );\n}\n\nconst _SubmitButton = forwardRef(SubmitButton);\n\n_SubmitButton.displayName = 'SubmitButton';\n\nexport { _SubmitButton as SubmitButton };\n"],"mappings":";;;;;;;;AAcA,SAAS,aACP,OACA,KACA;CACA,MAAM,gBAAgB,iBAAiB,EAAE,CAAoB;AAE7D,SAAQ,aAAa,MAAM;CAE3B,MAAM,EAAE,YAAY,sBAAsB;AAE1C,SAAQ,aAAa,MAAM;CAE3B,MAAM,EAAE,MAAM,YAAY,GAAG,eAAe;CAC5C,MAAM,sBAAsB,cAAc;AAE1C,QACE,oBAAC;EACM;EACL,MAAK;EACL,UAAS;EACT,WAAW,MAAM;EACjB,YACE,uBAAuB,MAAM,eAAe,OAAO,MAAM;EAE3D,GAAI;GACJ;;AAIN,MAAM,gBAAgB,WAAW,aAAa;AAE9C,cAAc,cAAc"}
+{"version":3,"file":"SubmitButton.js","names":[],"sources":["../../../../../src/components/form/Form/SubmitButton/SubmitButton.tsx"],"sourcesContent":["import { FocusableRef } from '@react-types/shared';\nimport { forwardRef } from 'react';\n\nimport { useProviderProps } from '../../../../provider';\nimport { Button, CubeButtonProps } from '../../../actions/Button/Button';\nimport { isModernFormController } from '../backend';\nimport { useFormProps } from '../Form';\nimport { ModernSubmitButton } from '../modern/actions';\nimport { FieldTypes } from '../types';\nimport { CubeFormInstance } from '../use-form';\n\nimport type { FormController } from '../modern/controller';\n\nexport interface CubeSubmitButtonProps<T extends FieldTypes = FieldTypes>\n  extends CubeButtonProps {\n  form?: CubeFormInstance<T> | FormController<T>;\n}\n\nfunction LegacySubmitButton(\n  props: Omit<CubeSubmitButtonProps, 'form'> & {\n    form?: CubeFormInstance<FieldTypes>;\n  },\n  ref: FocusableRef<HTMLElement>,\n) {\n  const providerProps = useProviderProps({} as CubeButtonProps);\n\n  props = useFormProps(props);\n\n  const { isDisabled: isContextDisabled } = providerProps;\n\n  props = useFormProps(props);\n\n  const { form, isDisabled, ...otherProps } = props;\n  const isSomethingDisabled = isDisabled || isContextDisabled;\n\n  return (\n    <Button\n      ref={ref}\n      type=\"primary\"\n      htmlType=\"submit\"\n      isLoading={form?.isSubmitting}\n      isDisabled={\n        isSomethingDisabled || form?.isSubmitting ? true : form?.isInvalid\n      }\n      {...otherProps}\n    />\n  );\n}\n\nfunction SubmitButton(\n  props: CubeSubmitButtonProps,\n  ref: FocusableRef<HTMLElement>,\n) {\n  const resolved = useFormProps(props);\n  if (isModernFormController(resolved.form)) {\n    return (\n      <ModernSubmitButton\n        {...resolved}\n        form={resolved.form as FormController}\n        buttonRef={ref}\n      />\n    );\n  }\n  return (\n    <LegacySubmitButtonWithRef\n      {...(props as Omit<CubeSubmitButtonProps, 'form'> & {\n        form?: CubeFormInstance<FieldTypes>;\n      })}\n      ref={ref}\n    />\n  );\n}\n\nconst LegacySubmitButtonWithRef = forwardRef(LegacySubmitButton);\nconst _SubmitButton = forwardRef(SubmitButton);\n\n_SubmitButton.displayName = 'SubmitButton';\n\nexport { _SubmitButton as SubmitButton };\n"],"mappings":";;;;;;;;;;AAkBA,SAAS,mBACP,OAGA,KACA;CACA,MAAM,gBAAgB,iBAAiB,EAAE,CAAoB;AAE7D,SAAQ,aAAa,MAAM;CAE3B,MAAM,EAAE,YAAY,sBAAsB;AAE1C,SAAQ,aAAa,MAAM;CAE3B,MAAM,EAAE,MAAM,YAAY,GAAG,eAAe;CAC5C,MAAM,sBAAsB,cAAc;AAE1C,QACE,oBAAC;EACM;EACL,MAAK;EACL,UAAS;EACT,WAAW,MAAM;EACjB,YACE,uBAAuB,MAAM,eAAe,OAAO,MAAM;EAE3D,GAAI;GACJ;;AAIN,SAAS,aACP,OACA,KACA;CACA,MAAM,WAAW,aAAa,MAAM;AACpC,KAAI,uBAAuB,SAAS,KAAK,CACvC,QACE,oBAAC;EACC,GAAI;EACJ,MAAM,SAAS;EACf,WAAW;GACX;AAGN,QACE,oBAAC;EACC,GAAK;EAGA;GACL;;AAIN,MAAM,4BAA4B,WAAW,mBAAmB;AAChE,MAAM,gBAAgB,WAAW,aAAa;AAE9C,cAAc,cAAc"}

package/dist/components/form/Form/SubmitError.js

@@ -1,13 +1,14 @@
-/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
 import { useI18n } from "../../../i18n/useI18n.js";
+import { ModernControllerContext } from "./modern/context.js";
 import { FormContext } from "./Form.js";
+import { useFormSelector } from "./modern/react.js";
 import { Alert } from "../../content/Alert/Alert.js";
 import { forwardRef, isValidElement, useContext } from "react";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/components/form/Form/SubmitError.tsx
-function SubmitError(props, ref) {
-	let { submitError } = useContext(FormContext);
+function ErrorAlert({ submitError, ...props }, ref) {
 	const { t } = useI18n();
 	if (!submitError) return null;
 	if (!isValidElement(submitError) && typeof submitError !== "string") submitError = t("form.internalError", "Internal error");
@@ -18,6 +19,28 @@ function SubmitError(props, ref) {
 		children: submitError
 	});
 }
+const ForwardedErrorAlert = forwardRef(ErrorAlert);
+function ModernSubmitError({ form, alertRef, ...props }) {
+	const submitError = useFormSelector(form, (state) => state.submitError);
+	return /* @__PURE__ */ jsx(ForwardedErrorAlert, {
+		...props,
+		ref: alertRef,
+		submitError
+	});
+}
+function SubmitError(props, ref) {
+	const modern = useContext(ModernControllerContext);
+	const legacy = useContext(FormContext);
+	return modern ? /* @__PURE__ */ jsx(ModernSubmitError, {
+		...props,
+		form: modern,
+		alertRef: ref
+	}) : /* @__PURE__ */ jsx(ForwardedErrorAlert, {
+		...props,
+		ref,
+		submitError: legacy.submitError
+	});
+}
 /**
 * An alert that shows a form error message received from the onSubmit callback.
 */

package/dist/components/form/Form/SubmitError.js.map

@@ -1 +1 @@
-{"version":3,"file":"SubmitError.js","names":[],"sources":["../../../../src/components/form/Form/SubmitError.tsx"],"sourcesContent":["import {\n  ForwardedRef,\n  forwardRef,\n  isValidElement,\n  ReactNode,\n  useContext,\n} from 'react';\n\nimport { useI18n } from '../../../i18n';\nimport { Alert, CubeAlertProps } from '../../content/Alert/index';\n\nimport { FormContext } from './Form';\n\ntype SubmitErrorContextProps = {\n  submitError?: unknown;\n};\n\nfunction SubmitError(props: CubeAlertProps, ref: ForwardedRef<HTMLDivElement>) {\n  let { submitError } = useContext(FormContext) as SubmitErrorContextProps;\n  const { t } = useI18n();\n\n  if (!submitError) {\n    return null;\n  }\n\n  if (\n    !isValidElement(submitError as ReactNode) &&\n    typeof submitError !== 'string'\n  ) {\n    submitError = t('form.internalError', 'Internal error');\n  }\n\n  return (\n    <Alert ref={ref} theme=\"danger\" {...props}>\n      {submitError as ReactNode}\n    </Alert>\n  );\n}\n\n/**\n * An alert that shows a form error message received from the onSubmit callback.\n */\nconst _SubmitError = forwardRef(SubmitError);\n\n_SubmitError.displayName = 'SubmitError';\n\nexport { _SubmitError as SubmitError };\n"],"mappings":";;;;;;;;AAiBA,SAAS,YAAY,OAAuB,KAAmC;CAC7E,IAAI,EAAE,gBAAgB,WAAW,YAAY;CAC7C,MAAM,EAAE,MAAM,SAAS;AAEvB,KAAI,CAAC,YACH,QAAO;AAGT,KACE,CAAC,eAAe,YAAyB,IACzC,OAAO,gBAAgB,SAEvB,eAAc,EAAE,sBAAsB,iBAAiB;AAGzD,QACE,oBAAC;EAAW;EAAK,OAAM;EAAS,GAAI;YACjC;GACK;;;;;AAOZ,MAAM,eAAe,WAAW,YAAY;AAE5C,aAAa,cAAc"}
+{"version":3,"file":"SubmitError.js","names":[],"sources":["../../../../src/components/form/Form/SubmitError.tsx"],"sourcesContent":["import {\n  ForwardedRef,\n  forwardRef,\n  isValidElement,\n  ReactNode,\n  useContext,\n} from 'react';\n\nimport { useI18n } from '../../../i18n';\nimport { Alert, CubeAlertProps } from '../../content/Alert/index';\n\nimport { FormContext } from './Form';\nimport { ModernControllerContext } from './modern/context';\nimport { useFormSelector } from './modern/react';\n\nimport type { FormController } from './modern/controller';\n\ntype SubmitErrorContextProps = {\n  submitError?: unknown;\n};\n\nfunction ErrorAlert(\n  { submitError, ...props }: CubeAlertProps & SubmitErrorContextProps,\n  ref: ForwardedRef<HTMLDivElement>,\n) {\n  const { t } = useI18n();\n\n  if (!submitError) {\n    return null;\n  }\n\n  if (\n    !isValidElement(submitError as ReactNode) &&\n    typeof submitError !== 'string'\n  ) {\n    submitError = t('form.internalError', 'Internal error');\n  }\n\n  return (\n    <Alert ref={ref} theme=\"danger\" {...props}>\n      {submitError as ReactNode}\n    </Alert>\n  );\n}\n\nconst ForwardedErrorAlert = forwardRef(ErrorAlert);\n\nfunction ModernSubmitError({\n  form,\n  alertRef,\n  ...props\n}: CubeAlertProps & {\n  form: FormController<any>;\n  alertRef: ForwardedRef<HTMLDivElement>;\n}) {\n  const submitError = useFormSelector(form, (state) => state.submitError);\n  return (\n    <ForwardedErrorAlert {...props} ref={alertRef} submitError={submitError} />\n  );\n}\n\nfunction SubmitError(props: CubeAlertProps, ref: ForwardedRef<HTMLDivElement>) {\n  const modern = useContext(ModernControllerContext);\n  const legacy = useContext(FormContext) as SubmitErrorContextProps;\n  return modern ? (\n    <ModernSubmitError {...props} form={modern} alertRef={ref} />\n  ) : (\n    <ForwardedErrorAlert\n      {...props}\n      ref={ref}\n      submitError={legacy.submitError}\n    />\n  );\n}\n\n/**\n * An alert that shows a form error message received from the onSubmit callback.\n */\nconst _SubmitError = forwardRef(SubmitError);\n\n_SubmitError.displayName = 'SubmitError';\n\nexport { _SubmitError as SubmitError };\n"],"mappings":";;;;;;;;;;AAqBA,SAAS,WACP,EAAE,aAAa,GAAG,SAClB,KACA;CACA,MAAM,EAAE,MAAM,SAAS;AAEvB,KAAI,CAAC,YACH,QAAO;AAGT,KACE,CAAC,eAAe,YAAyB,IACzC,OAAO,gBAAgB,SAEvB,eAAc,EAAE,sBAAsB,iBAAiB;AAGzD,QACE,oBAAC;EAAW;EAAK,OAAM;EAAS,GAAI;YACjC;GACK;;AAIZ,MAAM,sBAAsB,WAAW,WAAW;AAElD,SAAS,kBAAkB,EACzB,MACA,UACA,GAAG,SAIF;CACD,MAAM,cAAc,gBAAgB,OAAO,UAAU,MAAM,YAAY;AACvE,QACE,oBAAC;EAAoB,GAAI;EAAO,KAAK;EAAuB;GAAe;;AAI/E,SAAS,YAAY,OAAuB,KAAmC;CAC7E,MAAM,SAAS,WAAW,wBAAwB;CAClD,MAAM,SAAS,WAAW,YAAY;AACtC,QAAO,SACL,oBAAC;EAAkB,GAAI;EAAO,MAAM;EAAQ,UAAU;GAAO,GAE7D,oBAAC;EACC,GAAI;EACC;EACL,aAAa,OAAO;GACpB;;;;;AAON,MAAM,eAAe,WAAW,YAAY;AAE5C,aAAa,cAAc"}

package/dist/components/form/Form/backend.d.ts

@@ -0,0 +1,25 @@
+
+import { FormController } from "./modern/controller.js";
+
+//#region src/components/form/Form/backend.d.ts
+/**
+ * Nominal branding for the two Form backends (modernization plan §5.1).
+ *
+ * The legacy engine (`CubeFormInstance`) and the modern controller are not
+ * structurally interchangeable: each carries this symbol with its backend
+ * kind, the `<Form>` facade dispatches on it before any backend hook runs, and
+ * the legacy field adapter refuses a controller it cannot bind.
+ *
+ * Modern controllers support creation, selectors, fields, validation, and submission.
+ * Legacy-only APIs reject them explicitly.
+ */
+declare const FORM_BACKEND: unique symbol;
+interface LegacyFormBrand {
+  readonly [FORM_BACKEND]: 'legacy';
+}
+interface ModernFormBrand {
+  readonly [FORM_BACKEND]: 'modern';
+}
+//#endregion
+export { FORM_BACKEND, LegacyFormBrand, ModernFormBrand };
+//# sourceMappingURL=backend.d.ts.map

package/dist/components/form/Form/backend.js

@@ -0,0 +1,30 @@
+/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+//#region src/components/form/Form/backend.ts
+/**
+* Nominal branding for the two Form backends (modernization plan §5.1).
+*
+* The legacy engine (`CubeFormInstance`) and the modern controller are not
+* structurally interchangeable: each carries this symbol with its backend
+* kind, the `<Form>` facade dispatches on it before any backend hook runs, and
+* the legacy field adapter refuses a controller it cannot bind.
+*
+* Modern controllers support creation, selectors, fields, validation, and submission.
+* Legacy-only APIs reject them explicitly.
+*/
+const FORM_BACKEND = Symbol.for("@cube-dev/ui-kit/form-backend");
+/**
+* Only a modern brand is ever checked. Anything else — a branded legacy
+* instance, but also an unbranded object — counts as legacy on purpose: Cloud
+* narrows form props to structural types and its tests pass plain mocks, and
+* the legacy engine has always accepted them.
+*/
+function isModernFormController(value) {
+	return !!value && typeof value === "object" && value[FORM_BACKEND] === "modern";
+}
+function modernBackendUnavailableError(receiver) {
+	return /* @__PURE__ */ new Error(`${receiver} received a modern form controller, but this legacy API does not support modern controllers. Use named inputs or useFieldProps with a modern controller; Form.Item and Form.useForm() remain legacy-only.`);
+}
+
+//#endregion
+export { FORM_BACKEND, isModernFormController, modernBackendUnavailableError };
+//# sourceMappingURL=backend.js.map

package/dist/components/form/Form/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","names":[],"sources":["../../../../src/components/form/Form/backend.ts"],"sourcesContent":["/**\n * Nominal branding for the two Form backends (modernization plan §5.1).\n *\n * The legacy engine (`CubeFormInstance`) and the modern controller are not\n * structurally interchangeable: each carries this symbol with its backend\n * kind, the `<Form>` facade dispatches on it before any backend hook runs, and\n * the legacy field adapter refuses a controller it cannot bind.\n *\n * Modern controllers support creation, selectors, fields, validation, and submission.\n * Legacy-only APIs reject them explicitly.\n */\nexport const FORM_BACKEND: unique symbol = Symbol.for(\n  '@cube-dev/ui-kit/form-backend',\n);\n\nexport interface LegacyFormBrand {\n  readonly [FORM_BACKEND]: 'legacy';\n}\n\nexport interface ModernFormBrand {\n  readonly [FORM_BACKEND]: 'modern';\n}\n\nexport type { FormController } from './modern/controller';\n\n/**\n * Only a modern brand is ever checked. Anything else — a branded legacy\n * instance, but also an unbranded object — counts as legacy on purpose: Cloud\n * narrows form props to structural types and its tests pass plain mocks, and\n * the legacy engine has always accepted them.\n */\nexport function isModernFormController(\n  value: unknown,\n): value is ModernFormBrand {\n  return (\n    !!value &&\n    typeof value === 'object' &&\n    (value as Record<PropertyKey, unknown>)[FORM_BACKEND] === 'modern'\n  );\n}\n\nexport function modernBackendUnavailableError(receiver: string): Error {\n  return new Error(\n    `${receiver} received a modern form controller, but this legacy API does not support modern controllers. Use named inputs or useFieldProps with a modern controller; Form.Item and Form.useForm() remain legacy-only.`,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAWA,MAAa,eAA8B,OAAO,IAChD,gCACD;;;;;;;AAkBD,SAAgB,uBACd,OAC0B;AAC1B,QACE,CAAC,CAAC,SACF,OAAO,UAAU,YAChB,MAAuC,kBAAkB;;AAI9D,SAAgB,8BAA8B,UAAyB;AACrE,wBAAO,IAAI,MACT,GAAG,SAAS,2MACb"}

package/dist/components/form/Form/index.d.ts

@@ -1,7 +1,13 @@
 
+import { FormPath } from "./modern/values.js";
+import { ModernValidationContext } from "./modern/validation.js";
 import { FieldTypes, Fields } from "./types.js";
+import { FormValueAtPath } from "./modern/path-types.js";
+import { FormChange, ModernSubmitContext, SetValueOptions } from "./modern/types.js";
+import { FormController, ModernFieldValidationResult, ModernFormState, ModernSubmitResult, ModernValidationResult, ModernValidationRule, UseFormControllerOptions } from "./modern/controller.js";
 import { CubeFormInstance, useForm } from "./use-form.js";
-import { CubeFormProps, FormContext, useFormProps } from "./Form.js";
+import { ModernFormProps } from "./ModernFormRoot.js";
+import { CubeFormProps, FormContext, FormRootComponent, FormScopeMask, useFormProps } from "./Form.js";
 import { CubeSubmitButtonProps, _SubmitButton } from "./SubmitButton/SubmitButton.js";
 import "./SubmitButton/index.js";
 import { CubeResetButtonProps, _ResetButton } from "./ResetButton/ResetButton.js";
@@ -9,6 +15,8 @@ import "./ResetButton/index.js";
 import { CubeAlertProps } from "../../content/Alert/types.js";
 import "../../content/Alert/index.js";
 import { Field } from "./Field.js";
+import { useFormControllerContext } from "./modern/context.js";
+import { FormSelectorOptions, FormSubscribe, FormSubscribeProps, useFormController, useFormSelector } from "./modern/react.js";
 import { _SubmitError } from "./SubmitError.js";
 import { FieldReturnValue, UseFieldProps } from "./use-field/types.js";
 import { UseFieldParams, useField } from "./use-field/use-field.js";
@@ -18,17 +26,23 @@ import * as react from "react";
 import * as _react_types_shared0 from "@react-types/shared";
 
 //#region src/components/form/Form/index.d.ts
-declare const Form: (<T extends FieldTypes>(props: CubeFormProps<T> & {
-  ref?: react.Ref<HTMLFormElement>;
-}) => react.ReactElement) & {
+declare const Form: FormRootComponent & {
   Item: typeof Field;
   SubmitError: typeof _SubmitError;
   Submit: typeof _SubmitButton;
   Reset: typeof _ResetButton;
   useForm: typeof useForm;
+  useController: typeof useFormController;
+  useSelector: typeof useFormSelector;
+  Subscribe: typeof FormSubscribe;
+  useControllerContext: typeof useFormControllerContext;
 } & {
   Item: typeof Field;
   useForm: typeof useForm;
+  useController: typeof useFormController;
+  useSelector: typeof useFormSelector;
+  Subscribe: typeof FormSubscribe;
+  useControllerContext: typeof useFormControllerContext;
   Submit: react.ForwardRefExoticComponent<Omit<CubeSubmitButtonProps<FieldTypes>, "ref"> & react.RefAttributes<_react_types_shared0.FocusableRefValue<HTMLElement, HTMLElement>>>;
   Reset: react.ForwardRefExoticComponent<Omit<CubeResetButtonProps<FieldTypes>, "ref"> & react.RefAttributes<_react_types_shared0.FocusableRefValue<HTMLElement, HTMLElement>>>;
   SubmitError: react.ForwardRefExoticComponent<CubeAlertProps & react.RefAttributes<HTMLDivElement>>;

package/dist/components/form/Form/index.js

@@ -1,9 +1,11 @@
-/** @license MIT | @cube-dev/ui-kit v0.178.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+import { useFormControllerContext } from "./modern/context.js";
 import { useForm } from "./use-form.js";
-import { FormContext, _Form, useFormProps } from "./Form.js";
+import { FormContext, FormScopeMask, _Form, useFormProps } from "./Form.js";
 import { useField } from "./use-field/use-field.js";
 import { useFieldProps } from "./use-field/use-field-props.js";
 import { Field } from "./Field.js";
+import { FormSubscribe, useFormController, useFormSelector } from "./modern/react.js";
 import { _ResetButton } from "./ResetButton/ResetButton.js";
 import { _SubmitButton } from "./SubmitButton/SubmitButton.js";
 import { _SubmitError } from "./SubmitError.js";
@@ -12,6 +14,10 @@ import { _SubmitError } from "./SubmitError.js";
 const Form = Object.assign(_Form, {
 	Item: Field,
 	useForm,
+	useController: useFormController,
+	useSelector: useFormSelector,
+	Subscribe: FormSubscribe,
+	useControllerContext: useFormControllerContext,
 	Submit: _SubmitButton,
 	Reset: _ResetButton,
 	SubmitError: _SubmitError

package/dist/components/form/Form/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["SubmitButton","ResetButton"],"sources":["../../../../src/components/form/Form/index.ts"],"sourcesContent":["import { CubeAlertProps } from '../../content/Alert/index';\n\nimport { Field } from './Field';\nimport { Form as _Form, FormContext, useFormProps } from './Form';\nimport { ResetButton } from './ResetButton';\nimport { SubmitButton } from './SubmitButton';\nimport { SubmitError } from './SubmitError';\nimport { useForm } from './use-form';\n\nconst Form = Object.assign(\n  _Form as typeof _Form & {\n    Item: typeof Field;\n    SubmitError: typeof SubmitError;\n    Submit: typeof SubmitButton;\n    Reset: typeof ResetButton;\n    useForm: typeof useForm;\n  },\n  {\n    Item: Field,\n    useForm,\n    Submit: SubmitButton,\n    Reset: ResetButton,\n    SubmitError,\n  },\n);\n\nexport * from './SubmitError';\nexport * from './SubmitButton';\nexport * from './ResetButton';\nexport * from './use-field';\nexport { useFormProps, Form, Field, useForm, FormContext };\nexport type { CubeFormProps } from './Form';\nexport type { CubeFormInstance } from './use-form';\nexport type { FieldTypes, Fields } from './types';\nexport type { CubeAlertProps as CubeSubmitErrorProps };\n"],"mappings":";;;;;;;;;;;AASA,MAAM,OAAO,OAAO,OAClB,OAOA;CACE,MAAM;CACN;CACA,QAAQA;CACR,OAAOC;CACP;CACD,CACF"}
+{"version":3,"file":"index.js","names":["SubmitButton","ResetButton"],"sources":["../../../../src/components/form/Form/index.ts"],"sourcesContent":["import { CubeAlertProps } from '../../content/Alert/index';\n\nimport { Field } from './Field';\nimport {\n  Form as _Form,\n  FormContext,\n  FormScopeMask,\n  useFormProps,\n} from './Form';\nimport { useFormControllerContext } from './modern/context';\nimport {\n  FormSubscribe,\n  useFormController,\n  useFormSelector,\n} from './modern/react';\nimport { ResetButton } from './ResetButton';\nimport { SubmitButton } from './SubmitButton';\nimport { SubmitError } from './SubmitError';\nimport { useForm } from './use-form';\n\nconst Form = Object.assign(\n  _Form as typeof _Form & {\n    Item: typeof Field;\n    SubmitError: typeof SubmitError;\n    Submit: typeof SubmitButton;\n    Reset: typeof ResetButton;\n    useForm: typeof useForm;\n    useController: typeof useFormController;\n    useSelector: typeof useFormSelector;\n    Subscribe: typeof FormSubscribe;\n    useControllerContext: typeof useFormControllerContext;\n  },\n  {\n    Item: Field,\n    useForm,\n    useController: useFormController,\n    useSelector: useFormSelector,\n    Subscribe: FormSubscribe,\n    useControllerContext: useFormControllerContext,\n    Submit: SubmitButton,\n    Reset: ResetButton,\n    SubmitError,\n  },\n);\n\nexport * from './SubmitError';\nexport * from './SubmitButton';\nexport * from './ResetButton';\nexport * from './use-field';\nexport { useFormProps, Form, Field, useForm, FormContext, FormScopeMask };\nexport type { CubeFormProps } from './Form';\nexport type { ModernFormProps } from './ModernFormRoot';\nexport type {\n  FormController,\n  ModernFormState,\n  UseFormControllerOptions,\n  ModernValidationRule,\n  ModernValidationResult,\n  ModernFieldValidationResult,\n  ModernSubmitResult,\n} from './modern/controller';\nexport type { FormSelectorOptions, FormSubscribeProps } from './modern/react';\nexport type {\n  FormChange,\n  SetValueOptions,\n  ModernSubmitContext,\n} from './modern/types';\nexport type { ModernValidationContext } from './modern/validation';\nexport type { FormPath } from './modern/values';\nexport type { FormValueAtPath } from './modern/path-types';\nexport type { CubeFormInstance } from './use-form';\nexport type { FieldTypes, Fields } from './types';\nexport type { CubeAlertProps as CubeSubmitErrorProps };\n"],"mappings":";;;;;;;;;;;;;AAoBA,MAAM,OAAO,OAAO,OAClB,OAWA;CACE,MAAM;CACN;CACA,eAAe;CACf,aAAa;CACb,WAAW;CACX,sBAAsB;CACtB,QAAQA;CACR,OAAOC;CACP;CACD,CACF"}

package/dist/components/form/Form/modern/actions.js

@@ -0,0 +1,41 @@
+/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+import { useEvent } from "../../../../_internal/hooks/use-event.js";
+import { useProviderProps } from "../../../../provider.js";
+import { Button } from "../../../actions/Button/Button.js";
+import { useFormSelector } from "./react.js";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/components/form/Form/modern/actions.tsx
+function ModernSubmitButton({ form, buttonRef, ...props }) {
+	const { isDisabled: contextDisabled } = useProviderProps({});
+	const submitting = useFormSelector(form, (state) => state.isSubmitting);
+	const invalid = useFormSelector(form, (state) => state.isInvalid);
+	return /* @__PURE__ */ jsx(Button, {
+		ref: buttonRef,
+		type: "primary",
+		htmlType: "submit",
+		isLoading: submitting,
+		...props,
+		isDisabled: contextDisabled || props.isDisabled || submitting || invalid
+	});
+}
+function ModernResetButton({ form, buttonRef, onPress, ...props }) {
+	const { isDisabled: contextDisabled } = useProviderProps({});
+	const disabled = useFormSelector(form, (state) => state.isSubmitting || !state.isTouched);
+	const reset = useEvent((event) => {
+		form.reset();
+		onPress?.(event);
+	});
+	return /* @__PURE__ */ jsx(Button, {
+		ref: buttonRef,
+		type: "primary",
+		htmlType: "button",
+		...props,
+		onPress: reset,
+		isDisabled: contextDisabled || props.isDisabled || disabled
+	});
+}
+
+//#endregion
+export { ModernResetButton, ModernSubmitButton };
+//# sourceMappingURL=actions.js.map

package/dist/components/form/Form/modern/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","names":[],"sources":["../../../../../src/components/form/Form/modern/actions.tsx"],"sourcesContent":["import { useEvent } from '../../../../_internal/hooks/use-event';\nimport { useProviderProps } from '../../../../provider';\nimport { Button } from '../../../actions/Button/Button';\n\nimport { useFormSelector } from './react';\n\nimport type { FocusableRef } from '@react-types/shared';\nimport type { CubeButtonProps } from '../../../actions/Button/Button';\nimport type { FormController } from './controller';\n\nexport function ModernSubmitButton({\n  form,\n  buttonRef,\n  ...props\n}: CubeButtonProps & {\n  form: FormController<any>;\n  buttonRef: FocusableRef<HTMLElement>;\n}) {\n  const { isDisabled: contextDisabled } = useProviderProps(\n    {} as CubeButtonProps,\n  );\n  const submitting = useFormSelector(form, (state) => state.isSubmitting);\n  const invalid = useFormSelector(form, (state) => state.isInvalid);\n  return (\n    <Button\n      ref={buttonRef}\n      type=\"primary\"\n      htmlType=\"submit\"\n      isLoading={submitting}\n      {...props}\n      isDisabled={contextDisabled || props.isDisabled || submitting || invalid}\n    />\n  );\n}\n\nexport function ModernResetButton({\n  form,\n  buttonRef,\n  onPress,\n  ...props\n}: CubeButtonProps & {\n  form: FormController<any>;\n  buttonRef: FocusableRef<HTMLElement>;\n}) {\n  const { isDisabled: contextDisabled } = useProviderProps(\n    {} as CubeButtonProps,\n  );\n  const disabled = useFormSelector(\n    form,\n    (state) => state.isSubmitting || !state.isTouched,\n  );\n  const reset = useEvent((event) => {\n    form.reset();\n    onPress?.(event);\n  });\n  return (\n    <Button\n      ref={buttonRef}\n      type=\"primary\"\n      htmlType=\"button\"\n      {...props}\n      onPress={reset}\n      isDisabled={contextDisabled || props.isDisabled || disabled}\n    />\n  );\n}\n"],"mappings":";;;;;;;;AAUA,SAAgB,mBAAmB,EACjC,MACA,WACA,GAAG,SAIF;CACD,MAAM,EAAE,YAAY,oBAAoB,iBACtC,EAAE,CACH;CACD,MAAM,aAAa,gBAAgB,OAAO,UAAU,MAAM,aAAa;CACvE,MAAM,UAAU,gBAAgB,OAAO,UAAU,MAAM,UAAU;AACjE,QACE,oBAAC;EACC,KAAK;EACL,MAAK;EACL,UAAS;EACT,WAAW;EACX,GAAI;EACJ,YAAY,mBAAmB,MAAM,cAAc,cAAc;GACjE;;AAIN,SAAgB,kBAAkB,EAChC,MACA,WACA,SACA,GAAG,SAIF;CACD,MAAM,EAAE,YAAY,oBAAoB,iBACtC,EAAE,CACH;CACD,MAAM,WAAW,gBACf,OACC,UAAU,MAAM,gBAAgB,CAAC,MAAM,UACzC;CACD,MAAM,QAAQ,UAAU,UAAU;AAChC,OAAK,OAAO;AACZ,YAAU,MAAM;GAChB;AACF,QACE,oBAAC;EACC,KAAK;EACL,MAAK;EACL,UAAS;EACT,GAAI;EACJ,SAAS;EACT,YAAY,mBAAmB,MAAM,cAAc;GACnD"}

package/dist/components/form/Form/modern/context.d.ts

@@ -0,0 +1,9 @@
+
+import { FormController } from "./controller.js";
+import "react";
+
+//#region src/components/form/Form/modern/context.d.ts
+declare function useFormControllerContext<T extends object = Record<string, unknown>>(): FormController<T>;
+//#endregion
+export { useFormControllerContext };
+//# sourceMappingURL=context.d.ts.map

package/dist/components/form/Form/modern/context.js

@@ -0,0 +1,14 @@
+/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+import { createContext, useContext } from "react";
+
+//#region src/components/form/Form/modern/context.ts
+const ModernControllerContext = createContext(null);
+function useFormControllerContext() {
+	const controller = useContext(ModernControllerContext);
+	if (!controller) throw new Error("Form.useControllerContext() requires a modern <Form> root. Legacy forms and FormScopeMask do not provide a modern controller.");
+	return controller;
+}
+
+//#endregion
+export { ModernControllerContext, useFormControllerContext };
+//# sourceMappingURL=context.js.map

package/dist/components/form/Form/modern/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","names":[],"sources":["../../../../../src/components/form/Form/modern/context.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\n\nimport type { FormController } from './controller';\n\nexport const ModernControllerContext =\n  createContext<FormController<any> | null>(null);\n\nexport function useFormControllerContext<\n  T extends object = Record<string, unknown>,\n>(): FormController<T> {\n  const controller = useContext(ModernControllerContext);\n  if (!controller) {\n    throw new Error(\n      'Form.useControllerContext() requires a modern <Form> root. Legacy forms and FormScopeMask do not provide a modern controller.',\n    );\n  }\n  return controller;\n}\n"],"mappings":";;;;AAIA,MAAa,0BACX,cAA0C,KAAK;AAEjD,SAAgB,2BAEO;CACrB,MAAM,aAAa,WAAW,wBAAwB;AACtD,KAAI,CAAC,WACH,OAAM,IAAI,MACR,gIACD;AAEH,QAAO"}

package/dist/components/form/Form/modern/controller.d.ts

@@ -0,0 +1,23 @@
+
+import { FormPath } from "./values.js";
+import { ModernValidationRule as ModernValidationRule$1 } from "./validation.js";
+import { FormValueAtPath } from "./path-types.js";
+import { FormState, FormStore, FormStoreOptions, ModernFieldValidationResult as ModernFieldValidationResult$1, ModernSubmitResult as ModernSubmitResult$1, ModernValidationResult as ModernValidationResult$1, SetValueOptions } from "./types.js";
+import { FORM_BACKEND } from "../backend.js";
+import { ReactNode } from "react";
+
+//#region src/components/form/Form/modern/controller.d.ts
+type ModernValidationRule = ModernValidationRule$1<ReactNode>;
+type ModernValidationResult = ModernValidationResult$1<ReactNode>;
+type ModernFieldValidationResult = ModernFieldValidationResult$1<ReactNode>;
+type ModernSubmitResult = ModernSubmitResult$1<ReactNode>;
+type ModernFormState<T extends object = Record<string, unknown>> = FormState<T, ReactNode>;
+type UseFormControllerOptions<T extends object = Record<string, unknown>> = FormStoreOptions<T>;
+/** Public commands; registration and pipeline state tokens stay internal. */
+type FormController<T extends object = Record<string, unknown>> = Readonly<Pick<FormStore<T, ReactNode>, typeof FORM_BACKEND | 'validate' | 'submit' | 'blur' | 'getSnapshot' | 'getFieldSnapshot' | 'getValues' | 'getActiveValues' | 'subscribe' | 'setValues' | 'batch' | 'setDefaultValues' | 'adoptDefaultValues' | 'reset' | 'touch' | 'setFieldErrors' | 'clearFieldErrors' | 'setSubmitError' | 'clearSubmitError'> & {
+  getValue<const Path extends FormPath>(path: Path): FormValueAtPath<T, Path> | undefined;
+  setValue<const Path extends FormPath>(path: Path, value: FormValueAtPath<T, NoInfer<Path>> | undefined, options?: SetValueOptions): void;
+}>;
+//#endregion
+export { FormController, ModernFieldValidationResult, ModernFormState, ModernSubmitResult, ModernValidationResult, ModernValidationRule, UseFormControllerOptions };
+//# sourceMappingURL=controller.d.ts.map

package/dist/components/form/Form/modern/controller.js

@@ -0,0 +1,48 @@
+/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+import { FORM_BACKEND, isModernFormController } from "../backend.js";
+import { createFormStore } from "./store.js";
+
+//#region src/components/form/Form/modern/controller.ts
+const CONTROLLER_STORE = Symbol.for("@cube-dev/ui-kit/form-controller-store");
+/** Pure allocation for the creation hook; no listeners or external effects. */
+function createFormController(options) {
+	const store = createFormStore(options);
+	const serverSnapshot = store.getSnapshot();
+	const internals = {
+		store,
+		getServerSnapshot: () => serverSnapshot
+	};
+	return Object.freeze({
+		[FORM_BACKEND]: "modern",
+		[CONTROLLER_STORE]: internals,
+		validate: store.validate,
+		submit: store.submit,
+		blur: store.blur,
+		getSnapshot: store.getSnapshot,
+		getFieldSnapshot: store.getFieldSnapshot,
+		getValue: store.getValue,
+		getValues: store.getValues,
+		getActiveValues: store.getActiveValues,
+		subscribe: store.subscribe,
+		setValue: store.setValue,
+		setValues: store.setValues,
+		batch: store.batch,
+		setDefaultValues: store.setDefaultValues,
+		adoptDefaultValues: store.adoptDefaultValues,
+		reset: store.reset,
+		touch: store.touch,
+		setFieldErrors: store.setFieldErrors,
+		clearFieldErrors: store.clearFieldErrors,
+		setSubmitError: store.setSubmitError,
+		clearSubmitError: store.clearSubmitError
+	});
+}
+function getControllerInternals(controller, receiver) {
+	const internals = isModernFormController(controller) ? controller[CONTROLLER_STORE] : void 0;
+	if (!internals) throw new Error(`${receiver} requires a modern form controller created by Form.useController(). Legacy Form instances and bare backend brands are not supported.`);
+	return internals;
+}
+
+//#endregion
+export { createFormController, getControllerInternals };
+//# sourceMappingURL=controller.js.map

package/dist/components/form/Form/modern/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","names":[],"sources":["../../../../../src/components/form/Form/modern/controller.ts"],"sourcesContent":["import { FORM_BACKEND, isModernFormController } from '../backend';\n\nimport { createFormStore } from './store';\n\nimport type { ReactNode } from 'react';\nimport type { FormValueAtPath } from './path-types';\nimport type {\n  FormState,\n  FormStore,\n  FormStoreOptions,\n  SetValueOptions,\n  ModernFieldValidationResult as StoreFieldValidationResult,\n  ModernSubmitResult as StoreSubmitResult,\n  ModernValidationResult as StoreValidationResult,\n} from './types';\nimport type { ModernValidationRule as StoreValidationRule } from './validation';\nimport type { FormPath } from './values';\n\nexport type ModernValidationRule = StoreValidationRule<ReactNode>;\nexport type ModernValidationResult = StoreValidationResult<ReactNode>;\nexport type ModernFieldValidationResult = StoreFieldValidationResult<ReactNode>;\nexport type ModernSubmitResult = StoreSubmitResult<ReactNode>;\n\nexport type ModernFormState<T extends object = Record<string, unknown>> =\n  FormState<T, ReactNode>;\n\nexport type UseFormControllerOptions<\n  T extends object = Record<string, unknown>,\n> = FormStoreOptions<T>;\n\n/** Public commands; registration and pipeline state tokens stay internal. */\nexport type FormController<T extends object = Record<string, unknown>> =\n  Readonly<\n    Pick<\n      FormStore<T, ReactNode>,\n      | typeof FORM_BACKEND\n      | 'validate'\n      | 'submit'\n      | 'blur'\n      | 'getSnapshot'\n      | 'getFieldSnapshot'\n      | 'getValues'\n      | 'getActiveValues'\n      | 'subscribe'\n      | 'setValues'\n      | 'batch'\n      | 'setDefaultValues'\n      | 'adoptDefaultValues'\n      | 'reset'\n      | 'touch'\n      | 'setFieldErrors'\n      | 'clearFieldErrors'\n      | 'setSubmitError'\n      | 'clearSubmitError'\n    > & {\n      getValue<const Path extends FormPath>(\n        path: Path,\n      ): FormValueAtPath<T, Path> | undefined;\n      setValue<const Path extends FormPath>(\n        path: Path,\n        value: FormValueAtPath<T, NoInfer<Path>> | undefined,\n        options?: SetValueOptions,\n      ): void;\n    }\n  >;\n\n// Symbol.for also lets two copies of the kit share a controller, just as the\n// backend brand does. This symbol and the store are not package exports.\nconst CONTROLLER_STORE = Symbol.for('@cube-dev/ui-kit/form-controller-store');\n\ninterface ControllerInternals<T extends object> {\n  store: FormStore<T, ReactNode>;\n  getServerSnapshot(): ModernFormState<T>;\n}\n\n/** Pure allocation for the creation hook; no listeners or external effects. */\nexport function createFormController<T extends object>(\n  options?: UseFormControllerOptions<T>,\n): FormController<T> {\n  const store = createFormStore<T, ReactNode>(options);\n  const serverSnapshot = store.getSnapshot();\n  const internals: ControllerInternals<T> = {\n    store,\n    getServerSnapshot: () => serverSnapshot,\n  };\n  return Object.freeze({\n    [FORM_BACKEND]: 'modern' as const,\n    [CONTROLLER_STORE]: internals,\n    validate: store.validate,\n    submit: store.submit,\n    blur: store.blur,\n    getSnapshot: store.getSnapshot,\n    getFieldSnapshot: store.getFieldSnapshot,\n    getValue: store.getValue,\n    getValues: store.getValues,\n    getActiveValues: store.getActiveValues,\n    subscribe: store.subscribe,\n    setValue: store.setValue,\n    setValues: store.setValues,\n    batch: store.batch,\n    setDefaultValues: store.setDefaultValues,\n    adoptDefaultValues: store.adoptDefaultValues,\n    reset: store.reset,\n    touch: store.touch,\n    setFieldErrors: store.setFieldErrors,\n    clearFieldErrors: store.clearFieldErrors,\n    setSubmitError: store.setSubmitError,\n    clearSubmitError: store.clearSubmitError,\n  }) as FormController<T>;\n}\n\nexport function getControllerInternals<T extends object>(\n  controller: FormController<T>,\n  receiver: string,\n): ControllerInternals<T> {\n  const internals = isModernFormController(controller)\n    ? (controller as unknown as Record<symbol, ControllerInternals<T>>)[\n        CONTROLLER_STORE\n      ]\n    : undefined;\n  if (!internals) {\n    throw new Error(\n      `${receiver} requires a modern form controller created by Form.useController(). Legacy Form instances and bare backend brands are not supported.`,\n    );\n  }\n  return internals;\n}\n"],"mappings":";;;;;AAoEA,MAAM,mBAAmB,OAAO,IAAI,yCAAyC;;AAQ7E,SAAgB,qBACd,SACmB;CACnB,MAAM,QAAQ,gBAA8B,QAAQ;CACpD,MAAM,iBAAiB,MAAM,aAAa;CAC1C,MAAM,YAAoC;EACxC;EACA,yBAAyB;EAC1B;AACD,QAAO,OAAO,OAAO;GAClB,eAAe;GACf,mBAAmB;EACpB,UAAU,MAAM;EAChB,QAAQ,MAAM;EACd,MAAM,MAAM;EACZ,aAAa,MAAM;EACnB,kBAAkB,MAAM;EACxB,UAAU,MAAM;EAChB,WAAW,MAAM;EACjB,iBAAiB,MAAM;EACvB,WAAW,MAAM;EACjB,UAAU,MAAM;EAChB,WAAW,MAAM;EACjB,OAAO,MAAM;EACb,kBAAkB,MAAM;EACxB,oBAAoB,MAAM;EAC1B,OAAO,MAAM;EACb,OAAO,MAAM;EACb,gBAAgB,MAAM;EACtB,kBAAkB,MAAM;EACxB,gBAAgB,MAAM;EACtB,kBAAkB,MAAM;EACzB,CAAC;;AAGJ,SAAgB,uBACd,YACA,UACwB;CACxB,MAAM,YAAY,uBAAuB,WAAW,GAC/C,WACC,oBAEF;AACJ,KAAI,CAAC,UACH,OAAM,IAAI,MACR,GAAG,SAAS,sIACb;AAEH,QAAO"}

package/dist/components/form/Form/modern/field-binding.js

@@ -0,0 +1,41 @@
+/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+import { getFieldKey } from "./values.js";
+import { getControllerInternals } from "./controller.js";
+
+//#region src/components/form/Form/modern/field-binding.ts
+function sameFieldView(a, b) {
+	return Object.is(a?.value, b?.value) && a?.errors === b?.errors && a?.status === b?.status;
+}
+function createModernFieldBackend(form, name) {
+	const { store, getServerSnapshot } = getControllerInternals(form, `The "${name}" field`);
+	const key = getFieldKey(name);
+	return {
+		subscribe: store.subscribe,
+		getSnapshot: () => store.getFieldSnapshot(name),
+		getServerSnapshot: () => getServerSnapshot().fields[key],
+		register: () => store.register(name),
+		change: (value, dontTouch) => store.setValue(name, value, {
+			source: "user",
+			touch: !dontTouch,
+			validate: dontTouch ? "never" : "auto"
+		}),
+		blur: () => store.blur(name)
+	};
+}
+function fieldRegistrationOptions(props, defaultTrigger) {
+	const rules = props.rules?.flat(Infinity);
+	return {
+		...Object.hasOwn(props, "defaultValue") ? { defaultValue: props.defaultValue } : {},
+		preserve: props.preserve,
+		isEqual: props.isEqual,
+		rules: props.isRequired && !rules?.some((rule) => rule.required) ? [{ required: true }, ...rules ?? []] : rules,
+		rulesKey: props.rulesKey === void 0 ? void 0 : `${props.isRequired ? "required:" : ""}${props.rulesKey}`,
+		validationDelay: props.validationDelay,
+		validateTrigger: props.validateTrigger ?? defaultTrigger ?? "onBlur",
+		errorPolicy: props.errorPolicy
+	};
+}
+
+//#endregion
+export { createModernFieldBackend, fieldRegistrationOptions, sameFieldView };
+//# sourceMappingURL=field-binding.js.map

package/dist/components/form/Form/modern/field-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-binding.js","names":[],"sources":["../../../../../src/components/form/Form/modern/field-binding.ts"],"sourcesContent":["import { getControllerInternals } from './controller';\nimport { getFieldKey } from './values';\n\nimport type { ReactNode } from 'react';\nimport type { FieldCoreProps, ValidateTrigger } from '../../../../shared/form';\nimport type { FormController } from './controller';\nimport type {\n  FieldState,\n  RegistrationOptions,\n  RegistrationToken,\n} from './types';\n\n/** The only state a bound input renders; metadata stays in selector subscribers. */\nexport type FieldView = Pick<\n  FieldState<ReactNode>,\n  'value' | 'errors' | 'status'\n>;\n\nexport interface FieldBackendHandle {\n  subscribe(listener: () => void): () => void;\n  getSnapshot(): FieldView | undefined;\n  getServerSnapshot(): FieldView | undefined;\n  register(): RegistrationToken<ReactNode> | undefined;\n  change(value: unknown, dontTouch: boolean, trigger: ValidateTrigger): void;\n  blur(): void;\n}\n\nexport function sameFieldView(a?: FieldView, b?: FieldView) {\n  return (\n    Object.is(a?.value, b?.value) &&\n    a?.errors === b?.errors &&\n    a?.status === b?.status\n  );\n}\n\nexport function createModernFieldBackend(\n  form: FormController<any>,\n  name: string,\n): FieldBackendHandle {\n  const { store, getServerSnapshot } = getControllerInternals(\n    form,\n    `The \"${name}\" field`,\n  );\n  const key = getFieldKey(name);\n  return {\n    subscribe: store.subscribe,\n    getSnapshot: () => store.getFieldSnapshot(name),\n    getServerSnapshot: () => getServerSnapshot().fields[key],\n    register: () => store.register(name),\n    change: (value, dontTouch) =>\n      store.setValue(name, value, {\n        source: 'user',\n        touch: !dontTouch,\n        validate: dontTouch ? 'never' : 'auto',\n      }),\n    blur: () => store.blur(name),\n  };\n}\n\nexport function fieldRegistrationOptions(\n  props: FieldCoreProps & {\n    defaultValue?: unknown;\n    validateTrigger?: ValidateTrigger;\n  },\n  defaultTrigger?: ValidateTrigger,\n): RegistrationOptions<ReactNode> {\n  const rules = props.rules?.flat(Infinity);\n  return {\n    ...(Object.hasOwn(props, 'defaultValue')\n      ? { defaultValue: props.defaultValue }\n      : {}),\n    preserve: props.preserve,\n    isEqual: props.isEqual,\n    rules:\n      props.isRequired && !rules?.some((rule) => rule.required)\n        ? [{ required: true }, ...(rules ?? [])]\n        : rules,\n    rulesKey:\n      props.rulesKey === undefined\n        ? undefined\n        : `${props.isRequired ? 'required:' : ''}${props.rulesKey}`,\n    validationDelay: props.validationDelay,\n    validateTrigger: props.validateTrigger ?? defaultTrigger ?? 'onBlur',\n    errorPolicy: props.errorPolicy,\n  };\n}\n"],"mappings":";;;;;AA2BA,SAAgB,cAAc,GAAe,GAAe;AAC1D,QACE,OAAO,GAAG,GAAG,OAAO,GAAG,MAAM,IAC7B,GAAG,WAAW,GAAG,UACjB,GAAG,WAAW,GAAG;;AAIrB,SAAgB,yBACd,MACA,MACoB;CACpB,MAAM,EAAE,OAAO,sBAAsB,uBACnC,MACA,QAAQ,KAAK,SACd;CACD,MAAM,MAAM,YAAY,KAAK;AAC7B,QAAO;EACL,WAAW,MAAM;EACjB,mBAAmB,MAAM,iBAAiB,KAAK;EAC/C,yBAAyB,mBAAmB,CAAC,OAAO;EACpD,gBAAgB,MAAM,SAAS,KAAK;EACpC,SAAS,OAAO,cACd,MAAM,SAAS,MAAM,OAAO;GAC1B,QAAQ;GACR,OAAO,CAAC;GACR,UAAU,YAAY,UAAU;GACjC,CAAC;EACJ,YAAY,MAAM,KAAK,KAAK;EAC7B;;AAGH,SAAgB,yBACd,OAIA,gBACgC;CAChC,MAAM,QAAQ,MAAM,OAAO,KAAK,SAAS;AACzC,QAAO;EACL,GAAI,OAAO,OAAO,OAAO,eAAe,GACpC,EAAE,cAAc,MAAM,cAAc,GACpC,EAAE;EACN,UAAU,MAAM;EAChB,SAAS,MAAM;EACf,OACE,MAAM,cAAc,CAAC,OAAO,MAAM,SAAS,KAAK,SAAS,GACrD,CAAC,EAAE,UAAU,MAAM,EAAE,GAAI,SAAS,EAAE,CAAE,GACtC;EACN,UACE,MAAM,aAAa,SACf,SACA,GAAG,MAAM,aAAa,cAAc,KAAK,MAAM;EACrD,iBAAiB,MAAM;EACvB,iBAAiB,MAAM,mBAAmB,kBAAkB;EAC5D,aAAa,MAAM;EACpB"}

package/dist/components/form/Form/modern/path-types.d.ts

@@ -0,0 +1,12 @@
+
+import { FormPath } from "./values.js";
+
+//#region src/components/form/Form/modern/path-types.d.ts
+/** Resolve only the supplied path; never enumerate a model's possible paths. */
+type SegmentValue<Value, Key extends string | number> = Value extends null | undefined ? undefined : Key extends keyof Value ? Value[Key] : Value extends readonly (infer Item)[] ? Key extends `${number}` ? Item : unknown : unknown;
+type TupleValue<Value, Path extends readonly (string | number)[]> = Path extends readonly [infer Key extends string | number, ...infer Rest extends readonly (string | number)[]] ? Rest extends readonly [] ? SegmentValue<Value, Key> : TupleValue<SegmentValue<Value, Key>, Rest> : unknown;
+/** Strings are literal keys; unknown/dynamic names and paths return unknown. */
+type FormValueAtPath<Values extends object, Path extends FormPath> = Path extends string ? Path extends keyof Values ? Values[Path] : unknown : Path extends readonly (string | number)[] ? TupleValue<Values, Path> : unknown;
+//#endregion
+export { FormValueAtPath };
+//# sourceMappingURL=path-types.d.ts.map

package/dist/components/form/Form/modern/react.d.ts

@@ -0,0 +1,21 @@
+
+import { FormController, ModernFormState, UseFormControllerOptions } from "./controller.js";
+import { ReactNode } from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/form/Form/modern/react.d.ts
+declare function useFormController<T extends object = Record<string, unknown>>(options?: UseFormControllerOptions<T>): FormController<T>;
+interface FormSelectorOptions<Selected> {
+  isEqual?: (previous: Selected, next: Selected) => boolean;
+}
+declare function useFormSelector<T extends object, Selected>(controller: FormController<T>, selector: (state: ModernFormState<T>) => Selected, options?: FormSelectorOptions<Selected>): Selected;
+interface FormSubscribeProps<T extends object, Selected> extends FormSelectorOptions<Selected> {
+  /** Omit to use modern context. An explicit undefined detaches from context. */
+  form?: FormController<T>;
+  selector: (state: ModernFormState<T>) => Selected;
+  children: (selected: Selected) => ReactNode;
+}
+declare function FormSubscribe<T extends object = Record<string, unknown>, Selected = unknown>(props: FormSubscribeProps<T, Selected>): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { FormSelectorOptions, FormSubscribe, FormSubscribeProps, useFormController, useFormSelector };
+//# sourceMappingURL=react.d.ts.map

package/dist/components/form/Form/modern/react.js

@@ -0,0 +1,27 @@
+/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+import { ModernControllerContext } from "./context.js";
+import { createFormController, getControllerInternals } from "./controller.js";
+import { useContext, useState } from "react";
+import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
+import { useSyncExternalStoreWithSelector } from "use-sync-external-store/with-selector.js";
+
+//#region src/components/form/Form/modern/react.tsx
+function useFormController(options) {
+	const [controller] = useState(() => createFormController(options));
+	return controller;
+}
+function useFormSelector(controller, selector, options) {
+	const { getServerSnapshot } = getControllerInternals(controller, "Form.useSelector()");
+	return useSyncExternalStoreWithSelector(controller.subscribe, controller.getSnapshot, getServerSnapshot, selector, options?.isEqual);
+}
+function FormSubscribe(props) {
+	const fromContext = useContext(ModernControllerContext);
+	const controller = Object.hasOwn(props, "form") ? props.form : fromContext;
+	if (!controller) throw new Error("<Form.Subscribe> requires a modern form prop or a modern <Form> root.");
+	const selected = useFormSelector(controller, props.selector, { isEqual: props.isEqual });
+	return /* @__PURE__ */ jsx(Fragment$1, { children: props.children(selected) });
+}
+
+//#endregion
+export { FormSubscribe, useFormController, useFormSelector };
+//# sourceMappingURL=react.js.map

package/dist/components/form/Form/modern/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","names":[],"sources":["../../../../../src/components/form/Form/modern/react.tsx"],"sourcesContent":["import { useContext, useState } from 'react';\nimport { useSyncExternalStoreWithSelector } from 'use-sync-external-store/with-selector.js';\n\nimport { ModernControllerContext } from './context';\nimport { createFormController, getControllerInternals } from './controller';\n\nimport type { ReactNode } from 'react';\nimport type {\n  FormController,\n  ModernFormState,\n  UseFormControllerOptions,\n} from './controller';\n\nexport function useFormController<T extends object = Record<string, unknown>>(\n  options?: UseFormControllerOptions<T>,\n): FormController<T> {\n  // Initial options seed synchronously. A new options object never resets the\n  // controller, and the creator does not subscribe its owner to form changes.\n  const [controller] = useState(() => createFormController(options));\n  // Do not dispose from effect cleanup: Strict Mode and hidden React trees\n  // reconnect effects while preserving state. Subscriptions own their cleanup;\n  // the controller has no external resources and is collected with its owner.\n  return controller;\n}\n\nexport interface FormSelectorOptions<Selected> {\n  isEqual?: (previous: Selected, next: Selected) => boolean;\n}\n\nexport function useFormSelector<T extends object, Selected>(\n  controller: FormController<T>,\n  selector: (state: ModernFormState<T>) => Selected,\n  options?: FormSelectorOptions<Selected>,\n): Selected {\n  const { getServerSnapshot } = getControllerInternals(\n    controller,\n    'Form.useSelector()',\n  );\n  return useSyncExternalStoreWithSelector(\n    controller.subscribe,\n    controller.getSnapshot,\n    getServerSnapshot,\n    selector,\n    options?.isEqual,\n  );\n}\n\nexport interface FormSubscribeProps<T extends object, Selected>\n  extends FormSelectorOptions<Selected> {\n  /** Omit to use modern context. An explicit undefined detaches from context. */\n  form?: FormController<T>;\n  selector: (state: ModernFormState<T>) => Selected;\n  children: (selected: Selected) => ReactNode;\n}\n\nexport function FormSubscribe<\n  T extends object = Record<string, unknown>,\n  Selected = unknown,\n>(props: FormSubscribeProps<T, Selected>) {\n  const fromContext = useContext(ModernControllerContext);\n  const controller = Object.hasOwn(props, 'form') ? props.form : fromContext;\n  if (!controller) {\n    throw new Error(\n      '<Form.Subscribe> requires a modern form prop or a modern <Form> root.',\n    );\n  }\n  const selected = useFormSelector(controller, props.selector, {\n    isEqual: props.isEqual,\n  });\n  return <>{props.children(selected)}</>;\n}\n"],"mappings":";;;;;;;;AAaA,SAAgB,kBACd,SACmB;CAGnB,MAAM,CAAC,cAAc,eAAe,qBAAqB,QAAQ,CAAC;AAIlE,QAAO;;AAOT,SAAgB,gBACd,YACA,UACA,SACU;CACV,MAAM,EAAE,sBAAsB,uBAC5B,YACA,qBACD;AACD,QAAO,iCACL,WAAW,WACX,WAAW,aACX,mBACA,UACA,SAAS,QACV;;AAWH,SAAgB,cAGd,OAAwC;CACxC,MAAM,cAAc,WAAW,wBAAwB;CACvD,MAAM,aAAa,OAAO,OAAO,OAAO,OAAO,GAAG,MAAM,OAAO;AAC/D,KAAI,CAAC,WACH,OAAM,IAAI,MACR,wEACD;CAEH,MAAM,WAAW,gBAAgB,YAAY,MAAM,UAAU,EAC3D,SAAS,MAAM,SAChB,CAAC;AACF,QAAO,4CAAG,MAAM,SAAS,SAAS,GAAI"}