@dnb/eufemia 10.43.0 → 10.44.0

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

@@ -1 +1 @@
-{"version":3,"file":"DataValueDocs.js","names":["dataValueProperties","value","doc","type","status","defaultValue","path","info","warning","error","disabled","emptyValue","required","schema","validateInitially","validateUnchanged","continuousValidation","errorMessages","validator","onBlurValidator","transformIn","transformOut","dataValueEvents","onChange","onFocus","onBlur"],"sources":["../../../../../src/extensions/forms/hooks/DataValueDocs.ts"],"sourcesContent":["import { PropertiesTableProps } from '../../../shared/types'\n\nexport const dataValueProperties: 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',\n    status: 'optional',\n  },\n  warning: {\n    doc: 'Warning message shown below / after the field.',\n    type: 'React.Node',\n    status: 'optional',\n  },\n  error: {\n    doc: 'Error message shown below / after the field.',\n    type: 'Error',\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 `true`, the field will give an error if the value cannot be empty.',\n    type: 'boolean',\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 `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 `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 `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  validator: {\n    doc: 'Custom validator function that will be called for every change done by the user. Can be asynchronous or synchronous.',\n    type: 'function',\n    status: 'optional',\n  },\n  onBlurValidator: {\n    doc: 'Custom validator function that will be called when the user leaves the field (blurring a text input, closing a dropdown etc). Can be asynchronous or synchronous.',\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 or returned as the `onChange` value parameter.',\n    type: 'function',\n    status: 'optional',\n  },\n}\n\nexport const dataValueEvents: 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: 'function',\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: 'function',\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: 'function',\n    status: 'optional',\n  },\n}\n"],"mappings":"AAEA,OAAO,MAAMA,mBAAyC,GAAG;EACvDC,KAAK,EAAE;IACLC,GAAG,EAAE,sGAAsG;IAC3GC,IAAI,EAAE,aAAa;IACnBC,MAAM,EAAE;EACV,CAAC;EACDC,YAAY,EAAE;IACZH,GAAG,EAAE,kHAAkH;IACvHC,IAAI,EAAE,aAAa;IACnBC,MAAM,EAAE;EACV,CAAC;EACDE,IAAI,EAAE;IACJJ,GAAG,EAAE,mPAAmP;IACxPC,IAAI,EAAE,QAAQ;IACdC,MAAM,EAAE;EACV,CAAC;EACDG,IAAI,EAAE;IACJL,GAAG,EAAE,6CAA6C;IAClDC,IAAI,EAAE,YAAY;IAClBC,MAAM,EAAE;EACV,CAAC;EACDI,OAAO,EAAE;IACPN,GAAG,EAAE,gDAAgD;IACrDC,IAAI,EAAE,YAAY;IAClBC,MAAM,EAAE;EACV,CAAC;EACDK,KAAK,EAAE;IACLP,GAAG,EAAE,8CAA8C;IACnDC,IAAI,EAAE,OAAO;IACbC,MAAM,EAAE;EACV,CAAC;EACDM,QAAQ,EAAE;IACRR,GAAG,EAAE,iFAAiF;IACtFC,IAAI,EAAE,SAAS;IACfC,MAAM,EAAE;EACV,CAAC;EACDO,UAAU,EAAE;IACVT,GAAG,EAAE,kMAAkM;IACvMC,IAAI,EAAE,CAAC,aAAa,EAAE,WAAW,CAAC;IAClCC,MAAM,EAAE;EACV,CAAC;EACDQ,QAAQ,EAAE;IACRV,GAAG,EAAE,6EAA6E;IAClFC,IAAI,EAAE,SAAS;IACfC,MAAM,EAAE;EACV,CAAC;EACDS,MAAM,EAAE;IACNX,GAAG,EAAE,8CAA8C;IACnDC,IAAI,EAAE,QAAQ;IACdC,MAAM,EAAE;EACV,CAAC;EACDU,iBAAiB,EAAE;IACjBZ,GAAG,EAAE,uIAAuI;IAC5IC,IAAI,EAAE,SAAS;IACfC,MAAM,EAAE;EACV,CAAC;EACDW,iBAAiB,EAAE;IACjBb,GAAG,EAAE,qQAAqQ;IAC1QC,IAAI,EAAE,SAAS;IACfC,MAAM,EAAE;EACV,CAAC;EACDY,oBAAoB,EAAE;IACpBd,GAAG,EAAE,0GAA0G;IAC/GC,IAAI,EAAE,SAAS;IACfC,MAAM,EAAE;EACV,CAAC;EACDa,aAAa,EAAE;IACbf,GAAG,EAAE,4EAA4E;IACjFC,IAAI,EAAE,QAAQ;IACdC,MAAM,EAAE;EACV,CAAC;EACDc,SAAS,EAAE;IACThB,GAAG,EAAE,sHAAsH;IAC3HC,IAAI,EAAE,UAAU;IAChBC,MAAM,EAAE;EACV,CAAC;EACDe,eAAe,EAAE;IACfjB,GAAG,EAAE,mKAAmK;IACxKC,IAAI,EAAE,UAAU;IAChBC,MAAM,EAAE;EACV,CAAC;EACDgB,WAAW,EAAE;IACXlB,GAAG,EAAE,wEAAwE;IAC7EC,IAAI,EAAE,UAAU;IAChBC,MAAM,EAAE;EACV,CAAC;EACDiB,YAAY,EAAE;IACZnB,GAAG,EAAE,sHAAsH;IAC3HC,IAAI,EAAE,UAAU;IAChBC,MAAM,EAAE;EACV;AACF,CAAC;AAED,OAAO,MAAMkB,eAAqC,GAAG;EACnDC,QAAQ,EAAE;IACRrB,GAAG,EAAE,kcAAkc;IACvcC,IAAI,EAAE,UAAU;IAChBC,MAAM,EAAE;EACV,CAAC;EACDoB,OAAO,EAAE;IACPtB,GAAG,EAAE,mJAAmJ;IACxJC,IAAI,EAAE,UAAU;IAChBC,MAAM,EAAE;EACV,CAAC;EACDqB,MAAM,EAAE;IACNvB,GAAG,EAAE,oJAAoJ;IACzJC,IAAI,EAAE,UAAU;IAChBC,MAAM,EAAE;EACV;AACF,CAAC"}
+{"version":3,"file":"DataValueDocs.js","names":["dataValueProperties","value","doc","type","status","defaultValue","path","info","warning","error","disabled","emptyValue","required","schema","validateInitially","validateUnchanged","continuousValidation","errorMessages","validator","onBlurValidator","transformIn","transformOut","dataValueEvents","onChange","onFocus","onBlur"],"sources":["../../../../../src/extensions/forms/hooks/DataValueDocs.ts"],"sourcesContent":["import { PropertiesTableProps } from '../../../shared/types'\n\nexport const dataValueProperties: 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',\n    status: 'optional',\n  },\n  warning: {\n    doc: 'Warning message shown below / after the field.',\n    type: 'React.Node',\n    status: 'optional',\n  },\n  error: {\n    doc: 'Error message shown below / after the field.',\n    type: 'Error',\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 `true`, the field will give an error if the value cannot be empty.',\n    type: 'boolean',\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 `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 `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 `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  validator: {\n    doc: 'Custom validator function that will be called for every change done by the user. Can be asynchronous or synchronous.',\n    type: 'function',\n    status: 'optional',\n  },\n  onBlurValidator: {\n    doc: 'Custom validator function that will be called when the user leaves the field (blurring a text input, closing a dropdown etc). Can be asynchronous or synchronous.',\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 or returned as the `onChange` value parameter.',\n    type: 'function',\n    status: 'optional',\n  },\n}\n\nexport const dataValueEvents: 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":"AAEA,OAAO,MAAMA,mBAAyC,GAAG;EACvDC,KAAK,EAAE;IACLC,GAAG,EAAE,sGAAsG;IAC3GC,IAAI,EAAE,aAAa;IACnBC,MAAM,EAAE;EACV,CAAC;EACDC,YAAY,EAAE;IACZH,GAAG,EAAE,kHAAkH;IACvHC,IAAI,EAAE,aAAa;IACnBC,MAAM,EAAE;EACV,CAAC;EACDE,IAAI,EAAE;IACJJ,GAAG,EAAE,mPAAmP;IACxPC,IAAI,EAAE,QAAQ;IACdC,MAAM,EAAE;EACV,CAAC;EACDG,IAAI,EAAE;IACJL,GAAG,EAAE,6CAA6C;IAClDC,IAAI,EAAE,YAAY;IAClBC,MAAM,EAAE;EACV,CAAC;EACDI,OAAO,EAAE;IACPN,GAAG,EAAE,gDAAgD;IACrDC,IAAI,EAAE,YAAY;IAClBC,MAAM,EAAE;EACV,CAAC;EACDK,KAAK,EAAE;IACLP,GAAG,EAAE,8CAA8C;IACnDC,IAAI,EAAE,OAAO;IACbC,MAAM,EAAE;EACV,CAAC;EACDM,QAAQ,EAAE;IACRR,GAAG,EAAE,iFAAiF;IACtFC,IAAI,EAAE,SAAS;IACfC,MAAM,EAAE;EACV,CAAC;EACDO,UAAU,EAAE;IACVT,GAAG,EAAE,kMAAkM;IACvMC,IAAI,EAAE,CAAC,aAAa,EAAE,WAAW,CAAC;IAClCC,MAAM,EAAE;EACV,CAAC;EACDQ,QAAQ,EAAE;IACRV,GAAG,EAAE,6EAA6E;IAClFC,IAAI,EAAE,SAAS;IACfC,MAAM,EAAE;EACV,CAAC;EACDS,MAAM,EAAE;IACNX,GAAG,EAAE,8CAA8C;IACnDC,IAAI,EAAE,QAAQ;IACdC,MAAM,EAAE;EACV,CAAC;EACDU,iBAAiB,EAAE;IACjBZ,GAAG,EAAE,uIAAuI;IAC5IC,IAAI,EAAE,SAAS;IACfC,MAAM,EAAE;EACV,CAAC;EACDW,iBAAiB,EAAE;IACjBb,GAAG,EAAE,qQAAqQ;IAC1QC,IAAI,EAAE,SAAS;IACfC,MAAM,EAAE;EACV,CAAC;EACDY,oBAAoB,EAAE;IACpBd,GAAG,EAAE,0GAA0G;IAC/GC,IAAI,EAAE,SAAS;IACfC,MAAM,EAAE;EACV,CAAC;EACDa,aAAa,EAAE;IACbf,GAAG,EAAE,4EAA4E;IACjFC,IAAI,EAAE,QAAQ;IACdC,MAAM,EAAE;EACV,CAAC;EACDc,SAAS,EAAE;IACThB,GAAG,EAAE,sHAAsH;IAC3HC,IAAI,EAAE,UAAU;IAChBC,MAAM,EAAE;EACV,CAAC;EACDe,eAAe,EAAE;IACfjB,GAAG,EAAE,mKAAmK;IACxKC,IAAI,EAAE,UAAU;IAChBC,MAAM,EAAE;EACV,CAAC;EACDgB,WAAW,EAAE;IACXlB,GAAG,EAAE,wEAAwE;IAC7EC,IAAI,EAAE,UAAU;IAChBC,MAAM,EAAE;EACV,CAAC;EACDiB,YAAY,EAAE;IACZnB,GAAG,EAAE,sHAAsH;IAC3HC,IAAI,EAAE,UAAU;IAChBC,MAAM,EAAE;EACV;AACF,CAAC;AAED,OAAO,MAAMkB,eAAqC,GAAG;EACnDC,QAAQ,EAAE;IACRrB,GAAG,EAAE,kcAAkc;IACvcC,IAAI,EAAE,iBAAiB;IACvBC,MAAM,EAAE;EACV,CAAC;EACDoB,OAAO,EAAE;IACPtB,GAAG,EAAE,mJAAmJ;IACxJC,IAAI,EAAE,iBAAiB;IACvBC,MAAM,EAAE;EACV,CAAC;EACDqB,MAAM,EAAE;IACNvB,GAAG,EAAE,oJAAoJ;IACzJC,IAAI,EAAE,iBAAiB;IACvBC,MAAM,EAAE;EACV;AACF,CAAC"}

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

@@ -6,6 +6,7 @@ export type Props<Value> = {
 export default function useDataValue<Value>({ path: pathProp, value, }?: Props<Value>): {
     getValue: (source: Path | Value) => any;
     getValueByPath: (path: Path) => any;
+    getValueByIteratePath: (path: Path) => any;
     getData: (path: Path, options?: {
         includeCurrentPath?: boolean;
     }) => any;

package/extensions/forms/hooks/useDataValue.js

@@ -12,19 +12,27 @@ export default function useDataValue() {
   const dataContextRef = useRef();
   dataContextRef.current = useContext(DataContext);
   const {
-    makePath
+    makePath,
+    makeIteratePath
   } = usePath();
+  const get = useCallback(selector => {
+    var _dataContextRef$curre2;
+    if (selector === '/') {
+      var _dataContextRef$curre;
+      return (_dataContextRef$curre = dataContextRef.current) === null || _dataContextRef$curre === void 0 ? void 0 : _dataContextRef$curre.data;
+    }
+    return pointer.has((_dataContextRef$curre2 = dataContextRef.current) === null || _dataContextRef$curre2 === void 0 ? void 0 : _dataContextRef$curre2.data, selector) ? pointer.get(dataContextRef.current.data, selector) : undefined;
+  }, []);
   const getValueByPath = useCallback(path => {
     if (isPath(path)) {
-      var _dataContextRef$curre2;
-      const selector = makePath(path);
-      if (selector === '/') {
-        var _dataContextRef$curre;
-        return (_dataContextRef$curre = dataContextRef.current) === null || _dataContextRef$curre === void 0 ? void 0 : _dataContextRef$curre.data;
-      }
-      return pointer.has((_dataContextRef$curre2 = dataContextRef.current) === null || _dataContextRef$curre2 === void 0 ? void 0 : _dataContextRef$curre2.data, selector) ? pointer.get(dataContextRef.current.data, selector) : undefined;
+      return get(makePath(path));
+    }
+  }, [get, makePath]);
+  const getValueByIteratePath = useCallback(path => {
+    if (isPath(path)) {
+      return get(makeIteratePath(path));
     }
-  }, [makePath]);
+  }, [get, makeIteratePath]);
   const getData = useCallback((path, options) => {
     if (isPath(path)) {
       const value = getValueByPath(path);
@@ -48,6 +56,7 @@ export default function useDataValue() {
   return {
     getValue,
     getValueByPath,
+    getValueByIteratePath,
     getData,
     value
   };

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

@@ -1 +1 @@
-{"version":3,"file":"useDataValue.js","names":["useCallback","useContext","useRef","pointer","DataContext","usePath","useDataValue","path","pathProp","value","arguments","length","undefined","dataContextRef","current","makePath","getValueByPath","isPath","_dataContextRef$curre2","selector","_dataContextRef$curre","data","has","get","getData","options","includeCurrentPath","set","getValue","source","startsWith"],"sources":["../../../../../src/extensions/forms/hooks/useDataValue.ts"],"sourcesContent":["import { useCallback, useContext, useRef } from 'react'\nimport pointer from 'json-pointer'\nimport { Path } from '../types'\nimport DataContext, { ContextState } from '../DataContext/Context'\nimport usePath from './usePath'\n\nexport type Props<Value> = {\n  path?: Path | undefined\n  value?: Value\n}\n\nexport default function useDataValue<Value>({\n  path: pathProp,\n  value,\n}: Props<Value> = {}) {\n  const dataContextRef = useRef<ContextState>()\n  dataContextRef.current = useContext<ContextState>(DataContext)\n\n  const { makePath } = usePath()\n\n  const getValueByPath = useCallback(\n    (path: Path) => {\n      if (isPath(path)) {\n        const selector = makePath(path)\n        if (selector === '/') {\n          return dataContextRef.current?.data\n        }\n        return pointer.has(dataContextRef.current?.data, selector)\n          ? pointer.get(dataContextRef.current.data, selector)\n          : undefined\n      }\n    },\n    [makePath]\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          const data = {}\n          pointer.set(data, path, value)\n          return data\n        }\n\n        return value\n      }\n    },\n    [getValueByPath]\n  )\n\n  const getValue = useCallback(\n    (source: Path | Value) => {\n      if (typeof source === 'string' && isPath(source)) {\n        return getValueByPath(source)\n      }\n\n      return source\n    },\n    [getValueByPath]\n  )\n\n  if (pathProp) {\n    value = getValue(pathProp)\n  }\n\n  return { getValue, getValueByPath, getData, value }\n}\n\nfunction isPath(path: Path | unknown) {\n  return typeof path === 'string' && path.startsWith('/')\n}\n"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,UAAU,EAAEC,MAAM,QAAQ,OAAO;AACvD,OAAOC,OAAO,MAAM,cAAc;AAElC,OAAOC,WAAW,MAAwB,wBAAwB;AAClE,OAAOC,OAAO,MAAM,WAAW;AAO/B,eAAe,SAASC,YAAYA,CAAA,EAGd;EAAA,IAHsB;IAC1CC,IAAI,EAAEC,QAAQ;IACdC;EACY,CAAC,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,CAAC,CAAC;EAClB,MAAMG,cAAc,GAAGX,MAAM,CAAe,CAAC;EAC7CW,cAAc,CAACC,OAAO,GAAGb,UAAU,CAAeG,WAAW,CAAC;EAE9D,MAAM;IAAEW;EAAS,CAAC,GAAGV,OAAO,CAAC,CAAC;EAE9B,MAAMW,cAAc,GAAGhB,WAAW,CAC/BO,IAAU,IAAK;IACd,IAAIU,MAAM,CAACV,IAAI,CAAC,EAAE;MAAA,IAAAW,sBAAA;MAChB,MAAMC,QAAQ,GAAGJ,QAAQ,CAACR,IAAI,CAAC;MAC/B,IAAIY,QAAQ,KAAK,GAAG,EAAE;QAAA,IAAAC,qBAAA;QACpB,QAAAA,qBAAA,GAAOP,cAAc,CAACC,OAAO,cAAAM,qBAAA,uBAAtBA,qBAAA,CAAwBC,IAAI;MACrC;MACA,OAAOlB,OAAO,CAACmB,GAAG,EAAAJ,sBAAA,GAACL,cAAc,CAACC,OAAO,cAAAI,sBAAA,uBAAtBA,sBAAA,CAAwBG,IAAI,EAAEF,QAAQ,CAAC,GACtDhB,OAAO,CAACoB,GAAG,CAACV,cAAc,CAACC,OAAO,CAACO,IAAI,EAAEF,QAAQ,CAAC,GAClDP,SAAS;IACf;EACF,CAAC,EACD,CAACG,QAAQ,CACX,CAAC;EAED,MAAMS,OAAO,GAAGxB,WAAW,CACzB,CAACO,IAAU,EAAEkB,OAA0C,KAAK;IAC1D,IAAIR,MAAM,CAACV,IAAI,CAAC,EAAE;MAChB,MAAME,KAAK,GAAGO,cAAc,CAACT,IAAI,CAAC;MAElC,IAAIkB,OAAO,aAAPA,OAAO,eAAPA,OAAO,CAAEC,kBAAkB,IAAInB,IAAI,KAAK,GAAG,EAAE;QAC/C,MAAMc,IAAI,GAAG,CAAC,CAAC;QACflB,OAAO,CAACwB,GAAG,CAACN,IAAI,EAAEd,IAAI,EAAEE,KAAK,CAAC;QAC9B,OAAOY,IAAI;MACb;MAEA,OAAOZ,KAAK;IACd;EACF,CAAC,EACD,CAACO,cAAc,CACjB,CAAC;EAED,MAAMY,QAAQ,GAAG5B,WAAW,CACzB6B,MAAoB,IAAK;IACxB,IAAI,OAAOA,MAAM,KAAK,QAAQ,IAAIZ,MAAM,CAACY,MAAM,CAAC,EAAE;MAChD,OAAOb,cAAc,CAACa,MAAM,CAAC;IAC/B;IAEA,OAAOA,MAAM;EACf,CAAC,EACD,CAACb,cAAc,CACjB,CAAC;EAED,IAAIR,QAAQ,EAAE;IACZC,KAAK,GAAGmB,QAAQ,CAACpB,QAAQ,CAAC;EAC5B;EAEA,OAAO;IAAEoB,QAAQ;IAAEZ,cAAc;IAAEQ,OAAO;IAAEf;EAAM,CAAC;AACrD;AAEA,SAASQ,MAAMA,CAACV,IAAoB,EAAE;EACpC,OAAO,OAAOA,IAAI,KAAK,QAAQ,IAAIA,IAAI,CAACuB,UAAU,CAAC,GAAG,CAAC;AACzD"}
+{"version":3,"file":"useDataValue.js","names":["useCallback","useContext","useRef","pointer","DataContext","usePath","useDataValue","path","pathProp","value","arguments","length","undefined","dataContextRef","current","makePath","makeIteratePath","get","selector","_dataContextRef$curre2","_dataContextRef$curre","data","has","getValueByPath","isPath","getValueByIteratePath","getData","options","includeCurrentPath","set","getValue","source","startsWith"],"sources":["../../../../../src/extensions/forms/hooks/useDataValue.ts"],"sourcesContent":["import { useCallback, useContext, useRef } from 'react'\nimport pointer from 'json-pointer'\nimport { Path } from '../types'\nimport DataContext, { ContextState } from '../DataContext/Context'\nimport usePath from './usePath'\n\nexport type Props<Value> = {\n  path?: Path | undefined\n  value?: Value\n}\n\nexport default function useDataValue<Value>({\n  path: pathProp,\n  value,\n}: Props<Value> = {}) {\n  const dataContextRef = useRef<ContextState>()\n  dataContextRef.current = useContext<ContextState>(DataContext)\n\n  const { makePath, makeIteratePath } = usePath()\n\n  const get = useCallback((selector: Path) => {\n    if (selector === '/') {\n      return dataContextRef.current?.data\n    }\n    return pointer.has(dataContextRef.current?.data, selector)\n      ? pointer.get(dataContextRef.current.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 getData = useCallback(\n    (path: Path, options?: { includeCurrentPath?: boolean }) => {\n      if (isPath(path)) {\n        const value = getValueByPath(path)\n\n        if (options?.includeCurrentPath && path !== '/') {\n          const data = {}\n          pointer.set(data, path, value)\n          return data\n        }\n\n        return value\n      }\n    },\n    [getValueByPath]\n  )\n\n  const getValue = useCallback(\n    (source: Path | Value) => {\n      if (typeof source === 'string' && isPath(source)) {\n        return getValueByPath(source)\n      }\n\n      return source\n    },\n    [getValueByPath]\n  )\n\n  if (pathProp) {\n    value = getValue(pathProp)\n  }\n\n  return {\n    getValue,\n    getValueByPath,\n    getValueByIteratePath,\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/useFieldProps.d.ts

@@ -1,21 +1,21 @@
 import { AriaAttributes } from 'react';
-import { FieldProps, AdditionalEventArgs, SubmitState } from '../types';
+import { FieldPropsGeneric, AdditionalEventArgs, SubmitState } from '../types';
 import { ContextState } from '../DataContext';
 export type DataAttributes = {
     [property: `data-${string}`]: string | boolean | number;
 };
-export default function useFieldProps<Value = unknown, Props extends FieldProps<Value> = FieldProps<Value>>(localeProps: Props, { executeOnChangeRegardlessOfError }?: {
+export default function useFieldProps<Value, EmptyValue, Props>(localeProps: Props & FieldPropsGeneric<Value, EmptyValue>, { executeOnChangeRegardlessOfError }?: {
     executeOnChangeRegardlessOfError?: boolean;
-}): Props & FieldProps<Value> & ReturnAdditional<Value>;
+}): typeof localeProps & ReturnAdditional<Value>;
 export interface ReturnAdditional<Value> {
     /** Documented APIs */
     value: Value;
     isChanged: boolean;
     htmlAttributes: AriaAttributes | DataAttributes;
-    setHasFocus: (hasFocus: boolean, valueOverride?: unknown) => void;
+    setHasFocus: (hasFocus: boolean, valueOverride?: unknown, additionalArgs?: AdditionalEventArgs) => void;
     handleFocus: () => void;
     handleBlur: () => void;
-    handleChange: (value: Value, additionalArgs?: AdditionalEventArgs) => void;
+    handleChange: (value: Value | unknown, additionalArgs?: AdditionalEventArgs) => void;
     updateValue: (value: Value) => void;
     forceUpdate: () => void;
     hasError?: boolean;

package/extensions/forms/hooks/useFieldProps.js

@@ -9,6 +9,7 @@ import { errorChanged } from '../utils';
 import { ajvErrorsToOneFormError } from '../utils/ajv';
 import { FormError } from '../types';
 import { Context as DataContext } from '../DataContext';
+import { clearedData } from '../DataContext/Provider/Provider';
 import FieldPropsContext from '../Form/FieldProps/FieldPropsContext';
 import { combineDescribedBy } from '../../../shared/component-helper';
 import useId from '../../../shared/helpers/useId';
@@ -68,6 +69,7 @@ export default function useFieldProps(localeProps) {
     fromInput = value => value,
     toEvent = value => value,
     transformValue = value => value,
+    transformAdditionalArgs = additionalArgs => additionalArgs,
     fromExternal = value => value,
     validateRequired = (value, _ref) => {
       let {
@@ -93,6 +95,7 @@ export default function useFieldProps(localeProps) {
   const transformers = useRef({
     transformIn,
     transformOut,
+    transformAdditionalArgs,
     toInput,
     fromInput,
     toEvent,
@@ -174,7 +177,7 @@ export default function useFieldProps(localeProps) {
       }
     }
   }, [sectionPath, dataContext.schema, identifier, requiredProp, schema]);
-  const showErrorRef = useRef(Boolean(validateInitially || errorProp));
+  const revealErrorRef = useRef(Boolean(validateInitially || errorProp));
   const errorMethodRef = useRef({});
   const localErrorRef = useRef();
   const hasLocalErrorRef = useRef(false);
@@ -263,15 +266,17 @@ export default function useFieldProps(localeProps) {
       forceUpdate();
     }
   }, [setFieldStateDataContext, identifier, validateInitially]);
-  const showError = useCallback(() => {
-    showErrorRef.current = true;
+  const revealError = useCallback(() => {
+    revealErrorRef.current = true;
     showFieldErrorFieldBlock === null || showFieldErrorFieldBlock === void 0 ? void 0 : showFieldErrorFieldBlock(identifier, true);
     if (localErrorRef.current) {
       setHasVisibleErrorDataContext === null || setHasVisibleErrorDataContext === void 0 ? void 0 : setHasVisibleErrorDataContext(identifier, true);
+    } else {
+      setHasVisibleErrorDataContext === null || setHasVisibleErrorDataContext === void 0 ? void 0 : setHasVisibleErrorDataContext(identifier, false);
     }
   }, [showFieldErrorFieldBlock, identifier, setHasVisibleErrorDataContext]);
   const hideError = useCallback(() => {
-    showErrorRef.current = false;
+    revealErrorRef.current = false;
     showFieldErrorFieldBlock === null || showFieldErrorFieldBlock === void 0 ? void 0 : showFieldErrorFieldBlock(identifier, false);
     setHasVisibleErrorDataContext === null || setHasVisibleErrorDataContext === void 0 ? void 0 : setHasVisibleErrorDataContext(identifier, false);
   }, [setHasVisibleErrorDataContext, identifier, showFieldErrorFieldBlock]);
@@ -307,7 +312,7 @@ export default function useFieldProps(localeProps) {
       return error;
     }
   }, [dataContextError, prepareError]);
-  const error = showErrorRef.current || ((_localErrorRef$curren = localErrorRef.current) === null || _localErrorRef$curren === void 0 ? void 0 : _localErrorRef$curren['validationRule']) === 'type' ? (_ref3 = errorProp !== null && errorProp !== void 0 ? errorProp : localErrorRef.current) !== null && _ref3 !== void 0 ? _ref3 : contextErrorRef.current : undefined;
+  const error = revealErrorRef.current || ((_localErrorRef$curren = localErrorRef.current) === null || _localErrorRef$curren === void 0 ? void 0 : _localErrorRef$curren['validationRule']) === 'type' ? (_ref3 = errorProp !== null && errorProp !== void 0 ? errorProp : localErrorRef.current) !== null && _ref3 !== void 0 ? _ref3 : contextErrorRef.current : undefined;
   const hasVisibleError = Boolean(error) || inFieldBlock && fieldBlockContext.hasErrorProp;
   const hasError = useCallback(() => {
     var _ref4;
@@ -363,7 +368,7 @@ export default function useFieldProps(localeProps) {
       persistErrorState('gracefully', result);
       if (continuousValidation || runAsync) {
         window.requestAnimationFrame(() => {
-          showError();
+          revealError();
           forceUpdate();
         });
       }
@@ -377,7 +382,7 @@ export default function useFieldProps(localeProps) {
       }
     }
     return result;
-  }, [contextErrorMessages, continuousValidation, hideError, persistErrorState, defineAsyncProcess, setFieldState, showError]);
+  }, [contextErrorMessages, continuousValidation, hideError, persistErrorState, defineAsyncProcess, setFieldState, revealError]);
   const callOnBlurValidator = useCallback(async function () {
     let {
       valueOverride = null
@@ -397,9 +402,9 @@ export default function useFieldProps(localeProps) {
       defineAsyncProcess(undefined);
       setFieldState(result instanceof Error ? 'error' : 'complete');
     }
-    showError();
+    revealError();
     forceUpdate();
-  }, [persistErrorState, defineAsyncProcess, setFieldState, showError]);
+  }, [persistErrorState, defineAsyncProcess, setFieldState, revealError]);
   const prioritizeContextSchema = useMemo(() => {
     if (errorPrioritization) {
       const schemaPath = identifier.split('/').join('/properties/');
@@ -455,20 +460,25 @@ export default function useFieldProps(localeProps) {
   }, [startProcess, disabled, hideError, setFieldState, clearErrorState, emptyValue, requiredProp, required, prioritizeContextSchema, validateInitially, callValidator, persistErrorState]);
   const handleError = useCallback(() => {
     if (continuousValidation || continuousValidation !== false && !hasFocusRef.current) {
-      showError();
+      revealError();
     } else {
       hideError();
     }
-  }, [continuousValidation, hideError, showError]);
-  const setHasFocus = useCallback(async (hasFocus, valueOverride) => {
+  }, [continuousValidation, hideError, revealError]);
+  const setHasFocus = useCallback(async (hasFocus, valueOverride, additionalArgs) => {
+    const getArgs = type => {
+      const value = transformers.current.toEvent(valueOverride !== null && valueOverride !== void 0 ? valueOverride : valueRef.current, type);
+      const transformedAdditionalArgs = transformers.current.transformAdditionalArgs(additionalArgs, value);
+      return typeof transformedAdditionalArgs !== 'undefined' ? [value, transformedAdditionalArgs] : [value];
+    };
     if (hasFocus) {
       hasFocusRef.current = true;
-      const value = transformers.current.toEvent(valueOverride !== null && valueOverride !== void 0 ? valueOverride : valueRef.current, 'onFocus');
-      onFocus === null || onFocus === void 0 ? void 0 : onFocus(value);
+      const args = getArgs('onFocus');
+      onFocus === null || onFocus === void 0 ? void 0 : onFocus.apply(this, args);
     } else {
       hasFocusRef.current = false;
-      const value = transformers.current.toEvent(valueOverride !== null && valueOverride !== void 0 ? valueOverride : valueRef.current, 'onBlur');
-      onBlur === null || onBlur === void 0 ? void 0 : onBlur(value);
+      const args = getArgs('onBlur');
+      onBlur === null || onBlur === void 0 ? void 0 : onBlur.apply(this, args);
       if (!changedRef.current && !validateUnchanged) {
         return;
       }
@@ -476,11 +486,11 @@ export default function useFieldProps(localeProps) {
         valueOverride
       }), isAsync(onBlurValidatorRef.current));
       await runPool(() => {
-        showError();
+        revealError();
         forceUpdate();
       });
     }
-  }, [addToPool, callOnBlurValidator, onBlur, onFocus, runPool, showError, validateUnchanged]);
+  }, [addToPool, callOnBlurValidator, onBlur, onFocus, runPool, revealError, validateUnchanged]);
   const yieldAsyncProcess = useCallback(async _ref5 => {
     let {
       name,
@@ -517,7 +527,7 @@ export default function useFieldProps(localeProps) {
     const result = changeEventResultRef.current;
     if (typeof (result === null || result === void 0 ? void 0 : result.error) !== 'undefined') {
       persistErrorState('gracefully', result.error);
-      showError();
+      revealError();
     }
     if (typeof (result === null || result === void 0 ? void 0 : result.warning) !== 'undefined') {
       warningRef.current = result.warning;
@@ -541,7 +551,7 @@ export default function useFieldProps(localeProps) {
     } else if (asyncBehaviorIsEnabled) {
       setFieldState('complete');
     }
-  }, [asyncBehaviorIsEnabled, defineAsyncProcess, persistErrorState, setFieldState, showError, yieldAsyncProcess]);
+  }, [asyncBehaviorIsEnabled, defineAsyncProcess, persistErrorState, setFieldState, revealError, yieldAsyncProcess]);
   const setEventResult = useCallback(result => {
     if (result instanceof Error) {
       result = {
@@ -614,7 +624,8 @@ export default function useFieldProps(localeProps) {
     }
     const getArgs = () => {
       const value = transformers.current.toEvent(valueRef.current, 'onChange');
-      return typeof additionalArgs !== 'undefined' ? [value, additionalArgs] : [value];
+      const transformedAdditionalArgs = transformers.current.transformAdditionalArgs(additionalArgs, value);
+      return typeof transformedAdditionalArgs !== 'undefined' ? [value, transformedAdditionalArgs] : [value];
     };
     if (isAsync(onChange)) {
       addToPool('onChangeLocal', async () => {
@@ -665,6 +676,11 @@ export default function useFieldProps(localeProps) {
     schemaValidatorRef.current = schema ? (_dataContext$ajvInsta2 = dataContext.ajvInstance) === null || _dataContext$ajvInsta2 === void 0 ? void 0 : _dataContext$ajvInsta2.compile(schema) : undefined;
     validateValue();
   }, [schema, validateValue]);
+  useEffect(() => {
+    if (dataContext.data === clearedData) {
+      hideError();
+    }
+  }, [dataContext.data, hideError]);
   useUpdateEffect(() => {
     if (valueRef.current !== externalValue) {
       valueRef.current = externalValue;
@@ -713,11 +729,11 @@ export default function useFieldProps(localeProps) {
   useEffect(() => {
     if (showAllErrors) {
       if (fieldStateRef.current !== 'validating') {
-        showError();
+        revealError();
         forceUpdate();
       }
     }
-  }, [showAllErrors, showError]);
+  }, [showAllErrors, revealError]);
   useEffect(() => {
     if (dataContext.formState === 'pending' && (validatorRef.current || onBlurValidatorRef.current)) {
       hideError();