ding-react-admin 2.4.0 → 2.5.1

package/src/crud/InlineFormSet.tsx

@@ -7,6 +7,8 @@ import type {
   InlineRowContext,
 } from "./types";
 import { nestedFieldPath } from "./utils/nestedFieldPath";
+import { getFormValue } from "./utils/getFormValue";
+import { setFormValue } from "./utils/setFormValue";
 import { useRegisterInlineField } from "./context/InlineFieldsRegistry";
 import { useRegisterPayloadField } from "./context/PayloadFieldsContext";
 
@@ -29,7 +31,8 @@ export type InlineFormSetStackedProps = InlineFormSetBaseProps & {
 function emptyRow(sources: string[], defaults?: Record<string, unknown>) {
   const row: Record<string, unknown> = {};
   for (const source of sources) {
-    row[source] = defaults?.[source] ?? undefined;
+    const value = defaults ? getFormValue(defaults, source) : undefined;
+    setFormValue(row, source, value);
   }
   return row;
 }

package/src/crud/columns/BooleanColumn.tsx

@@ -1,5 +1,6 @@
 import { useMemo } from "react";
 import type { BaseSourceProps } from "../types";
+import { columnDataIndex } from "../utils/columnDataIndex";
 import { useRegisterColumn } from "../context/ListContext";
 
 export type BooleanColumnProps = BaseSourceProps & {
@@ -19,7 +20,7 @@ export function BooleanColumn({
       sortable,
       buildColumn: () => ({
         title: label ?? source,
-        dataIndex: source,
+        dataIndex: columnDataIndex(source),
         key: source,
         sorter: sortable ? true : undefined,
         render: (v: boolean) => (v ? "Yes" : "No"),

package/src/crud/columns/DateColumn.tsx

@@ -1,5 +1,6 @@
 import { useMemo } from "react";
 import type { BaseSourceProps } from "../types";
+import { columnDataIndex } from "../utils/columnDataIndex";
 import { useRegisterColumn } from "../context/ListContext";
 
 export type DateColumnProps = BaseSourceProps & {
@@ -15,7 +16,7 @@ export function DateColumn({ source, label, sortable = true }: DateColumnProps)
       sortable,
       buildColumn: () => ({
         title: label ?? source,
-        dataIndex: source,
+        dataIndex: columnDataIndex(source),
         key: source,
         sorter: sortable ? true : undefined,
         render: (v: string) => (v ? String(v).slice(0, 10) : "—"),

package/src/crud/columns/ImageColumn.tsx

@@ -1,5 +1,6 @@
 import { useMemo, type CSSProperties } from "react";
 import type { BaseSourceProps } from "../types";
+import { columnDataIndex } from "../utils/columnDataIndex";
 import { useRegisterColumn } from "../context/ListContext";
 
 export type ImageColumnProps = BaseSourceProps & {
@@ -31,7 +32,7 @@ export function ImageColumn({
       sortable,
       buildColumn: () => ({
         title: label ?? source,
-        dataIndex: source,
+        dataIndex: columnDataIndex(source),
         key: source,
         sorter: sortable ? true : undefined,
         render: (value: unknown) => {

package/src/crud/columns/NumberColumn.tsx

@@ -1,5 +1,6 @@
 import { useMemo } from "react";
 import type { BaseSourceProps } from "../types";
+import { columnDataIndex } from "../utils/columnDataIndex";
 import { useRegisterColumn } from "../context/ListContext";
 
 export type NumberColumnProps = BaseSourceProps & {
@@ -19,7 +20,7 @@ export function NumberColumn({
       sortable,
       buildColumn: () => ({
         title: label ?? source,
-        dataIndex: source,
+        dataIndex: columnDataIndex(source),
         key: source,
         sorter: sortable ? true : undefined,
       }),

package/src/crud/columns/ReferenceColumn.tsx

@@ -1,6 +1,7 @@
 import { useMemo } from "react";
 import type { BaseSourceProps, DisplayProps, ReferenceProps } from "../types";
 import { useRegisterColumn } from "../context/ListContext";
+import { getFormValue } from "../utils/getFormValue";
 import { useChoices } from "../utils/useChoices";
 import { renderDisplayValue } from "./TextColumn";
 
@@ -25,7 +26,7 @@ function ReferenceColumnCell({
     optionLabel,
     optionValue,
   );
-  const raw = record[source];
+  const raw = getFormValue(record, source);
   if (typeof display === "function") return <>{display(record)}</>;
   if (display && display !== source) {
     const nested = renderDisplayValue(record, source, display);

package/src/crud/columns/ReferenceManyColumn.tsx

@@ -1,6 +1,7 @@
 import { useMemo } from "react";
 import type { BaseSourceProps, DisplayProps, ReferenceProps } from "../types";
 import { useRegisterColumn } from "../context/ListContext";
+import { getFormValue } from "../utils/getFormValue";
 import { useChoices } from "../utils/useChoices";
 
 export type ReferenceManyColumnProps = BaseSourceProps &
@@ -23,7 +24,7 @@ function ReferenceManyColumnCell({
     optionLabel,
     optionValue,
   );
-  const raw = record[source];
+  const raw = getFormValue(record, source);
   const values = Array.isArray(raw) ? raw : [];
   return <>{labelsForValues(values)}</>;
 }

package/src/crud/columns/TextColumn.tsx

@@ -1,5 +1,6 @@
 import { useMemo } from "react";
 import type { BaseSourceProps } from "../types";
+import { columnDataIndex } from "../utils/columnDataIndex";
 import { getFormValue } from "../utils/getFormValue";
 import { useRegisterColumn } from "../context/ListContext";
 
@@ -16,7 +17,7 @@ export function TextColumn({ source, label, sortable = true }: TextColumnProps)
       sortable,
       buildColumn: () => ({
         title: label ?? source,
-        dataIndex: source,
+        dataIndex: columnDataIndex(source),
         key: source,
         sorter: sortable ? true : undefined,
       }),
@@ -34,5 +35,5 @@ export function renderDisplayValue(
 ): unknown {
   if (typeof display === "function") return display(record);
   if (display) return getFormValue(record, display);
-  return record[source];
+  return getFormValue(record, source);
 }

package/src/crud/fields/BooleanField.tsx

@@ -1,8 +1,8 @@
 import { Switch } from "antd";
-import type { BaseSourceProps, FieldRules } from "../types";
+import type { FieldSourceProps, FieldRules } from "../types";
 import { FieldWrapper } from "./FieldWrapper";
 
-export type BooleanFieldProps = BaseSourceProps & {
+export type BooleanFieldProps = FieldSourceProps & {
   name?: string;
   required?: boolean;
   rules?: FieldRules;
@@ -17,6 +17,7 @@ export function BooleanField({
   required,
   rules,
   hideLabel,
+  hidden,
   disabled: disabledProp,
 }: BooleanFieldProps) {
   return (
@@ -27,6 +28,7 @@ export function BooleanField({
       required={required}
       rules={rules}
       hideLabel={hideLabel}
+      hidden={hidden}
     >
       {({ value, onChange, disabled }) => (
         <Switch

package/src/crud/fields/DateField.tsx

@@ -1,5 +1,5 @@
 import { DatePicker } from "antd";
-import type { BaseSourceProps, FieldRules } from "../types";
+import type { FieldSourceProps, FieldRules } from "../types";
 import { parseDayjsValue } from "../utils/parseDayjsValue";
 import { FieldWrapper } from "./FieldWrapper";
 
@@ -7,7 +7,7 @@ const DATE_FORMAT = "YYYY-MM-DD";
 const DATE_TIME_FORMAT = `${DATE_FORMAT} HH:mm:ss`;
 const PARSE_FORMATS = [DATE_FORMAT, DATE_TIME_FORMAT, "YYYY-MM-DDTHH:mm:ss", "YYYY-MM-DDTHH:mm:ssZ"];
 
-export type DateFieldProps = BaseSourceProps & {
+export type DateFieldProps = FieldSourceProps & {
   name?: string;
   required?: boolean;
   rules?: FieldRules;
@@ -23,6 +23,7 @@ export function DateField({
   rules,
   showTime,
   hideLabel,
+  hidden,
 }: DateFieldProps) {
   return (
     <FieldWrapper
@@ -32,6 +33,7 @@ export function DateField({
       required={required}
       rules={rules}
       hideLabel={hideLabel}
+      hidden={hidden}
     >
       {({ value, onChange, onBlur, disabled }) => (
         <DatePicker

package/src/crud/fields/FieldWrapper.tsx

@@ -7,6 +7,8 @@ import {
   useRegisterPayloadField,
   useRegisterSectionField,
 } from "../context/PayloadFieldsContext";
+import { shouldRegisterSourceInPayload } from "../utils/shouldRegisterSourceInPayload";
+import { isSourceHidden, useHiddenSources } from "../HiddenSources";
 
 export type FieldWrapperProps = {
   /** Logical field name — used for submit payload tracking on top-level fields. */
@@ -18,6 +20,8 @@ export type FieldWrapperProps = {
   rules?: FieldRules;
   /** Tabular inline cells: column header replaces the label. */
   hideLabel?: boolean;
+  /** Hide the control but keep the value in the form and save payload. */
+  hidden?: boolean;
   children: (props: {
     value: unknown;
     onChange: (value: unknown) => void;
@@ -34,10 +38,12 @@ export function FieldWrapper({
   required,
   rules,
   hideLabel,
+  hidden,
   children,
 }: FieldWrapperProps) {
   const fieldName = name ?? source;
-  const isTopLevel = !fieldName.includes(".");
+  const registerSource = shouldRegisterSourceInPayload(source, name);
+  const isHidden = isSourceHidden(source, hidden, useHiddenSources());
 
   // react-hook-form: connect this field to the form from <ResourceForm>'s FormProvider.
   // `control` is passed to <Controller> below so value, onChange, and validation work.
@@ -49,13 +55,20 @@ export function FieldWrapper({
   const fieldLabel = hideLabel ? undefined : (label ?? source);
   const requiredMessage = label ?? source;
 
-  // Add this field's `source` to the Save payload (ResourceForm → buildFormPayload).
-  // `isTopLevel` is false when `name` contains "." (e.g. inline cell `__inline_lines.0.label`) —
-  // those values live in the inline array and are saved by saveInlineRows, not the parent PATCH.
-  useRegisterPayloadField(source, isTopLevel);
+  // Nested parent fields (`source="address.city"`) register; inline cells
+  // (`name="lines.0.label"`, `source="label"`) do not — those go through the inline array.
+  useRegisterPayloadField(source, registerSource);
+  useRegisterSectionField(source, registerSource);
 
-  // Same top-level check: attach this field to the current FormTab / FormStep for error highlighting.
-  useRegisterSectionField(source, isTopLevel);
+  if (isHidden) {
+    return (
+      <Controller
+        name={fieldName}
+        control={control}
+        render={() => <></>}
+      />
+    );
+  }
 
   return (
     <Controller

package/src/crud/fields/FileField.tsx

@@ -1,7 +1,7 @@
 import { DeleteOutlined, PaperClipOutlined, UploadOutlined } from "@ant-design/icons";
 import { Button, Space, Typography } from "antd";
 import { useRef } from "react";
-import type { BaseSourceProps, FieldRules } from "../types";
+import type { FieldSourceProps, FieldRules } from "../types";
 import { FieldWrapper } from "./FieldWrapper";
 import {
   getUploadFileName,
@@ -9,7 +9,7 @@ import {
   type UploadFieldValue,
 } from "./uploadFieldUtils";
 
-export type FileFieldProps = BaseSourceProps & {
+export type FileFieldProps = FieldSourceProps & {
   name?: string;
   required?: boolean;
   rules?: FieldRules;
@@ -97,6 +97,7 @@ export function FileField({
   required,
   rules,
   hideLabel,
+  hidden,
   clearable,
   accept,
 }: FileFieldProps) {
@@ -108,6 +109,7 @@ export function FileField({
       required={required}
       rules={rules}
       hideLabel={hideLabel}
+      hidden={hidden}
     >
       {({ value, onChange, disabled }) => (
         <FileFieldInput

package/src/crud/fields/ImageField.tsx

@@ -1,12 +1,12 @@
 import { DeleteOutlined, UploadOutlined } from "@ant-design/icons";
 import { Button, Image, Space } from "antd";
 import { useRef } from "react";
-import type { BaseSourceProps, FieldRules } from "../types";
+import type { FieldSourceProps, FieldRules } from "../types";
 import { FieldWrapper } from "./FieldWrapper";
 import { hasUploadValue, type UploadFieldValue } from "./uploadFieldUtils";
 import { useUploadPreviewUrl } from "./useUploadPreviewUrl";
 
-export type ImageFieldProps = BaseSourceProps & {
+export type ImageFieldProps = FieldSourceProps & {
   name?: string;
   required?: boolean;
   rules?: FieldRules;
@@ -92,6 +92,7 @@ export function ImageField({
   required,
   rules,
   hideLabel,
+  hidden,
   clearable,
   accept,
   previewWidth,
@@ -104,6 +105,7 @@ export function ImageField({
       required={required}
       rules={rules}
       hideLabel={hideLabel}
+      hidden={hidden}
     >
       {({ value, onChange, disabled }) => (
         <ImageFieldInput

package/src/crud/fields/NumberField.tsx

@@ -1,9 +1,9 @@
 import { InputNumber } from "antd";
 import type { CSSProperties } from "react";
-import type { BaseSourceProps, FieldRules } from "../types";
+import type { FieldSourceProps, FieldRules } from "../types";
 import { FieldWrapper } from "./FieldWrapper";
 
-export type NumberFieldProps = BaseSourceProps & {
+export type NumberFieldProps = FieldSourceProps & {
   name?: string;
   required?: boolean;
   rules?: FieldRules;
@@ -25,6 +25,7 @@ export function NumberField({
   step,
   inputStyle,
   hideLabel,
+  hidden,
 }: NumberFieldProps) {
   return (
     <FieldWrapper
@@ -34,6 +35,7 @@ export function NumberField({
       required={required}
       rules={rules}
       hideLabel={hideLabel}
+      hidden={hidden}
     >
       {({ value, onChange, onBlur, disabled }) => (
         <InputNumber

package/src/crud/fields/PasswordField.tsx

@@ -1,9 +1,9 @@
 import { Input } from "antd";
 import { useWatch } from "react-hook-form";
-import type { BaseSourceProps, FieldRules } from "../types";
+import type { FieldSourceProps, FieldRules } from "../types";
 import { FieldWrapper } from "./FieldWrapper";
 
-export type PasswordFieldProps = BaseSourceProps & {
+export type PasswordFieldProps = FieldSourceProps & {
   name?: string;
   required?: boolean;
   rules?: FieldRules;
@@ -22,6 +22,7 @@ function PasswordInputField({
   rules,
   autoComplete,
   hideLabel,
+  hidden,
 }: PasswordFieldProps) {
   return (
     <FieldWrapper
@@ -31,6 +32,7 @@ function PasswordInputField({
       required={required}
       rules={rules}
       hideLabel={hideLabel}
+      hidden={hidden}
     >
       {({ value, onChange, onBlur, disabled }) => (
         <Input.Password
@@ -55,6 +57,7 @@ export function PasswordField({
   confirmLabel = "Confirm password",
   autoComplete = "new-password",
   hideLabel,
+  hidden,
 }: PasswordFieldProps) {
   const password = useWatch({ name: name ?? source, disabled: !confirmSource });
 
@@ -68,6 +71,7 @@ export function PasswordField({
         rules={rules}
         autoComplete={autoComplete}
         hideLabel={hideLabel}
+        hidden={hidden}
       />
     );
   }
@@ -82,6 +86,7 @@ export function PasswordField({
         rules={rules}
         autoComplete={autoComplete}
         hideLabel={hideLabel}
+        hidden={hidden}
       />
       <PasswordInputField
         source={confirmSource}
@@ -93,6 +98,7 @@ export function PasswordField({
           validate: (value: string) =>
             !password || value === password || "Passwords do not match",
         }}
+        hidden={hidden}
       />
     </>
   );

package/src/crud/fields/ReferenceField.tsx

@@ -3,7 +3,7 @@ import type { CSSProperties } from "react";
 import { useMemo, useState } from "react";
 import { useWatch } from "react-hook-form";
 import type {
-  BaseSourceProps,
+  FieldSourceProps,
   ChoiceOption,
   FieldRules,
   ReferenceProps,
@@ -21,7 +21,7 @@ import { ReferenceInputActions } from "./ReferenceInputActions";
 import type { ResourcePermissions } from "../../permissions/resourcePermissions";
 import type { ReactNode } from "react";
 
-export type ReferenceFieldProps = BaseSourceProps &
+export type ReferenceFieldProps = FieldSourceProps &
   ReferenceProps & {
     name?: string;
     required?: boolean;
@@ -142,8 +142,10 @@ function ReferenceFieldSelect({
       {...referenceSelectDropdownProps({ popupMatchSelectWidth, popupMinWidth })}
       value={referenceSelectDisplayValue(selectedLoading, selectValue, undefined)}
       onChange={(next) => {
-        onChange(next);
-        onValueChange?.(next, optionForValue(next), { name: fieldName });
+        // Ant Design clear emits undefined; RHF Controller ignores that.
+        const value = next ?? null;
+        onChange(value);
+        onValueChange?.(value, optionForValue(next), { name: fieldName });
       }}
       options={selectOptions}
       loading={selectState.loading}
@@ -197,6 +199,7 @@ export function ReferenceField({
   allowClear,
   disabled: disabledProp,
   hideLabel,
+  hidden,
   inputStyle,
   onValueChange,
   lazy = true,
@@ -224,6 +227,7 @@ export function ReferenceField({
       required={required}
       rules={rules}
       hideLabel={hideLabel}
+      hidden={hidden}
     >
       {({ value, onChange, disabled, name: fieldName }) => (
         <ReferenceFieldSelect

package/src/crud/fields/ReferenceManyField.tsx

@@ -1,7 +1,7 @@
 import { Select } from "antd";
 import { useMemo, useState } from "react";
 import { useWatch } from "react-hook-form";
-import type { BaseSourceProps, FieldRules, ReferenceProps } from "../types";
+import type { FieldSourceProps, FieldRules, ReferenceProps } from "../types";
 import { valuesAsIds } from "../utils/choiceSelectionUtils";
 import { referenceSelectDropdownProps } from "../utils/referenceSelectDropdownProps";
 import { referenceSelectNotFoundContent } from "../utils/referenceSelectNotFoundContent";
@@ -15,7 +15,7 @@ import { ReferenceInputActions } from "./ReferenceInputActions";
 import type { ResourcePermissions } from "../../permissions/resourcePermissions";
 import type { ReactNode } from "react";
 
-export type ReferenceManyFieldProps = BaseSourceProps &
+export type ReferenceManyFieldProps = FieldSourceProps &
   ReferenceProps & {
     name?: string;
     required?: boolean;
@@ -106,7 +106,7 @@ function ReferenceManyFieldSelect({
       {...referenceSelectDropdownProps({ popupMatchSelectWidth, popupMinWidth })}
       mode="multiple"
       value={referenceSelectDisplayValue(selectedLoading, selectValue, [])}
-      onChange={onChange}
+      onChange={(next) => onChange(next ?? [])}
       options={selectOptions}
       loading={selectState.loading}
       notFoundContent={referenceSelectNotFoundContent(selectState.loading)}
@@ -165,6 +165,7 @@ export function ReferenceManyField({
   search,
   allowClear = true,
   hideLabel,
+  hidden,
   disabled: disabledProp,
   lazy = true,
   recordSource,
@@ -191,6 +192,7 @@ export function ReferenceManyField({
       required={required}
       rules={rules}
       hideLabel={hideLabel}
+      hidden={hidden}
     >
       {({ value, onChange, disabled }) => (
         <ReferenceManyFieldSelect

package/src/crud/fields/SelectField.tsx

@@ -1,8 +1,8 @@
 import { Select } from "antd";
-import type { BaseSourceProps, ChoiceOption, FieldRules } from "../types";
+import type { FieldSourceProps, ChoiceOption, FieldRules } from "../types";
 import { FieldWrapper } from "./FieldWrapper";
 
-export type SelectFieldProps = BaseSourceProps & {
+export type SelectFieldProps = FieldSourceProps & {
   name?: string;
   required?: boolean;
   rules?: FieldRules;
@@ -22,6 +22,7 @@ export function SelectField({
   mode,
   allowClear,
   hideLabel,
+  hidden,
 }: SelectFieldProps) {
   return (
     <FieldWrapper
@@ -31,11 +32,12 @@ export function SelectField({
       required={required}
       rules={rules}
       hideLabel={hideLabel}
+      hidden={hidden}
     >
       {({ value, onChange, disabled }) => (
         <Select
           value={value as string | number | (string | number)[] | undefined}
-          onChange={onChange}
+          onChange={(next) => onChange(next ?? null)}
           options={choices}
           mode={mode}
           allowClear={allowClear}

package/src/crud/fields/TextAreaField.tsx

@@ -1,9 +1,9 @@
 import { Input } from "antd";
 import type { CSSProperties } from "react";
-import type { BaseSourceProps, FieldRules } from "../types";
+import type { FieldSourceProps, FieldRules } from "../types";
 import { FieldWrapper } from "./FieldWrapper";
 
-export type TextAreaFieldProps = BaseSourceProps & {
+export type TextAreaFieldProps = FieldSourceProps & {
   name?: string;
   required?: boolean;
   rules?: FieldRules;
@@ -25,6 +25,7 @@ export function TextAreaField({
   placeholder,
   inputStyle,
   hideLabel,
+  hidden,
   rows = 4,
   maxLength,
   showCount,
@@ -38,6 +39,7 @@ export function TextAreaField({
       required={required}
       rules={rules}
       hideLabel={hideLabel}
+      hidden={hidden}
     >
       {({ value, onChange, onBlur, disabled }) => (
         <Input.TextArea

package/src/crud/fields/TextField.tsx

@@ -1,9 +1,9 @@
 import { Input } from "antd";
 import type { CSSProperties } from "react";
-import type { BaseSourceProps, FieldRules } from "../types";
+import type { FieldSourceProps, FieldRules } from "../types";
 import { FieldWrapper } from "./FieldWrapper";
 
-export type TextFieldProps = BaseSourceProps & {
+export type TextFieldProps = FieldSourceProps & {
   name?: string;
   required?: boolean;
   rules?: FieldRules;
@@ -21,6 +21,7 @@ export function TextField({
   placeholder,
   inputStyle,
   hideLabel,
+  hidden,
 }: TextFieldProps) {
   return (
     <FieldWrapper
@@ -30,6 +31,7 @@ export function TextField({
       required={required}
       rules={rules}
       hideLabel={hideLabel}
+      hidden={hidden}
     >
       {({ value, onChange, onBlur, disabled }) => (
         <Input

package/src/crud/fields/TimeField.tsx

@@ -1,12 +1,12 @@
 import { TimePicker } from "antd";
-import type { BaseSourceProps, FieldRules } from "../types";
+import type { FieldSourceProps, FieldRules } from "../types";
 import { parseDayjsValue } from "../utils/parseDayjsValue";
 import { FieldWrapper } from "./FieldWrapper";
 
 const DEFAULT_TIME_FORMAT = "HH:mm:ss";
 const PARSE_FORMATS = [DEFAULT_TIME_FORMAT, "HH:mm", "H:mm:ss", "H:mm"];
 
-export type TimeFieldProps = BaseSourceProps & {
+export type TimeFieldProps = FieldSourceProps & {
   name?: string;
   required?: boolean;
   rules?: FieldRules;
@@ -22,6 +22,7 @@ export function TimeField({
   required,
   rules,
   hideLabel,
+  hidden,
   format = DEFAULT_TIME_FORMAT,
 }: TimeFieldProps) {
   return (
@@ -32,6 +33,7 @@ export function TimeField({
       required={required}
       rules={rules}
       hideLabel={hideLabel}
+      hidden={hidden}
     >
       {({ value, onChange, onBlur, disabled }) => (
         <TimePicker

package/src/crud/index.ts

@@ -5,6 +5,7 @@ export { ResourceForm } from "./ResourceForm";
 export type { ResourceFormProps } from "./ResourceForm";
 export { ResourceFormModal } from "./ResourceFormModal";
 export type { ResourceFormModalProps } from "./ResourceFormModal";
+export { HiddenSources } from "./HiddenSources";
 export { InlineFormSet, InlineFormSetStacked } from "./InlineFormSet";
 export type {
   InlineFormSetProps,
@@ -75,6 +76,7 @@ export { getFormValue } from "./utils/getFormValue";
 export { setFormValue } from "./utils/setFormValue";
 export { buildFormPayload } from "./utils/buildFormPayload";
 export { buildInlineRowsPayload } from "./utils/buildInlineRowsPayload";
+export { columnDataIndex } from "./utils/columnDataIndex";
 export { buildResourceFormSubmitBody } from "./utils/buildResourceFormSubmitBody";
 export { prepareFormSubmitBody } from "./utils/prepareFormSubmitBody";
 export { toFormData } from "./utils/toFormData";
@@ -90,6 +92,7 @@ export type { InlineFieldRegistration } from "./context/InlineFieldsRegistry";
 
 export type {
   BaseSourceProps,
+  FieldSourceProps,
   ChoiceOption,
   ChoicesLoader,
   ReferenceProps,

package/src/crud/types.ts

@@ -8,6 +8,12 @@ export type BaseSourceProps = {
   label?: string;
 };
 
+/** Form fields only — columns and filters do not hide-and-keep a value. */
+export type FieldSourceProps = BaseSourceProps & {
+  /** Hide the control but keep the value in the form and save payload. */
+  hidden?: boolean;
+};
+
 export type ChoiceOption = {
   label: string;
   value: unknown;