@dnb/eufemia 10.62.3 → 10.63.0

package/extensions/forms/hooks/DataValueWritePropsDocs.js

@@ -15,18 +15,18 @@ export const DataValueWritePropsProperties = {
     status: 'optional'
   },
   info: {
-    doc: 'Info message shown below / after the field.',
-    type: ['React.Node', 'Array<React.Node>'],
+    doc: "Info message shown below / after the field. When provided as a function, the function will be called with the current value as argument. The second parameter is an object with `{ conditionally, getValueByPath, getFieldByPath }`. To show the message first after the user has interacted with the field, you can call and return `conditionally` function with a callback and with options: `conditionally(() => 'Your message', { showInitially: true })`",
+    type: ['React.Node', 'Array<React.Node>', 'function'],
     status: 'optional'
   },
   warning: {
-    doc: 'Warning message shown below / after the field.',
-    type: ['React.Node', 'Array<React.Node>'],
+    doc: "Warning message shown below / after the field. When provided as a function, the function will be called with the current value as argument. The second parameter is an object with `{ conditionally, getValueByPath, getFieldByPath }`. To show the message first after the user has interacted with the field, you can call and return `conditionally` function with a callback and with options: `conditionally(() => 'Your message', { showInitially: true })`",
+    type: ['React.Node', 'Array<React.Node>', 'function'],
     status: 'optional'
   },
   error: {
-    doc: 'Error message shown below / after the field.',
-    type: ['Error', 'FormError', 'Array<Error | FormError>'],
+    doc: "Error message shown below / after the field. When provided as a function, the function will be called with the current value as argument. The second parameter is an object with `{ conditionally, getValueByPath, getFieldByPath }`. To show the message first after the user has interacted with the field, you can call and return `conditionally` function with a callback and with options: `conditionally(() => 'Your message', { showInitially: true })`",
+    type: ['Error', 'FormError', 'Array<Error | FormError>', 'function'],
     status: 'optional'
   },
   disabled: {
@@ -64,7 +64,7 @@ export const DataValueWritePropsProperties = {
     type: 'boolean',
     status: 'optional'
   },
-  continuousValidation: {
+  validateContinuously: {
     doc: 'Set to `true` to show validation based errors continuously while writing, not just when blurring the field.',
     type: 'boolean',
     status: 'optional'
@@ -75,12 +75,12 @@ export const DataValueWritePropsProperties = {
     status: 'optional'
   },
   onChangeValidator: {
-    doc: 'Custom validator function that is triggered on every change done by the user. The function can be either asynchronous or synchronous. The first parameter is the value, and the second parameter returns an object containing { errorMessages, connectWithPath, validators }.',
+    doc: 'Custom validator function where you can return `undefined`, `Error`, `FormError` or an Array with either several other validators or several `Error` or `FormError`. It is triggered on every change done by the user. The function can be either asynchronous or synchronous. The first parameter is the value, and the second parameter returns an object containing { errorMessages, connectWithPath, validators }.',
     type: 'function',
     status: 'optional'
   },
   onBlurValidator: {
-    doc: 'Custom validator function that is triggered when the user leaves a field (e.g., blurring a text input or closing a dropdown). The function can be either asynchronous or synchronous. The first parameter is the value, and the second parameter returns an object containing { errorMessages, connectWithPath, validators }.',
+    doc: 'Custom validator function where you can return `undefined`, `Error`, `FormError` or an Array with either several other validators or several `Error` or `FormError`. It is triggered when the user leaves a field (e.g., blurring a text input or closing a dropdown). The function can be either asynchronous or synchronous. The first parameter is the value, and the second parameter returns an object containing { errorMessages, connectWithPath, validators }.',
     type: 'function',
     status: 'optional'
   },

package/extensions/forms/hooks/DataValueWritePropsDocs.js.map

@@ -1 +1 @@
-{"version":3,"file":"DataValueWritePropsDocs.js","names":["DataValueWritePropsProperties","value","doc","type","status","defaultValue","path","info","warning","error","disabled","emptyValue","required","labelSuffix","schema","validateInitially","validateUnchanged","continuousValidation","errorMessages","onChangeValidator","onBlurValidator","transformIn","transformOut","DataValueWritePropsEvents","onChange","onFocus","onBlur"],"sources":["../../../../../src/extensions/forms/hooks/DataValueWritePropsDocs.ts"],"sourcesContent":["import { PropertiesTableProps } from '../../../shared/types'\n\nexport const DataValueWritePropsProperties: PropertiesTableProps = {\n  value: {\n    doc: 'Source data value for the field. Will take precedence over the path value given in the data context.',\n    type: '{valueType}',\n    status: 'optional',\n  },\n  defaultValue: {\n    doc: 'Default source data value for the field. Will not take precedence over the path value given in the data context.',\n    type: '{valueType}',\n    status: 'optional',\n  },\n  path: {\n    doc: 'JSON Pointer for where the data for the field is located in the source dataset (when using Form.Handler or DataContext). The `path` will also be set as the `name` attribute for the [string](/uilib/extensions/forms/base-fields/String/)-field.',\n    type: 'string',\n    status: 'optional',\n  },\n  info: {\n    doc: 'Info message shown below / after the field.',\n    type: ['React.Node', 'Array<React.Node>'],\n    status: 'optional',\n  },\n  warning: {\n    doc: 'Warning message shown below / after the field.',\n    type: ['React.Node', 'Array<React.Node>'],\n    status: 'optional',\n  },\n  error: {\n    doc: 'Error message shown below / after the field.',\n    type: ['Error', 'FormError', 'Array<Error | FormError>'],\n    status: 'optional',\n  },\n  disabled: {\n    doc: 'Set `true` to show the field but without the possibility of changing the value.',\n    type: 'boolean',\n    status: 'optional',\n  },\n  emptyValue: {\n    doc: 'The value to use (in `onChange` events etc) when emptying the field. Makes it possible for instance to provide `undefined` instead of an empty string when clearing the content of a text input.',\n    type: ['{valueType}', 'undefined'],\n    status: 'optional',\n  },\n  required: {\n    doc: 'When set to `true`, the field will give an error if the value fails the required validation. When set to `false`, the field will not be required, but will add a \"(optional)\" suffix to the label.',\n    type: 'boolean',\n    status: 'optional',\n  },\n  labelSuffix: {\n    doc: 'Will append an additional text to the label, like \"(optional)\". When using `inheritLabel`, the suffix will not be inherited. NB: The visual appearance of the `labelSuffix` may change in the future.',\n    type: 'React.Node',\n    status: 'optional',\n  },\n  schema: {\n    doc: 'Custom JSON Schema for validating the value.',\n    type: 'object',\n    status: 'optional',\n  },\n  validateInitially: {\n    doc: 'Set to `true` to show validation based errors initially (from given value-prop or source data) before the user interacts with the field.',\n    type: 'boolean',\n    status: 'optional',\n  },\n  validateUnchanged: {\n    doc: 'Set to `true` to show validation based errors when the field is touched (like focusing a field and blurring) without having changed the value. Since the user did not introduce a new error, this will apply when the value was initially invalid based on validation.',\n    type: 'boolean',\n    status: 'optional',\n  },\n  continuousValidation: {\n    doc: 'Set to `true` to show validation based errors continuously while writing, not just when blurring the field.',\n    type: 'boolean',\n    status: 'optional',\n  },\n  errorMessages: {\n    doc: 'Custom error messages for each type of error, overriding default messages.',\n    type: 'object',\n    status: 'optional',\n  },\n  onChangeValidator: {\n    doc: 'Custom validator function that is triggered on every change done by the user. The function can be either asynchronous or synchronous. The first parameter is the value, and the second parameter returns an object containing { errorMessages, connectWithPath, validators }.',\n    type: 'function',\n    status: 'optional',\n  },\n  onBlurValidator: {\n    doc: 'Custom validator function that is triggered when the user leaves a field (e.g., blurring a text input or closing a dropdown). The function can be either asynchronous or synchronous. The first parameter is the value, and the second parameter returns an object containing { errorMessages, connectWithPath, validators }.',\n    type: 'function',\n    status: 'optional',\n  },\n  transformIn: {\n    doc: 'Transforms the `value` before its displayed in the field (e.g. input).',\n    type: 'function',\n    status: 'optional',\n  },\n  transformOut: {\n    doc: 'Transforms the value before it gets forwarded to the form data object (context) or returned as the `onChange` value parameter. The first parameter is the internal value. Some fields to support a second parameter, like the SelectCountry, where the country object is given.',\n    type: 'function',\n    status: 'optional',\n  },\n}\n\nexport const DataValueWritePropsEvents: PropertiesTableProps = {\n  onChange: {\n    doc: \"Will be called on value changes made by the user, with the new value as argument. When an `async` function is used, the corresponding [FieldBlock](/uilib/extensions/forms/create-component/FieldBlock/) will show an indicator on the field label. You can return `{ success: 'saved' } as const` to show a success symbol, or an error or an object with these keys `{ info: 'Info message', warning: 'Warning message', error: Error('My error') } as const`.\",\n    type: '(value) => void',\n    status: 'optional',\n  },\n  onFocus: {\n    doc: 'Will be called when the component gets into focus. Like clicking inside a text input or opening a dropdown. Called with active value as argument.',\n    type: '(value) => void',\n    status: 'optional',\n  },\n  onBlur: {\n    doc: 'Will be called when the component stop being in focus. Like when going to next field, or closing a dropdown. Called with active value as argument.',\n    type: '(value) => void',\n    status: 'optional',\n  },\n}\n"],"mappings":"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"}
+{"version":3,"file":"DataValueWritePropsDocs.js","names":["DataValueWritePropsProperties","value","doc","type","status","defaultValue","path","info","warning","error","disabled","emptyValue","required","labelSuffix","schema","validateInitially","validateUnchanged","validateContinuously","errorMessages","onChangeValidator","onBlurValidator","transformIn","transformOut","DataValueWritePropsEvents","onChange","onFocus","onBlur"],"sources":["../../../../../src/extensions/forms/hooks/DataValueWritePropsDocs.ts"],"sourcesContent":["import { PropertiesTableProps } from '../../../shared/types'\n\nexport const DataValueWritePropsProperties: PropertiesTableProps = {\n  value: {\n    doc: 'Source data value for the field. Will take precedence over the path value given in the data context.',\n    type: '{valueType}',\n    status: 'optional',\n  },\n  defaultValue: {\n    doc: 'Default source data value for the field. Will not take precedence over the path value given in the data context.',\n    type: '{valueType}',\n    status: 'optional',\n  },\n  path: {\n    doc: 'JSON Pointer for where the data for the field is located in the source dataset (when using Form.Handler or DataContext). The `path` will also be set as the `name` attribute for the [string](/uilib/extensions/forms/base-fields/String/)-field.',\n    type: 'string',\n    status: 'optional',\n  },\n  info: {\n    doc: \"Info message shown below / after the field. When provided as a function, the function will be called with the current value as argument. The second parameter is an object with `{ conditionally, getValueByPath, getFieldByPath }`. To show the message first after the user has interacted with the field, you can call and return `conditionally` function with a callback and with options: `conditionally(() => 'Your message', { showInitially: true })`\",\n    type: ['React.Node', 'Array<React.Node>', 'function'],\n    status: 'optional',\n  },\n  warning: {\n    doc: \"Warning message shown below / after the field. When provided as a function, the function will be called with the current value as argument. The second parameter is an object with `{ conditionally, getValueByPath, getFieldByPath }`. To show the message first after the user has interacted with the field, you can call and return `conditionally` function with a callback and with options: `conditionally(() => 'Your message', { showInitially: true })`\",\n    type: ['React.Node', 'Array<React.Node>', 'function'],\n    status: 'optional',\n  },\n  error: {\n    doc: \"Error message shown below / after the field. When provided as a function, the function will be called with the current value as argument. The second parameter is an object with `{ conditionally, getValueByPath, getFieldByPath }`. To show the message first after the user has interacted with the field, you can call and return `conditionally` function with a callback and with options: `conditionally(() => 'Your message', { showInitially: true })`\",\n    type: ['Error', 'FormError', 'Array<Error | FormError>', 'function'],\n    status: 'optional',\n  },\n  disabled: {\n    doc: 'Set `true` to show the field but without the possibility of changing the value.',\n    type: 'boolean',\n    status: 'optional',\n  },\n  emptyValue: {\n    doc: 'The value to use (in `onChange` events etc) when emptying the field. Makes it possible for instance to provide `undefined` instead of an empty string when clearing the content of a text input.',\n    type: ['{valueType}', 'undefined'],\n    status: 'optional',\n  },\n  required: {\n    doc: 'When set to `true`, the field will give an error if the value fails the required validation. When set to `false`, the field will not be required, but will add a \"(optional)\" suffix to the label.',\n    type: 'boolean',\n    status: 'optional',\n  },\n  labelSuffix: {\n    doc: 'Will append an additional text to the label, like \"(optional)\". When using `inheritLabel`, the suffix will not be inherited. NB: The visual appearance of the `labelSuffix` may change in the future.',\n    type: 'React.Node',\n    status: 'optional',\n  },\n  schema: {\n    doc: 'Custom JSON Schema for validating the value.',\n    type: 'object',\n    status: 'optional',\n  },\n  validateInitially: {\n    doc: 'Set to `true` to show validation based errors initially (from given value-prop or source data) before the user interacts with the field.',\n    type: 'boolean',\n    status: 'optional',\n  },\n  validateUnchanged: {\n    doc: 'Set to `true` to show validation based errors when the field is touched (like focusing a field and blurring) without having changed the value. Since the user did not introduce a new error, this will apply when the value was initially invalid based on validation.',\n    type: 'boolean',\n    status: 'optional',\n  },\n  validateContinuously: {\n    doc: 'Set to `true` to show validation based errors continuously while writing, not just when blurring the field.',\n    type: 'boolean',\n    status: 'optional',\n  },\n  errorMessages: {\n    doc: 'Custom error messages for each type of error, overriding default messages.',\n    type: 'object',\n    status: 'optional',\n  },\n  onChangeValidator: {\n    doc: 'Custom validator function where you can return `undefined`, `Error`, `FormError` or an Array with either several other validators or several `Error` or `FormError`. It is triggered on every change done by the user. The function can be either asynchronous or synchronous. The first parameter is the value, and the second parameter returns an object containing { errorMessages, connectWithPath, validators }.',\n    type: 'function',\n    status: 'optional',\n  },\n  onBlurValidator: {\n    doc: 'Custom validator function where you can return `undefined`, `Error`, `FormError` or an Array with either several other validators or several `Error` or `FormError`. It is triggered when the user leaves a field (e.g., blurring a text input or closing a dropdown). The function can be either asynchronous or synchronous. The first parameter is the value, and the second parameter returns an object containing { errorMessages, connectWithPath, validators }.',\n    type: 'function',\n    status: 'optional',\n  },\n  transformIn: {\n    doc: 'Transforms the `value` before its displayed in the field (e.g. input).',\n    type: 'function',\n    status: 'optional',\n  },\n  transformOut: {\n    doc: 'Transforms the value before it gets forwarded to the form data object (context) or returned as the `onChange` value parameter. The first parameter is the internal value. Some fields to support a second parameter, like the SelectCountry, where the country object is given.',\n    type: 'function',\n    status: 'optional',\n  },\n}\n\nexport const DataValueWritePropsEvents: PropertiesTableProps = {\n  onChange: {\n    doc: \"Will be called on value changes made by the user, with the new value as argument. When an `async` function is used, the corresponding [FieldBlock](/uilib/extensions/forms/create-component/FieldBlock/) will show an indicator on the field label. You can return `{ success: 'saved' } as const` to show a success symbol, or an error or an object with these keys `{ info: 'Info message', warning: 'Warning message', error: Error('My error') } as const`.\",\n    type: '(value) => void',\n    status: 'optional',\n  },\n  onFocus: {\n    doc: 'Will be called when the component gets into focus. Like clicking inside a text input or opening a dropdown. Called with active value as argument.',\n    type: '(value) => void',\n    status: 'optional',\n  },\n  onBlur: {\n    doc: 'Will be called when the component stop being in focus. Like when going to next field, or closing a dropdown. Called with active value as argument.',\n    type: '(value) => void',\n    status: 'optional',\n  },\n}\n"],"mappings":"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"}

package/extensions/forms/hooks/useDataValue.d.ts

@@ -4,11 +4,11 @@ export type Props<Value> = {
     value?: Value;
 };
 export type GetValueByPath<Value = unknown> = <T = Value>(path: Path) => T;
-export default function useDataValue<Value>({ path: pathProp, value, }?: Props<Value>): {
+export default function useDataValue<Value>(pathProp?: Path | undefined, value?: Value): {
     getSourceValue: (source: Path | Value) => any;
     getValueByPath: (path: Path) => any;
     getValueByIteratePath: (path: Path) => any;
-    moveValueToPath: <T>(path: Path, value: T) => T;
+    moveValueToPath: <T>(path: Path, value: T, object?: {}) => T;
     getData: (path: Path, options?: {
         includeCurrentPath?: boolean;
     }) => any;

package/extensions/forms/hooks/useDataValue.js

@@ -5,11 +5,7 @@ import pointer from '../utils/json-pointer';
 import DataContext from '../DataContext/Context';
 import IterateItemContext from '../Iterate/IterateItemContext';
 import usePath from './usePath';
-export default function useDataValue() {
-  let {
-    path: pathProp,
-    value
-  } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+export default function useDataValue(pathProp, value) {
   const dataContextRef = useRef();
   dataContextRef.current = useContext(DataContext);
   const iterateItemContext = useContext(IterateItemContext);
@@ -35,11 +31,11 @@ export default function useDataValue() {
       return get(makeIteratePath(path));
     }
   }, [get, makeIteratePath]);
-  const moveValueToPath = useCallback((path, value) => {
+  const moveValueToPath = useCallback(function (path, value) {
+    let object = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
     if (path !== '/' && isPath(path)) {
-      const obj = {};
-      pointer.set(obj, path, value);
-      return obj;
+      pointer.set(object, path, value);
+      return object;
     }
     return value;
   }, []);

package/extensions/forms/hooks/useDataValue.js.map

@@ -1 +1 @@
-{"version":3,"file":"useDataValue.js","names":["useCallback","useContext","useRef","pointer","DataContext","IterateItemContext","usePath","useDataValue","path","pathProp","value","arguments","length","undefined","dataContextRef","current","iterateItemContext","makePath","makeIteratePath","get","selector","_dataContextRef$curre","_dataContextRef$curre2","data","internalDataRef","has","getValueByPath","isPath","getValueByIteratePath","moveValueToPath","obj","set","getData","options","includeCurrentPath","getSourceValue","source","startsWith"],"sources":["../../../../../src/extensions/forms/hooks/useDataValue.ts"],"sourcesContent":["import { useCallback, useContext, useRef } from 'react'\nimport pointer from '../utils/json-pointer'\nimport { Path } from '../types'\nimport DataContext, { ContextState } from '../DataContext/Context'\nimport IterateItemContext from '../Iterate/IterateItemContext'\nimport usePath from './usePath'\n\nexport type Props<Value> = {\n  path?: Path | undefined\n  value?: Value\n}\n\nexport type GetValueByPath<Value = unknown> = <T = Value>(path: Path) => T\n\nexport default function useDataValue<Value>({\n  path: pathProp,\n  value,\n}: Props<Value> = {}) {\n  const dataContextRef = useRef<ContextState>()\n  dataContextRef.current = useContext(DataContext)\n  const iterateItemContext = useContext(IterateItemContext)\n\n  const { makePath, makeIteratePath } = usePath()\n\n  const get = useCallback((selector: Path) => {\n    const data = dataContextRef.current?.internalDataRef?.current\n    if (selector === '/') {\n      return data\n    }\n    return pointer.has(data, selector)\n      ? pointer.get(data, selector)\n      : undefined\n  }, [])\n\n  const getValueByPath = useCallback(\n    (path: Path) => {\n      if (isPath(path)) {\n        return get(makePath(path))\n      }\n    },\n    [get, makePath]\n  )\n\n  const getValueByIteratePath = useCallback(\n    (path: Path) => {\n      if (isPath(path)) {\n        return get(makeIteratePath(path))\n      }\n    },\n    [get, makeIteratePath]\n  )\n\n  const moveValueToPath = useCallback(<T>(path: Path, value: T): T => {\n    if (path !== '/' && isPath(path)) {\n      const obj = {}\n      pointer.set(obj, path, value)\n      return obj as T\n    }\n\n    return value\n  }, [])\n\n  const getData = useCallback(\n    (path: Path, options?: { includeCurrentPath?: boolean }) => {\n      if (isPath(path)) {\n        const value = getValueByPath(path)\n\n        if (options?.includeCurrentPath && path !== '/') {\n          return moveValueToPath(path, value)\n        }\n\n        return value\n      }\n    },\n    [getValueByPath, moveValueToPath]\n  )\n\n  const getSourceValue = useCallback(\n    (source: Path | Value) => {\n      if (typeof source === 'string' && isPath(source)) {\n        if (iterateItemContext) {\n          return getValueByIteratePath(source)\n        }\n\n        return getValueByPath(source)\n      }\n\n      return source\n    },\n    [getValueByIteratePath, getValueByPath, iterateItemContext]\n  )\n\n  if (pathProp) {\n    value = getSourceValue(pathProp)\n  }\n\n  return {\n    getSourceValue,\n    getValueByPath,\n    getValueByIteratePath,\n    moveValueToPath,\n    getData,\n    value,\n  }\n}\n\nfunction isPath(path: Path | unknown) {\n  return typeof path === 'string' && path.startsWith('/')\n}\n"],"mappings":"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"}
+{"version":3,"file":"useDataValue.js","names":["useCallback","useContext","useRef","pointer","DataContext","IterateItemContext","usePath","useDataValue","pathProp","value","dataContextRef","current","iterateItemContext","makePath","makeIteratePath","get","selector","_dataContextRef$curre","_dataContextRef$curre2","data","internalDataRef","has","undefined","getValueByPath","path","isPath","getValueByIteratePath","moveValueToPath","object","arguments","length","set","getData","options","includeCurrentPath","getSourceValue","source","startsWith"],"sources":["../../../../../src/extensions/forms/hooks/useDataValue.ts"],"sourcesContent":["import { useCallback, useContext, useRef } from 'react'\nimport pointer from '../utils/json-pointer'\nimport { Path } from '../types'\nimport DataContext, { ContextState } from '../DataContext/Context'\nimport IterateItemContext from '../Iterate/IterateItemContext'\nimport usePath from './usePath'\n\nexport type Props<Value> = {\n  path?: Path | undefined\n  value?: Value\n}\n\nexport type GetValueByPath<Value = unknown> = <T = Value>(path: Path) => T\n\nexport default function useDataValue<Value>(\n  pathProp?: Path | undefined,\n  value?: Value\n) {\n  const dataContextRef = useRef<ContextState>()\n  dataContextRef.current = useContext(DataContext)\n  const iterateItemContext = useContext(IterateItemContext)\n\n  const { makePath, makeIteratePath } = usePath()\n\n  const get = useCallback((selector: Path) => {\n    const data = dataContextRef.current?.internalDataRef?.current\n    if (selector === '/') {\n      return data\n    }\n    return pointer.has(data, selector)\n      ? pointer.get(data, selector)\n      : undefined\n  }, [])\n\n  const getValueByPath = useCallback(\n    (path: Path) => {\n      if (isPath(path)) {\n        return get(makePath(path))\n      }\n    },\n    [get, makePath]\n  )\n\n  const getValueByIteratePath = useCallback(\n    (path: Path) => {\n      if (isPath(path)) {\n        return get(makeIteratePath(path))\n      }\n    },\n    [get, makeIteratePath]\n  )\n\n  const moveValueToPath = useCallback(\n    <T>(path: Path, value: T, object = {}): T => {\n      if (path !== '/' && isPath(path)) {\n        pointer.set(object, path, value)\n        return object as T\n      }\n\n      return value\n    },\n    []\n  )\n\n  const getData = useCallback(\n    (path: Path, options?: { includeCurrentPath?: boolean }) => {\n      if (isPath(path)) {\n        const value = getValueByPath(path)\n\n        if (options?.includeCurrentPath && path !== '/') {\n          return moveValueToPath(path, value)\n        }\n\n        return value\n      }\n    },\n    [getValueByPath, moveValueToPath]\n  )\n\n  const getSourceValue = useCallback(\n    (source: Path | Value) => {\n      if (typeof source === 'string' && isPath(source)) {\n        if (iterateItemContext) {\n          return getValueByIteratePath(source)\n        }\n\n        return getValueByPath(source)\n      }\n\n      return source\n    },\n    [getValueByIteratePath, getValueByPath, iterateItemContext]\n  )\n\n  if (pathProp) {\n    value = getSourceValue(pathProp)\n  }\n\n  return {\n    getSourceValue,\n    getValueByPath,\n    getValueByIteratePath,\n    moveValueToPath,\n    getData,\n    value,\n  }\n}\n\nfunction isPath(path: Path | unknown) {\n  return typeof path === 'string' && path.startsWith('/')\n}\n"],"mappings":"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"}

package/extensions/forms/hooks/useExternalValue.js

@@ -3,7 +3,7 @@
 import { useContext, useMemo } from 'react';
 import pointer from '../utils/json-pointer';
 import DataContext from '../DataContext/Context';
-import IterateElementContext from '../Iterate/IterateItemContext';
+import IterateItemContext from '../Iterate/IterateItemContext';
 export default function useExternalValue(props) {
   const {
     path,
@@ -15,7 +15,7 @@ export default function useExternalValue(props) {
   const {
     data
   } = useContext(DataContext) || {};
-  const iterateItemContext = useContext(IterateElementContext);
+  const iterateItemContext = useContext(IterateItemContext);
   const inIterate = Boolean(iterateItemContext);
   const {
     value: iterateElementValue

package/extensions/forms/hooks/useExternalValue.js.map

@@ -1 +1 @@
-{"version":3,"file":"useExternalValue.js","names":["useContext","useMemo","pointer","DataContext","IterateElementContext","useExternalValue","props","path","itemPath","value","transformers","emptyValue","undefined","data","iterateItemContext","inIterate","Boolean","iterateElementValue","_transformers$current","_transformers$current2","_transformers$current3","current","fromExternal","call","_transformers$current4","_transformers$current5","_transformers$current6","has","_transformers$current7","_transformers$current8","_transformers$current9","get","_transformers$current10","_transformers$current11","_transformers$current12","_transformers$current13","_transformers$current14","_transformers$current15"],"sources":["../../../../../src/extensions/forms/hooks/useExternalValue.ts"],"sourcesContent":["import { useContext, useMemo } from 'react'\nimport pointer from '../utils/json-pointer'\nimport { FieldProps, Path } from '../types'\nimport DataContext from '../DataContext/Context'\nimport IterateElementContext from '../Iterate/IterateItemContext'\n\nexport type Props<Value> = {\n  path?: Path | undefined\n  itemPath?: Path\n  value?: Value\n  transformers?: React.MutableRefObject<{\n    fromExternal: FieldProps<Value>['fromExternal']\n  }>\n  emptyValue?: FieldProps<Value>['emptyValue']\n}\n\nexport default function useExternalValue<Value>(props: Props<Value>) {\n  const {\n    path,\n    itemPath,\n    value,\n    transformers,\n    emptyValue = undefined,\n  } = props\n  const { data } = useContext(DataContext) || {}\n  const iterateItemContext = useContext(IterateElementContext)\n  const inIterate = Boolean(iterateItemContext)\n  const { value: iterateElementValue } = iterateItemContext || {}\n\n  return useMemo(() => {\n    if (value !== emptyValue) {\n      // Value-prop sent directly to the field has highest priority, overriding any surrounding source\n      return transformers?.current?.fromExternal?.(value) ?? emptyValue\n    }\n\n    if (inIterate && itemPath) {\n      // This field is inside an iterate, and has a pointer from the base of the element being iterated\n      if (itemPath === '/') {\n        return (\n          transformers?.current?.fromExternal?.(\n            iterateElementValue as Value\n          ) ?? emptyValue\n        )\n      }\n\n      if (pointer.has(iterateElementValue, itemPath)) {\n        return (\n          transformers?.current?.fromExternal?.(\n            pointer.get(iterateElementValue, itemPath) as Value\n          ) ?? emptyValue\n        )\n      }\n    }\n\n    if (data && path) {\n      // There is a surrounding data context and a path for where in the source to find the data\n      if (path === '/') {\n        return transformers?.current?.fromExternal?.(data) ?? emptyValue\n      }\n\n      if (pointer.has(data, path)) {\n        return (\n          transformers?.current?.fromExternal?.(pointer.get(data, path)) ??\n          emptyValue\n        )\n      }\n    }\n\n    return emptyValue\n  }, [\n    data,\n    emptyValue,\n    inIterate,\n    itemPath,\n    iterateElementValue,\n    path,\n    transformers,\n    value,\n  ])\n}\n"],"mappings":"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"}
+{"version":3,"file":"useExternalValue.js","names":["useContext","useMemo","pointer","DataContext","IterateItemContext","useExternalValue","props","path","itemPath","value","transformers","emptyValue","undefined","data","iterateItemContext","inIterate","Boolean","iterateElementValue","_transformers$current","_transformers$current2","_transformers$current3","current","fromExternal","call","_transformers$current4","_transformers$current5","_transformers$current6","has","_transformers$current7","_transformers$current8","_transformers$current9","get","_transformers$current10","_transformers$current11","_transformers$current12","_transformers$current13","_transformers$current14","_transformers$current15"],"sources":["../../../../../src/extensions/forms/hooks/useExternalValue.ts"],"sourcesContent":["import { useContext, useMemo } from 'react'\nimport pointer from '../utils/json-pointer'\nimport { FieldProps, Path } from '../types'\nimport DataContext from '../DataContext/Context'\nimport IterateItemContext from '../Iterate/IterateItemContext'\n\nexport type Props<Value> = {\n  path?: Path | undefined\n  itemPath?: Path\n  value?: Value\n  transformers?: React.MutableRefObject<{\n    fromExternal: FieldProps<Value>['fromExternal']\n  }>\n  emptyValue?: FieldProps<Value>['emptyValue']\n}\n\nexport default function useExternalValue<Value>(props: Props<Value>) {\n  const {\n    path,\n    itemPath,\n    value,\n    transformers,\n    emptyValue = undefined,\n  } = props\n  const { data } = useContext(DataContext) || {}\n  const iterateItemContext = useContext(IterateItemContext)\n  const inIterate = Boolean(iterateItemContext)\n  const { value: iterateElementValue } = iterateItemContext || {}\n\n  return useMemo(() => {\n    if (value !== emptyValue) {\n      // Value-prop sent directly to the field has highest priority, overriding any surrounding source\n      return transformers?.current?.fromExternal?.(value) ?? emptyValue\n    }\n\n    if (inIterate && itemPath) {\n      // This field is inside an iterate, and has a pointer from the base of the element being iterated\n      if (itemPath === '/') {\n        return (\n          transformers?.current?.fromExternal?.(\n            iterateElementValue as Value\n          ) ?? emptyValue\n        )\n      }\n\n      if (pointer.has(iterateElementValue, itemPath)) {\n        return (\n          transformers?.current?.fromExternal?.(\n            pointer.get(iterateElementValue, itemPath) as Value\n          ) ?? emptyValue\n        )\n      }\n    }\n\n    if (data && path) {\n      // There is a surrounding data context and a path for where in the source to find the data\n      if (path === '/') {\n        return transformers?.current?.fromExternal?.(data) ?? emptyValue\n      }\n\n      if (pointer.has(data, path)) {\n        return (\n          transformers?.current?.fromExternal?.(pointer.get(data, path)) ??\n          emptyValue\n        )\n      }\n    }\n\n    return emptyValue\n  }, [\n    data,\n    emptyValue,\n    inIterate,\n    itemPath,\n    iterateElementValue,\n    path,\n    transformers,\n    value,\n  ])\n}\n"],"mappings":"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"}

package/extensions/forms/hooks/useFieldProps.d.ts

@@ -4,11 +4,17 @@ import { ContextState } from '../DataContext';
 export type DataAttributes = {
     [property: `data-${string}`]: string | boolean | number;
 };
-export default function useFieldProps<Value, EmptyValue, Props>(localProps: Props & FieldPropsGeneric<Value, EmptyValue>, { executeOnChangeRegardlessOfError, updateContextDataInSync, omitMultiplePathWarning, forceUpdateWhenContextDataIsSet, }?: {
+export default function useFieldProps<Value, EmptyValue, Props>(localProps: Props & FieldPropsGeneric<Value, EmptyValue>, { executeOnChangeRegardlessOfError, updateContextDataInSync, omitMultiplePathWarning, forceUpdateWhenContextDataIsSet, 
+/**
+ * When set to true, errors will always be reported downwards to FieldBlock.
+ * This is useful for when not dealing with blur/focus, like in Iterate.Array.
+ */
+alwaysRevealError, }?: {
     executeOnChangeRegardlessOfError?: boolean;
     updateContextDataInSync?: boolean;
     omitMultiplePathWarning?: boolean;
     forceUpdateWhenContextDataIsSet?: boolean;
+    alwaysRevealError?: boolean;
 }): typeof localProps & ReturnAdditional<Value>;
 export interface ReturnAdditional<Value> {
     /** Documented APIs */
@@ -21,7 +27,7 @@ export interface ReturnAdditional<Value> {
     handleChange: (value: Value | unknown, additionalArgs?: AdditionalEventArgs) => void;
     updateValue: (value: Value) => void;
     setChanged: (state: boolean) => void;
-    setDisplayValue: (path: Identifier, value: React.ReactNode) => void;
+    setDisplayValue: (value: React.ReactNode, path?: Identifier) => void;
     forceUpdate: () => void;
     hasError?: boolean;
     /** Internal */