@payloadcms/ui 3.81.0-canary.4 → 3.81.0-internal-debug.1a0f4d0

package/dist/forms/useField/index.js

@@ -1,6 +1,4 @@
 'use client';
-
-import { c as _c } from "react/compiler-runtime";
 import React, { useCallback, useMemo, useRef } from 'react';
 import { useThrottledEffect } from '../../hooks/useThrottledEffect.js';
 import { useAuth } from '../../providers/Auth/index.js';
@@ -10,309 +8,199 @@ import { useOperation } from '../../providers/Operation/index.js';
 import { useTranslation } from '../../providers/Translation/index.js';
 import { useDocumentForm, useForm, useFormFields, useFormInitializing, useFormProcessing, useFormSubmitted } from '../Form/context.js';
 import { useFieldPath } from '../RenderFields/context.js';
-const useFieldInForm = options => {
-  const $ = _c(65);
-  let t0;
-  if ($[0] !== options) {
-    t0 = options || {};
-    $[0] = options;
-    $[1] = t0;
-  } else {
-    t0 = $[1];
-  }
-  const {
-    disableFormData: t1,
-    hasRows,
-    path: pathFromOptions,
-    potentiallyStalePath,
-    validate
-  } = t0;
-  const disableFormData = t1 === undefined ? false : t1;
-  const pathFromContext = useFieldPath();
-  const path = pathFromOptions || pathFromContext || potentiallyStalePath;
-  const submitted = useFormSubmitted();
-  const processing = useFormProcessing();
-  const initializing = useFormInitializing();
-  const {
-    user
-  } = useAuth();
-  const {
-    id,
-    collectionSlug
-  } = useDocumentInfo();
-  const operation = useOperation();
-  const dispatchField = useFormFields(_temp);
-  let t2;
-  if ($[2] !== path) {
-    t2 = t3 => {
-      const [fields] = t3;
-      return fields && fields?.[path] || null;
-    };
-    $[2] = path;
-    $[3] = t2;
-  } else {
-    t2 = $[3];
-  }
-  const field = useFormFields(t2);
-  const {
-    t
-  } = useTranslation();
-  const {
-    config
-  } = useConfig();
-  const {
-    getData,
-    getDataByPath,
-    getSiblingData,
-    setModified
-  } = useForm();
-  const documentForm = useDocumentForm();
-  const filterOptions = field?.filterOptions;
-  const value = field?.value;
-  const initialValue = field?.initialValue;
-  const valid = typeof field?.valid === "boolean" ? field.valid : true;
-  const showError = valid === false && submitted;
-  const prevValid = useRef(valid);
-  const prevErrorMessage = useRef(field?.errorMessage);
-  let t3;
-  if ($[4] !== path) {
-    t3 = path ? path.split(".") : [];
-    $[4] = path;
-    $[5] = t3;
-  } else {
-    t3 = $[5];
-  }
-  const pathSegments = t3;
-  let t4;
-  if ($[6] !== disableFormData || $[7] !== dispatchField || $[8] !== hasRows || $[9] !== path || $[10] !== setModified) {
-    t4 = (e, t5) => {
-      const disableModifyingForm = t5 === undefined ? false : t5;
-      const isEvent = e && typeof e === "object" && typeof e.preventDefault === "function" && typeof e.stopPropagation === "function";
-      const val = isEvent ? e.target.value : e;
-      dispatchField({
-        type: "UPDATE",
-        disableFormData: disableFormData || hasRows && val > 0,
-        path,
-        value: val
-      });
-      if (!disableModifyingForm) {
-        setModified(true);
-      }
-    };
-    $[6] = disableFormData;
-    $[7] = dispatchField;
-    $[8] = hasRows;
-    $[9] = path;
-    $[10] = setModified;
-    $[11] = t4;
-  } else {
-    t4 = $[11];
-  }
-  const setValue = t4;
-  const t5 = field?.blocksFilterOptions;
-  const t6 = field?.customComponents;
-  const t7 = processing || initializing;
-  const t8 = field?.errorMessage;
-  let t9;
-  if ($[12] !== field?.errorPaths) {
-    t9 = field?.errorPaths || [];
-    $[12] = field?.errorPaths;
-    $[13] = t9;
-  } else {
-    t9 = $[13];
-  }
-  const t10 = field?.rows;
-  const t11 = field?.selectFilterOptions;
-  const t12 = field?.valid;
-  let t13;
-  if ($[14] !== filterOptions || $[15] !== initialValue || $[16] !== initializing || $[17] !== path || $[18] !== processing || $[19] !== setValue || $[20] !== showError || $[21] !== submitted || $[22] !== t10 || $[23] !== t11 || $[24] !== t12 || $[25] !== t5 || $[26] !== t6 || $[27] !== t7 || $[28] !== t8 || $[29] !== t9 || $[30] !== value) {
-    t13 = {
-      blocksFilterOptions: t5,
-      customComponents: t6,
-      disabled: t7,
-      errorMessage: t8,
-      errorPaths: t9,
-      filterOptions,
-      formInitializing: initializing,
-      formProcessing: processing,
-      formSubmitted: submitted,
-      initialValue,
-      path,
-      rows: t10,
-      selectFilterOptions: t11,
-      setValue,
-      showError,
-      valid: t12,
-      value
-    };
-    $[14] = filterOptions;
-    $[15] = initialValue;
-    $[16] = initializing;
-    $[17] = path;
-    $[18] = processing;
-    $[19] = setValue;
-    $[20] = showError;
-    $[21] = submitted;
-    $[22] = t10;
-    $[23] = t11;
-    $[24] = t12;
-    $[25] = t5;
-    $[26] = t6;
-    $[27] = t7;
-    $[28] = t8;
-    $[29] = t9;
-    $[30] = value;
-    $[31] = t13;
-  } else {
-    t13 = $[31];
-  }
-  const result = t13;
-  let t14;
-  if ($[32] !== collectionSlug || $[33] !== config || $[34] !== disableFormData || $[35] !== dispatchField || $[36] !== documentForm || $[37] !== field || $[38] !== getData || $[39] !== getDataByPath || $[40] !== getSiblingData || $[41] !== hasRows || $[42] !== id || $[43] !== operation || $[44] !== path || $[45] !== pathSegments || $[46] !== t || $[47] !== user || $[48] !== validate || $[49] !== value) {
-    t14 = () => {
-      const validateField = async () => {
-        let valueToValidate = value;
-        if (field?.rows && Array.isArray(field.rows)) {
-          valueToValidate = getDataByPath(path);
-        }
-        let errorMessage = prevErrorMessage.current;
-        let valid_0 = prevValid.current;
-        const data = getData();
-        const isValid = typeof validate === "function" ? await validate(valueToValidate, {
-          id,
-          blockData: undefined,
-          collectionSlug,
-          data: documentForm?.getData ? documentForm.getData() : data,
-          event: "onChange",
-          operation,
-          path: pathSegments,
-          preferences: {},
-          req: {
-            payload: {
-              config
-            },
-            t,
-            user
-          },
-          siblingData: getSiblingData(path)
-        }) : typeof prevErrorMessage.current === "string" ? prevErrorMessage.current : prevValid.current;
-        if (typeof isValid === "string") {
-          valid_0 = false;
-          errorMessage = isValid;
-        } else {
-          if (typeof isValid === "boolean") {
-            valid_0 = isValid;
-            errorMessage = undefined;
-          }
+const useFieldInForm = (options)=>{
+    const { disableFormData = false, hasRows, path: pathFromOptions, potentiallyStalePath, validate } = options || {};
+    const pathFromContext = useFieldPath();
+    // This is a workaround for stale props given to server rendered components.
+    // See the notes in the `potentiallyStalePath` type definition for more details.
+    const path = pathFromOptions || pathFromContext || potentiallyStalePath;
+    const submitted = useFormSubmitted();
+    const processing = useFormProcessing();
+    const initializing = useFormInitializing();
+    const { user } = useAuth();
+    const { id, collectionSlug } = useDocumentInfo();
+    const operation = useOperation();
+    const dispatchField = useFormFields(([_, dispatch])=>dispatch);
+    const field = useFormFields(([fields])=>fields && fields?.[path] || null);
+    const { t } = useTranslation();
+    const { config } = useConfig();
+    const { getData, getDataByPath, getSiblingData, setModified } = useForm();
+    const documentForm = useDocumentForm();
+    const filterOptions = field?.filterOptions;
+    const value = field?.value;
+    const initialValue = field?.initialValue;
+    const valid = typeof field?.valid === 'boolean' ? field.valid : true;
+    const showError = valid === false && submitted;
+    const prevValid = useRef(valid);
+    const prevErrorMessage = useRef(field?.errorMessage);
+    const pathSegments = path ? path.split('.') : [];
+    // Method to return from `useField`, used to
+    // update field values from field component(s)
+    const setValue = useCallback((e, disableModifyingForm = false)=>{
+        // TODO:
+        // There are no built-in fields that pass events into `e`.
+        // Remove this check in the next major version.
+        const isEvent = e && typeof e === 'object' && typeof e.preventDefault === 'function' && typeof e.stopPropagation === 'function';
+        const val = isEvent ? e.target.value : e;
+        dispatchField({
+            type: 'UPDATE',
+            disableFormData: disableFormData || hasRows && val > 0,
+            path,
+            value: val
+        });
+        if (!disableModifyingForm) {
+            setModified(true);
         }
-        if (valid_0 !== prevValid.current || errorMessage !== prevErrorMessage.current) {
-          prevValid.current = valid_0;
-          prevErrorMessage.current = errorMessage;
-          const update = {
-            type: "UPDATE",
-            errorMessage,
+    }, [
+        setModified,
+        path,
+        dispatchField,
+        disableFormData,
+        hasRows
+    ]);
+    // Store result from hook as ref
+    // to prevent unnecessary rerenders
+    const result = useMemo(()=>({
+            blocksFilterOptions: field?.blocksFilterOptions,
+            customComponents: field?.customComponents,
+            disabled: processing || initializing,
+            errorMessage: field?.errorMessage,
+            errorPaths: field?.errorPaths || [],
+            filterOptions,
+            formInitializing: initializing,
+            formProcessing: processing,
+            formSubmitted: submitted,
+            initialValue,
             path,
             rows: field?.rows,
-            valid: valid_0,
-            validate,
+            selectFilterOptions: field?.selectFilterOptions,
+            setValue,
+            showError,
+            valid: field?.valid,
             value
-          };
-          if (disableFormData || (hasRows ? typeof value === "number" && value > 0 : false)) {
-            update.disableFormData = true;
-          }
-          if (typeof dispatchField === "function") {
-            dispatchField(update);
-          }
-        }
-      };
-      validateField();
-    };
-    $[32] = collectionSlug;
-    $[33] = config;
-    $[34] = disableFormData;
-    $[35] = dispatchField;
-    $[36] = documentForm;
-    $[37] = field;
-    $[38] = getData;
-    $[39] = getDataByPath;
-    $[40] = getSiblingData;
-    $[41] = hasRows;
-    $[42] = id;
-    $[43] = operation;
-    $[44] = path;
-    $[45] = pathSegments;
-    $[46] = t;
-    $[47] = user;
-    $[48] = validate;
-    $[49] = value;
-    $[50] = t14;
-  } else {
-    t14 = $[50];
-  }
-  const t15 = field?.rows;
-  let t16;
-  if ($[51] !== collectionSlug || $[52] !== disableFormData || $[53] !== dispatchField || $[54] !== getData || $[55] !== getDataByPath || $[56] !== getSiblingData || $[57] !== id || $[58] !== operation || $[59] !== path || $[60] !== t15 || $[61] !== user || $[62] !== validate || $[63] !== value) {
-    t16 = [value, disableFormData, dispatchField, getData, getSiblingData, getDataByPath, id, operation, path, user, validate, t15, collectionSlug];
-    $[51] = collectionSlug;
-    $[52] = disableFormData;
-    $[53] = dispatchField;
-    $[54] = getData;
-    $[55] = getDataByPath;
-    $[56] = getSiblingData;
-    $[57] = id;
-    $[58] = operation;
-    $[59] = path;
-    $[60] = t15;
-    $[61] = user;
-    $[62] = validate;
-    $[63] = value;
-    $[64] = t16;
-  } else {
-    t16 = $[64];
-  }
-  useThrottledEffect(t14, 150, t16);
-  return result;
+        }), [
+        field,
+        processing,
+        setValue,
+        showError,
+        submitted,
+        value,
+        initialValue,
+        path,
+        filterOptions,
+        initializing
+    ]);
+    // Throttle the validate function
+    useThrottledEffect(()=>{
+        const validateField = async ()=>{
+            let valueToValidate = value;
+            if (field?.rows && Array.isArray(field.rows)) {
+                valueToValidate = getDataByPath(path);
+            }
+            let errorMessage = prevErrorMessage.current;
+            let valid = prevValid.current;
+            const data = getData();
+            const isValid = typeof validate === 'function' ? await validate(valueToValidate, {
+                id,
+                blockData: undefined,
+                // Will be expensive to get - not worth to pass to client-side validation, as this can be obtained by the user using `useFormFields()`
+                collectionSlug,
+                data: documentForm?.getData ? documentForm.getData() : data,
+                event: 'onChange',
+                operation,
+                path: pathSegments,
+                preferences: {},
+                req: {
+                    payload: {
+                        config
+                    },
+                    t,
+                    user
+                },
+                siblingData: getSiblingData(path)
+            }) : typeof prevErrorMessage.current === 'string' ? prevErrorMessage.current : prevValid.current;
+            if (typeof isValid === 'string') {
+                valid = false;
+                errorMessage = isValid;
+            } else if (typeof isValid === 'boolean') {
+                valid = isValid;
+                errorMessage = undefined;
+            }
+            // Only dispatch if the validation result has changed
+            // This will prevent unnecessary rerenders
+            if (valid !== prevValid.current || errorMessage !== prevErrorMessage.current) {
+                prevValid.current = valid;
+                prevErrorMessage.current = errorMessage;
+                const update = {
+                    type: 'UPDATE',
+                    errorMessage,
+                    path,
+                    rows: field?.rows,
+                    valid,
+                    validate,
+                    value
+                };
+                if (disableFormData || (hasRows ? typeof value === 'number' && value > 0 : false)) {
+                    update.disableFormData = true;
+                }
+                if (typeof dispatchField === 'function') {
+                    dispatchField(update);
+                }
+            }
+        };
+        void validateField();
+    }, 150, [
+        value,
+        disableFormData,
+        dispatchField,
+        getData,
+        getSiblingData,
+        getDataByPath,
+        id,
+        operation,
+        path,
+        user,
+        validate,
+        field?.rows,
+        collectionSlug
+    ]);
+    return result;
 };
 /**
  * Context to allow providing useField value for fields directly, if managed outside the Form
  *
  * @experimental
- */
-export const FieldContext = /*#__PURE__*/React.createContext(undefined);
+ */ export const FieldContext = /*#__PURE__*/ React.createContext(undefined);
 /**
  * Get and set the value of a form field.
  *
  * @see https://payloadcms.com/docs/admin/react-hooks#usefield
- */
-export const useField = options => {
-  const pathFromContext = useFieldPath();
-  const fieldContext = React.use(FieldContext);
-  // Lock the mode on first render so hook order is stable forever. This ensures
-  // that hooks are called in the same order each time a component renders => should
-  // not break the rule of hooks.
-  const hasFieldContext = React.useRef(null);
-  if (hasFieldContext.current === null) {
-    // Use field context, if a field context exists **and** the path matches. If the path
-    // does not match, this could be the field context of a parent field => there likely is
-    // a nested <Form /> we should use instead => 'form'
-    const currentPath = options?.path || pathFromContext || options?.potentiallyStalePath;
-    hasFieldContext.current = fieldContext && currentPath && fieldContext.path === currentPath ? true : false;
-  }
-  if (hasFieldContext.current === true) {
-    if (!fieldContext) {
-      // Provider was removed after mount. That violates hook guarantees.
-      throw new Error('FieldContext was removed after mount. This breaks hook ordering.');
+ */ export const useField = (options)=>{
+    const pathFromContext = useFieldPath();
+    const fieldContext = React.use(FieldContext);
+    // Lock the mode on first render so hook order is stable forever. This ensures
+    // that hooks are called in the same order each time a component renders => should
+    // not break the rule of hooks.
+    const hasFieldContext = React.useRef(null);
+    if (hasFieldContext.current === null) {
+        // Use field context, if a field context exists **and** the path matches. If the path
+        // does not match, this could be the field context of a parent field => there likely is
+        // a nested <Form /> we should use instead => 'form'
+        const currentPath = options?.path || pathFromContext || options?.potentiallyStalePath;
+        hasFieldContext.current = fieldContext && currentPath && fieldContext.path === currentPath ? true : false;
     }
-    return fieldContext;
-  }
-  // We intentionally guard this hook call with a mode that is fixed on first render.
-  // The order is consistent across renders. Silence the linter’s false positive.
-  // eslint-disable-next-line react-compiler/react-compiler
-  // eslint-disable-next-line react-hooks/rules-of-hooks
-  return useFieldInForm(options);
+    if (hasFieldContext.current === true) {
+        if (!fieldContext) {
+            // Provider was removed after mount. That violates hook guarantees.
+            throw new Error('FieldContext was removed after mount. This breaks hook ordering.');
+        }
+        return fieldContext;
+    }
+    // We intentionally guard this hook call with a mode that is fixed on first render.
+    // The order is consistent across renders. Silence the linter’s false positive.
+    // eslint-disable-next-line react-compiler/react-compiler
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    return useFieldInForm(options);
 };
-function _temp(t0) {
-  const [, dispatch] = t0;
-  return dispatch;
-}
+
 //# sourceMappingURL=index.js.map

package/dist/forms/useField/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["c","_c","React","useCallback","useMemo","useRef","useThrottledEffect","useAuth","useConfig","useDocumentInfo","useOperation","useTranslation","useDocumentForm","useForm","useFormFields","useFormInitializing","useFormProcessing","useFormSubmitted","useFieldPath","useFieldInForm","options","$","t0","disableFormData","t1","hasRows","path","pathFromOptions","potentiallyStalePath","validate","undefined","pathFromContext","submitted","processing","initializing","user","id","collectionSlug","operation","dispatchField","_temp","t2","t3","fields","field","t","config","getData","getDataByPath","getSiblingData","setModified","documentForm","filterOptions","value","initialValue","valid","showError","prevValid","prevErrorMessage","errorMessage","split","pathSegments","t4","e","t5","disableModifyingForm","isEvent","preventDefault","stopPropagation","val","target","type","setValue","blocksFilterOptions","t6","customComponents","t7","t8","t9","errorPaths","t10","rows","t11","selectFilterOptions","t12","t13","disabled","formInitializing","formProcessing","formSubmitted","result","t14","validateField","valueToValidate","Array","isArray","current","valid_0","data","isValid","blockData","event","preferences","req","payload","siblingData","update","t15","t16","FieldContext","createContext","useField","fieldContext","use","hasFieldContext","currentPath","Error","dispatch"],"sources":["../../../src/forms/useField/index.tsx"],"sourcesContent":["'use client'\nimport type { PayloadRequest } from 'payload'\n\nimport React, { useCallback, useMemo, useRef } from 'react'\n\nimport type { UPDATE } from '../Form/types.js'\nimport type { FieldType, Options } from './types.js'\n\nexport type { FieldType, Options }\n\nimport { useThrottledEffect } from '../../hooks/useThrottledEffect.js'\nimport { useAuth } from '../../providers/Auth/index.js'\nimport { useConfig } from '../../providers/Config/index.js'\nimport { useDocumentInfo } from '../../providers/DocumentInfo/index.js'\nimport { useOperation } from '../../providers/Operation/index.js'\nimport { useTranslation } from '../../providers/Translation/index.js'\nimport {\n  useDocumentForm,\n  useForm,\n  useFormFields,\n  useFormInitializing,\n  useFormProcessing,\n  useFormSubmitted,\n} from '../Form/context.js'\nimport { useFieldPath } from '../RenderFields/context.js'\n\nconst useFieldInForm = <TValue,>(options?: Options): FieldType<TValue> => {\n  const {\n    disableFormData = false,\n    hasRows,\n    path: pathFromOptions,\n    potentiallyStalePath,\n    validate,\n  } = options || {}\n\n  const pathFromContext = useFieldPath()\n\n  // This is a workaround for stale props given to server rendered components.\n  // See the notes in the `potentiallyStalePath` type definition for more details.\n  const path = pathFromOptions || pathFromContext || potentiallyStalePath\n\n  const submitted = useFormSubmitted()\n  const processing = useFormProcessing()\n  const initializing = useFormInitializing()\n  const { user } = useAuth()\n  const { id, collectionSlug } = useDocumentInfo()\n  const operation = useOperation()\n\n  const dispatchField = useFormFields(([_, dispatch]) => dispatch)\n  const field = useFormFields(([fields]) => (fields && fields?.[path]) || null)\n\n  const { t } = useTranslation()\n  const { config } = useConfig()\n\n  const { getData, getDataByPath, getSiblingData, setModified } = useForm()\n  const documentForm = useDocumentForm()\n\n  const filterOptions = field?.filterOptions\n  const value = field?.value as TValue\n  const initialValue = field?.initialValue as TValue\n  const valid = typeof field?.valid === 'boolean' ? field.valid : true\n  const showError = valid === false && submitted\n\n  const prevValid = useRef(valid)\n  const prevErrorMessage = useRef(field?.errorMessage)\n\n  const pathSegments = path ? path.split('.') : []\n\n  // Method to return from `useField`, used to\n  // update field values from field component(s)\n  const setValue = useCallback(\n    (e, disableModifyingForm = false) => {\n      // TODO:\n      // There are no built-in fields that pass events into `e`.\n      // Remove this check in the next major version.\n      const isEvent =\n        e &&\n        typeof e === 'object' &&\n        typeof e.preventDefault === 'function' &&\n        typeof e.stopPropagation === 'function'\n\n      const val = isEvent ? e.target.value : e\n\n      dispatchField({\n        type: 'UPDATE',\n        disableFormData: disableFormData || (hasRows && val > 0),\n        path,\n        value: val,\n      })\n\n      if (!disableModifyingForm) {\n        setModified(true)\n      }\n    },\n    [setModified, path, dispatchField, disableFormData, hasRows],\n  )\n\n  // Store result from hook as ref\n  // to prevent unnecessary rerenders\n  const result: FieldType<TValue> = useMemo(\n    () => ({\n      blocksFilterOptions: field?.blocksFilterOptions,\n      customComponents: field?.customComponents,\n      disabled: processing || initializing,\n      errorMessage: field?.errorMessage,\n      errorPaths: field?.errorPaths || [],\n      filterOptions,\n      formInitializing: initializing,\n      formProcessing: processing,\n      formSubmitted: submitted,\n      initialValue,\n      path,\n      rows: field?.rows,\n      selectFilterOptions: field?.selectFilterOptions,\n      setValue,\n      showError,\n      valid: field?.valid,\n      value,\n    }),\n    [\n      field,\n      processing,\n      setValue,\n      showError,\n      submitted,\n      value,\n      initialValue,\n      path,\n      filterOptions,\n      initializing,\n    ],\n  )\n\n  // Throttle the validate function\n  useThrottledEffect(\n    () => {\n      const validateField = async () => {\n        let valueToValidate = value\n\n        if (field?.rows && Array.isArray(field.rows)) {\n          valueToValidate = getDataByPath(path)\n        }\n\n        let errorMessage: string | undefined = prevErrorMessage.current\n        let valid: boolean | string = prevValid.current\n\n        const data = getData()\n        const isValid =\n          typeof validate === 'function'\n            ? await validate(valueToValidate, {\n                id,\n                blockData: undefined, // Will be expensive to get - not worth to pass to client-side validation, as this can be obtained by the user using `useFormFields()`\n                collectionSlug,\n                data: documentForm?.getData ? documentForm.getData() : data,\n                event: 'onChange',\n                operation,\n                path: pathSegments,\n                preferences: {} as any,\n                req: {\n                  payload: {\n                    config,\n                  },\n                  t,\n                  user,\n                } as unknown as PayloadRequest,\n                siblingData: getSiblingData(path),\n              })\n            : typeof prevErrorMessage.current === 'string'\n              ? prevErrorMessage.current\n              : prevValid.current\n\n        if (typeof isValid === 'string') {\n          valid = false\n          errorMessage = isValid\n        } else if (typeof isValid === 'boolean') {\n          valid = isValid\n          errorMessage = undefined\n        }\n\n        // Only dispatch if the validation result has changed\n        // This will prevent unnecessary rerenders\n        if (valid !== prevValid.current || errorMessage !== prevErrorMessage.current) {\n          prevValid.current = valid\n          prevErrorMessage.current = errorMessage\n\n          const update: UPDATE = {\n            type: 'UPDATE',\n            errorMessage,\n            path,\n            rows: field?.rows,\n            valid,\n            validate,\n            value,\n          }\n\n          if (disableFormData || (hasRows ? typeof value === 'number' && value > 0 : false)) {\n            update.disableFormData = true\n          }\n\n          if (typeof dispatchField === 'function') {\n            dispatchField(update)\n          }\n        }\n      }\n\n      void validateField()\n    },\n    150,\n    [\n      value,\n      disableFormData,\n      dispatchField,\n      getData,\n      getSiblingData,\n      getDataByPath,\n      id,\n      operation,\n      path,\n      user,\n      validate,\n      field?.rows,\n      collectionSlug,\n    ],\n  )\n\n  return result\n}\n\n/**\n * Context to allow providing useField value for fields directly, if managed outside the Form\n *\n * @experimental\n */\nexport const FieldContext = React.createContext<FieldType<unknown> | undefined>(undefined)\n\n/**\n * Get and set the value of a form field.\n *\n * @see https://payloadcms.com/docs/admin/react-hooks#usefield\n */\nexport const useField = <TValue,>(options?: Options): FieldType<TValue> => {\n  const pathFromContext = useFieldPath()\n\n  const fieldContext = React.use(FieldContext) as FieldType<TValue> | undefined\n\n  // Lock the mode on first render so hook order is stable forever. This ensures\n  // that hooks are called in the same order each time a component renders => should\n  // not break the rule of hooks.\n  const hasFieldContext = React.useRef<false | null | true>(null)\n  if (hasFieldContext.current === null) {\n    // Use field context, if a field context exists **and** the path matches. If the path\n    // does not match, this could be the field context of a parent field => there likely is\n    // a nested <Form /> we should use instead => 'form'\n    const currentPath = options?.path || pathFromContext || options?.potentiallyStalePath\n\n    hasFieldContext.current =\n      fieldContext && currentPath && fieldContext.path === currentPath ? true : false\n  }\n\n  if (hasFieldContext.current === true) {\n    if (!fieldContext) {\n      // Provider was removed after mount. That violates hook guarantees.\n      throw new Error('FieldContext was removed after mount. This breaks hook ordering.')\n    }\n    return fieldContext\n  }\n\n  // We intentionally guard this hook call with a mode that is fixed on first render.\n  // The order is consistent across renders. Silence the linter’s false positive.\n\n  // eslint-disable-next-line react-compiler/react-compiler\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  return useFieldInForm<TValue>(options)\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"sources":["../../../src/forms/useField/index.tsx"],"sourcesContent":["'use client'\nimport type { PayloadRequest } from 'payload'\n\nimport React, { useCallback, useMemo, useRef } from 'react'\n\nimport type { UPDATE } from '../Form/types.js'\nimport type { FieldType, Options } from './types.js'\n\nexport type { FieldType, Options }\n\nimport { useThrottledEffect } from '../../hooks/useThrottledEffect.js'\nimport { useAuth } from '../../providers/Auth/index.js'\nimport { useConfig } from '../../providers/Config/index.js'\nimport { useDocumentInfo } from '../../providers/DocumentInfo/index.js'\nimport { useOperation } from '../../providers/Operation/index.js'\nimport { useTranslation } from '../../providers/Translation/index.js'\nimport {\n  useDocumentForm,\n  useForm,\n  useFormFields,\n  useFormInitializing,\n  useFormProcessing,\n  useFormSubmitted,\n} from '../Form/context.js'\nimport { useFieldPath } from '../RenderFields/context.js'\n\nconst useFieldInForm = <TValue,>(options?: Options): FieldType<TValue> => {\n  const {\n    disableFormData = false,\n    hasRows,\n    path: pathFromOptions,\n    potentiallyStalePath,\n    validate,\n  } = options || {}\n\n  const pathFromContext = useFieldPath()\n\n  // This is a workaround for stale props given to server rendered components.\n  // See the notes in the `potentiallyStalePath` type definition for more details.\n  const path = pathFromOptions || pathFromContext || potentiallyStalePath\n\n  const submitted = useFormSubmitted()\n  const processing = useFormProcessing()\n  const initializing = useFormInitializing()\n  const { user } = useAuth()\n  const { id, collectionSlug } = useDocumentInfo()\n  const operation = useOperation()\n\n  const dispatchField = useFormFields(([_, dispatch]) => dispatch)\n  const field = useFormFields(([fields]) => (fields && fields?.[path]) || null)\n\n  const { t } = useTranslation()\n  const { config } = useConfig()\n\n  const { getData, getDataByPath, getSiblingData, setModified } = useForm()\n  const documentForm = useDocumentForm()\n\n  const filterOptions = field?.filterOptions\n  const value = field?.value as TValue\n  const initialValue = field?.initialValue as TValue\n  const valid = typeof field?.valid === 'boolean' ? field.valid : true\n  const showError = valid === false && submitted\n\n  const prevValid = useRef(valid)\n  const prevErrorMessage = useRef(field?.errorMessage)\n\n  const pathSegments = path ? path.split('.') : []\n\n  // Method to return from `useField`, used to\n  // update field values from field component(s)\n  const setValue = useCallback(\n    (e, disableModifyingForm = false) => {\n      // TODO:\n      // There are no built-in fields that pass events into `e`.\n      // Remove this check in the next major version.\n      const isEvent =\n        e &&\n        typeof e === 'object' &&\n        typeof e.preventDefault === 'function' &&\n        typeof e.stopPropagation === 'function'\n\n      const val = isEvent ? e.target.value : e\n\n      dispatchField({\n        type: 'UPDATE',\n        disableFormData: disableFormData || (hasRows && val > 0),\n        path,\n        value: val,\n      })\n\n      if (!disableModifyingForm) {\n        setModified(true)\n      }\n    },\n    [setModified, path, dispatchField, disableFormData, hasRows],\n  )\n\n  // Store result from hook as ref\n  // to prevent unnecessary rerenders\n  const result: FieldType<TValue> = useMemo(\n    () => ({\n      blocksFilterOptions: field?.blocksFilterOptions,\n      customComponents: field?.customComponents,\n      disabled: processing || initializing,\n      errorMessage: field?.errorMessage,\n      errorPaths: field?.errorPaths || [],\n      filterOptions,\n      formInitializing: initializing,\n      formProcessing: processing,\n      formSubmitted: submitted,\n      initialValue,\n      path,\n      rows: field?.rows,\n      selectFilterOptions: field?.selectFilterOptions,\n      setValue,\n      showError,\n      valid: field?.valid,\n      value,\n    }),\n    [\n      field,\n      processing,\n      setValue,\n      showError,\n      submitted,\n      value,\n      initialValue,\n      path,\n      filterOptions,\n      initializing,\n    ],\n  )\n\n  // Throttle the validate function\n  useThrottledEffect(\n    () => {\n      const validateField = async () => {\n        let valueToValidate = value\n\n        if (field?.rows && Array.isArray(field.rows)) {\n          valueToValidate = getDataByPath(path)\n        }\n\n        let errorMessage: string | undefined = prevErrorMessage.current\n        let valid: boolean | string = prevValid.current\n\n        const data = getData()\n        const isValid =\n          typeof validate === 'function'\n            ? await validate(valueToValidate, {\n                id,\n                blockData: undefined, // Will be expensive to get - not worth to pass to client-side validation, as this can be obtained by the user using `useFormFields()`\n                collectionSlug,\n                data: documentForm?.getData ? documentForm.getData() : data,\n                event: 'onChange',\n                operation,\n                path: pathSegments,\n                preferences: {} as any,\n                req: {\n                  payload: {\n                    config,\n                  },\n                  t,\n                  user,\n                } as unknown as PayloadRequest,\n                siblingData: getSiblingData(path),\n              })\n            : typeof prevErrorMessage.current === 'string'\n              ? prevErrorMessage.current\n              : prevValid.current\n\n        if (typeof isValid === 'string') {\n          valid = false\n          errorMessage = isValid\n        } else if (typeof isValid === 'boolean') {\n          valid = isValid\n          errorMessage = undefined\n        }\n\n        // Only dispatch if the validation result has changed\n        // This will prevent unnecessary rerenders\n        if (valid !== prevValid.current || errorMessage !== prevErrorMessage.current) {\n          prevValid.current = valid\n          prevErrorMessage.current = errorMessage\n\n          const update: UPDATE = {\n            type: 'UPDATE',\n            errorMessage,\n            path,\n            rows: field?.rows,\n            valid,\n            validate,\n            value,\n          }\n\n          if (disableFormData || (hasRows ? typeof value === 'number' && value > 0 : false)) {\n            update.disableFormData = true\n          }\n\n          if (typeof dispatchField === 'function') {\n            dispatchField(update)\n          }\n        }\n      }\n\n      void validateField()\n    },\n    150,\n    [\n      value,\n      disableFormData,\n      dispatchField,\n      getData,\n      getSiblingData,\n      getDataByPath,\n      id,\n      operation,\n      path,\n      user,\n      validate,\n      field?.rows,\n      collectionSlug,\n    ],\n  )\n\n  return result\n}\n\n/**\n * Context to allow providing useField value for fields directly, if managed outside the Form\n *\n * @experimental\n */\nexport const FieldContext = React.createContext<FieldType<unknown> | undefined>(undefined)\n\n/**\n * Get and set the value of a form field.\n *\n * @see https://payloadcms.com/docs/admin/react-hooks#usefield\n */\nexport const useField = <TValue,>(options?: Options): FieldType<TValue> => {\n  const pathFromContext = useFieldPath()\n\n  const fieldContext = React.use(FieldContext) as FieldType<TValue> | undefined\n\n  // Lock the mode on first render so hook order is stable forever. This ensures\n  // that hooks are called in the same order each time a component renders => should\n  // not break the rule of hooks.\n  const hasFieldContext = React.useRef<false | null | true>(null)\n  if (hasFieldContext.current === null) {\n    // Use field context, if a field context exists **and** the path matches. If the path\n    // does not match, this could be the field context of a parent field => there likely is\n    // a nested <Form /> we should use instead => 'form'\n    const currentPath = options?.path || pathFromContext || options?.potentiallyStalePath\n\n    hasFieldContext.current =\n      fieldContext && currentPath && fieldContext.path === currentPath ? true : false\n  }\n\n  if (hasFieldContext.current === true) {\n    if (!fieldContext) {\n      // Provider was removed after mount. That violates hook guarantees.\n      throw new Error('FieldContext was removed after mount. This breaks hook ordering.')\n    }\n    return fieldContext\n  }\n\n  // We intentionally guard this hook call with a mode that is fixed on first render.\n  // The order is consistent across renders. Silence the linter’s false positive.\n\n  // eslint-disable-next-line react-compiler/react-compiler\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  return useFieldInForm<TValue>(options)\n}\n"],"names":["React","useCallback","useMemo","useRef","useThrottledEffect","useAuth","useConfig","useDocumentInfo","useOperation","useTranslation","useDocumentForm","useForm","useFormFields","useFormInitializing","useFormProcessing","useFormSubmitted","useFieldPath","useFieldInForm","options","disableFormData","hasRows","path","pathFromOptions","potentiallyStalePath","validate","pathFromContext","submitted","processing","initializing","user","id","collectionSlug","operation","dispatchField","_","dispatch","field","fields","t","config","getData","getDataByPath","getSiblingData","setModified","documentForm","filterOptions","value","initialValue","valid","showError","prevValid","prevErrorMessage","errorMessage","pathSegments","split","setValue","e","disableModifyingForm","isEvent","preventDefault","stopPropagation","val","target","type","result","blocksFilterOptions","customComponents","disabled","errorPaths","formInitializing","formProcessing","formSubmitted","rows","selectFilterOptions","validateField","valueToValidate","Array","isArray","current","data","isValid","blockData","undefined","event","preferences","req","payload","siblingData","update","FieldContext","createContext","useField","fieldContext","use","hasFieldContext","currentPath","Error"],"mappings":"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"}

package/dist/forms/useField/types.js

@@ -1,2 +1,21 @@
-export {};
+/**
+   * If `path` is provided to this hook, it will be used outright. This is useful when calling this hook directly within a custom component.
+   * Otherwise, the field will attempt to get the path from the `FieldPathContext` via the `useFieldPath` hook.
+   * If still not found, the `potentiallyStalePath` arg will be used. See the note below about why this is important.
+   */ /**
+   * Custom server components receive a static `path` prop at render-time, leading to temporarily stale paths when re-ordering rows in form state.
+   * This is because when manipulating rows, field paths change in form state, but the prop remains the same until the component is re-rendered on the server.
+   * This causes the component to temporarily point to the wrong field in form state until the server responds with a freshly rendered component.
+   * To prevent this, fields are wrapped with a `FieldPathContext` which is guaranteed to be up-to-date.
+   * The `path` prop that Payload's default fields receive, then, are sent into this hook as the `potentiallyStalePath` arg.
+   * This ensures that:
+   *   1. Custom components that use this hook directly will still respect the `path` prop as top priority.
+   *   2. Custom server components that blindly spread their props into default Payload fields still prefer the dynamic path from context.
+   *   3. Components that render default Payload fields directly do not require a `FieldPathProvider`, e.g. the email field in the account view.
+   */ /**
+   * Client-side validation function fired when the form is submitted.
+   */ export { }; /**
+   * @deprecated - readOnly is no longer returned from useField. Remove this in 4.0.
+   */ 
+
 //# sourceMappingURL=types.js.map

package/dist/forms/useField/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../../src/forms/useField/types.ts"],"sourcesContent":["import type { FieldState, Validate } from 'payload'\n\nexport type Options = {\n  disableFormData?: boolean\n  hasRows?: boolean\n  /**\n   * If `path` is provided to this hook, it will be used outright. This is useful when calling this hook directly within a custom component.\n   * Otherwise, the field will attempt to get the path from the `FieldPathContext` via the `useFieldPath` hook.\n   * If still not found, the `potentiallyStalePath` arg will be used. See the note below about why this is important.\n   */\n  path?: string\n  /**\n   * Custom server components receive a static `path` prop at render-time, leading to temporarily stale paths when re-ordering rows in form state.\n   * This is because when manipulating rows, field paths change in form state, but the prop remains the same until the component is re-rendered on the server.\n   * This causes the component to temporarily point to the wrong field in form state until the server responds with a freshly rendered component.\n   * To prevent this, fields are wrapped with a `FieldPathContext` which is guaranteed to be up-to-date.\n   * The `path` prop that Payload's default fields receive, then, are sent into this hook as the `potentiallyStalePath` arg.\n   * This ensures that:\n   *   1. Custom components that use this hook directly will still respect the `path` prop as top priority.\n   *   2. Custom server components that blindly spread their props into default Payload fields still prefer the dynamic path from context.\n   *   3. Components that render default Payload fields directly do not require a `FieldPathProvider`, e.g. the email field in the account view.\n   */\n  potentiallyStalePath?: string\n  /**\n   * Client-side validation function fired when the form is submitted.\n   */\n  validate?: Validate\n}\n\nexport type FieldType<T> = {\n  disabled: boolean\n  formInitializing: boolean\n  formProcessing: boolean\n  formSubmitted: boolean\n  initialValue?: T\n  path: string\n  /**\n   * @deprecated - readOnly is no longer returned from useField. Remove this in 4.0.\n   */\n  readOnly?: boolean\n  setValue: (val: unknown, disableModifyingForm?: boolean) => void\n  showError: boolean\n  value: T\n} & Pick<\n  FieldState,\n  | 'blocksFilterOptions'\n  | 'customComponents'\n  | 'errorMessage'\n  | 'errorPaths'\n  | 'filterOptions'\n  | 'rows'\n  | 'selectFilterOptions'\n  | 'valid'\n>\n"],"mappings":"AA6BA","ignoreList":[]}
+{"version":3,"sources":["../../../src/forms/useField/types.ts"],"sourcesContent":["import type { FieldState, Validate } from 'payload'\n\nexport type Options = {\n  disableFormData?: boolean\n  hasRows?: boolean\n  /**\n   * If `path` is provided to this hook, it will be used outright. This is useful when calling this hook directly within a custom component.\n   * Otherwise, the field will attempt to get the path from the `FieldPathContext` via the `useFieldPath` hook.\n   * If still not found, the `potentiallyStalePath` arg will be used. See the note below about why this is important.\n   */\n  path?: string\n  /**\n   * Custom server components receive a static `path` prop at render-time, leading to temporarily stale paths when re-ordering rows in form state.\n   * This is because when manipulating rows, field paths change in form state, but the prop remains the same until the component is re-rendered on the server.\n   * This causes the component to temporarily point to the wrong field in form state until the server responds with a freshly rendered component.\n   * To prevent this, fields are wrapped with a `FieldPathContext` which is guaranteed to be up-to-date.\n   * The `path` prop that Payload's default fields receive, then, are sent into this hook as the `potentiallyStalePath` arg.\n   * This ensures that:\n   *   1. Custom components that use this hook directly will still respect the `path` prop as top priority.\n   *   2. Custom server components that blindly spread their props into default Payload fields still prefer the dynamic path from context.\n   *   3. Components that render default Payload fields directly do not require a `FieldPathProvider`, e.g. the email field in the account view.\n   */\n  potentiallyStalePath?: string\n  /**\n   * Client-side validation function fired when the form is submitted.\n   */\n  validate?: Validate\n}\n\nexport type FieldType<T> = {\n  disabled: boolean\n  formInitializing: boolean\n  formProcessing: boolean\n  formSubmitted: boolean\n  initialValue?: T\n  path: string\n  /**\n   * @deprecated - readOnly is no longer returned from useField. Remove this in 4.0.\n   */\n  readOnly?: boolean\n  setValue: (val: unknown, disableModifyingForm?: boolean) => void\n  showError: boolean\n  value: T\n} & Pick<\n  FieldState,\n  | 'blocksFilterOptions'\n  | 'customComponents'\n  | 'errorMessage'\n  | 'errorPaths'\n  | 'filterOptions'\n  | 'rows'\n  | 'selectFilterOptions'\n  | 'valid'\n>\n"],"names":[],"mappings":"AAKE;;;;GAIC,GAED;;;;;;;;;;GAUC,GAED;;GAEC,GAIH,WAwBC,CAjBC;;GAEC"}