@oneblink/apps-react 13.0.0-beta.3 → 13.0.0-beta.5

package/dist/form-elements/FormElementSummary.js.map

@@ -1 +1 @@
-{"version":3,"file":"FormElementSummary.js","sourceRoot":"","sources":["../../src/form-elements/FormElementSummary.tsx"],"names":[],"mappings":"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","sourcesContent":["import * as React from 'react'\nimport { localisationService } from '../apps'\n\nimport { useFormSubmissionModelParent } from '../hooks/useFormSubmissionModelContext'\nimport useFlattenElements from '../hooks/useFlattenElementsContext'\nimport { FormTypes, SubmissionTypes } from '@oneblink/types'\nimport { FormElementValueChangeHandler } from '../types/form'\ntype Props = {\n  element: FormTypes.SummaryElement\n  onChange: FormElementValueChangeHandler\n  value: unknown\n}\n\nconst arraysAreEqual = (a: unknown[], b: unknown[]) => {\n  if (!Array.isArray(a) || !Array.isArray(b)) {\n    if (a !== b) return false\n    return true\n  }\n  if (a.length !== b.length) return false\n\n  for (let i = 0; i < a.length; i++) {\n    if (Array.isArray(a[i]) && Array.isArray(b[i])) {\n      const areEqual = arraysAreEqual(a[i] as unknown[], b[i] as unknown[])\n      if (!areEqual) return false\n      continue\n    }\n    if (a[i] !== b[i]) return false\n  }\n  return true\n}\nfunction FormElementSummary({ element, onChange, value }: Props) {\n  const { formSubmissionModel } = useFormSubmissionModelParent()\n  const flattenedElements = useFlattenElements()\n\n  const reducer = React.useCallback(\n    (\n      partialSummary: FormElementSummaryResults,\n      formElement: FormTypes.FormElement,\n      submission: SubmissionTypes.S3SubmissionData['submission'],\n    ) => {\n      if (!('name' in formElement)) return partialSummary\n      if (\n        formElement.type !== 'repeatableSet' &&\n        formElement.type !== 'form' &&\n        !element.elementIds.some((elementId) => elementId === formElement.id)\n      ) {\n        return partialSummary\n      }\n\n      const formElementValue = submission[formElement.name]\n      if (!formElementValue && formElementValue !== 0) {\n        return partialSummary\n      }\n\n      switch (formElement.type) {\n        case 'repeatableSet': {\n          if (!Array.isArray(formElementValue)) return partialSummary\n          // If we found a repeatable set, look through child elements\n          // to find the summary elements. Need to start a new array for\n          // this structure and look at each entry in the repeatable set\n          for (const entry of formElementValue) {\n            const repeatableSetSummaryValues = formElement.elements.reduce(\n              (\n                partialSummary: FormElementSummaryResults,\n                formElement: FormTypes.FormElement,\n              ) =>\n                // eslint-disable-next-line react-hooks/immutability\n                reducer(\n                  partialSummary,\n                  formElement,\n                  // Pleasing TypeScript\n                  entry instanceof Object ? entry : {},\n                ),\n              [],\n            )\n            if (repeatableSetSummaryValues.length) {\n              partialSummary.push(repeatableSetSummaryValues)\n            }\n          }\n          break\n        }\n        case 'form': {\n          const formSummaryValues = (formElement.elements || []).reduce(\n            (\n              partialSummary: FormElementSummaryResults,\n              formElement: FormTypes.FormElement,\n            ) =>\n              reducer(\n                partialSummary,\n                formElement,\n                // @ts-expect-error Pleasing TypeScript\n                formElementValue instanceof Object ? formElementValue : {},\n              ),\n            [],\n          )\n          if (formSummaryValues.length) {\n            partialSummary.push(formSummaryValues)\n          }\n\n          break\n        }\n        case 'select':\n        case 'autocomplete':\n        case 'radio':\n        case 'checkboxes': {\n          const optionValues = []\n          if (Array.isArray(formElementValue)) {\n            optionValues.push(...formElementValue)\n          } else {\n            optionValues.push(formElementValue)\n          }\n          if (Array.isArray(formElement.options)) {\n            partialSummary.push(\n              ...optionValues.reduce((optionLabels, optionValue) => {\n                const option = formElement.options?.find(\n                  ({ value }: FormTypes.ChoiceElementOption) =>\n                    optionValue === value,\n                )\n                if (option) {\n                  optionLabels.push(option.label)\n                }\n                return optionLabels\n              }, []),\n            )\n          }\n          break\n        }\n        case 'date': {\n          const date = localisationService.generateDate({\n            daysOffset: undefined,\n            value: formElementValue as string,\n          })\n          if (date) {\n            partialSummary.push(localisationService.formatDate(date))\n          }\n          break\n        }\n        case 'datetime': {\n          if (typeof formElementValue !== 'string') return partialSummary\n          partialSummary.push(\n            localisationService.formatDatetime(new Date(formElementValue)),\n          )\n          break\n        }\n        case 'time': {\n          if (typeof formElementValue !== 'string') return partialSummary\n          partialSummary.push(\n            localisationService.formatTime(new Date(formElementValue)),\n          )\n          break\n        }\n        default: {\n          // Pleasing TypeScript WHILE COVERING ALL BASES\n          if (\n            typeof formElementValue !== 'string' &&\n            typeof formElementValue !== 'object' &&\n            typeof formElementValue !== 'number' &&\n            typeof formElementValue !== 'function' &&\n            typeof formElementValue !== 'boolean'\n          ) {\n            return partialSummary\n          }\n\n          partialSummary.push(formElementValue.toString())\n        }\n      }\n      return partialSummary\n    },\n    [element.elementIds],\n  )\n\n  // MODEL LISTENER\n  React.useEffect(() => {\n    const summary = flattenedElements.reduce<FormElementSummaryResults>(\n      (partialSummary, formElement) => {\n        return reducer(partialSummary, formElement, formSubmissionModel)\n      },\n\n      [],\n    )\n\n    if (value === undefined) {\n      if (!summary.length) return\n    }\n    if (arraysAreEqual(value as FormElementSummaryResults, summary)) {\n      return\n    }\n    if (summary.length) {\n      onChange(element, {\n        value: summary,\n      })\n    } else {\n      onChange(element, {\n        value: undefined,\n      })\n    }\n  }, [\n    element,\n    flattenedElements,\n    formSubmissionModel,\n    onChange,\n    reducer,\n    value,\n  ])\n\n  return (\n    <div className=\"ob-form__element ob-summary cypress-summary-result \">\n      {!!value && Array.isArray(value) && (\n        <SummaryResult results={value}></SummaryResult>\n      )}\n    </div>\n  )\n}\n\ntype FormElementSummaryResults = Array<string | FormElementSummaryResults>\ntype FormElementSummaryResultProps = {\n  results: FormElementSummaryResults\n}\n\nconst SummaryResult = React.memo<FormElementSummaryResultProps>(\n  function SummaryResult({ results }) {\n    return (\n      <>\n        {results.map((result, i) => {\n          return (\n            <div\n              key={`${result.toString()}-${i}`}\n              className=\"ob-summary__result-container\"\n            >\n              {typeof result === 'string' ? (\n                <p className=\"ob-summary__result has-line-breaks cypress-summary-result-text\">\n                  {result}\n                </p>\n              ) : (\n                <SummaryResult results={result}></SummaryResult>\n              )}\n            </div>\n          )\n        })}\n      </>\n    )\n  },\n)\n\nexport default React.memo(FormElementSummary)\n"]}
+{"version":3,"file":"FormElementSummary.js","sourceRoot":"","sources":["../../src/form-elements/FormElementSummary.tsx"],"names":[],"mappings":"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","sourcesContent":["import * as React from 'react'\nimport { localisationService } from '../apps'\n\nimport { useFormSubmissionModelParent } from '../hooks/useFormSubmissionModelContext'\nimport useFlattenElements from '../hooks/useFlattenElementsContext'\nimport { FormTypes, SubmissionTypes } from '@oneblink/types'\nimport { FormElementValueChangeHandler } from '../types/form'\ntype Props = {\n  element: FormTypes.SummaryElement\n  onChange: FormElementValueChangeHandler\n  value: unknown\n}\n\nconst arraysAreEqual = (a: unknown[], b: unknown[]) => {\n  if (!Array.isArray(a) || !Array.isArray(b)) {\n    if (a !== b) return false\n    return true\n  }\n  if (a.length !== b.length) return false\n\n  for (let i = 0; i < a.length; i++) {\n    if (Array.isArray(a[i]) && Array.isArray(b[i])) {\n      const areEqual = arraysAreEqual(a[i] as unknown[], b[i] as unknown[])\n      if (!areEqual) return false\n      continue\n    }\n    if (a[i] !== b[i]) return false\n  }\n  return true\n}\nfunction FormElementSummary({ element, onChange, value }: Props) {\n  const { formSubmissionModel } = useFormSubmissionModelParent()\n  const flattenedElements = useFlattenElements()\n\n  const reducer = React.useCallback(\n    (\n      partialSummary: FormElementSummaryResults,\n      formElement: FormTypes.FormElement,\n      submission: SubmissionTypes.S3SubmissionData['submission'],\n    ) => {\n      if (!('name' in formElement)) return partialSummary\n      if (\n        formElement.type !== 'repeatableSet' &&\n        formElement.type !== 'form' &&\n        !element.elementIds.some((elementId) => elementId === formElement.id)\n      ) {\n        return partialSummary\n      }\n\n      const formElementValue = submission[formElement.name]\n      if (!formElementValue && formElementValue !== 0) {\n        return partialSummary\n      }\n\n      switch (formElement.type) {\n        case 'repeatableSet': {\n          if (!Array.isArray(formElementValue)) return partialSummary\n          // If we found a repeatable set, look through child elements\n          // to find the summary elements. Need to start a new array for\n          // this structure and look at each entry in the repeatable set\n          for (const entry of formElementValue) {\n            const repeatableSetSummaryValues = formElement.elements.reduce(\n              (\n                partialSummary: FormElementSummaryResults,\n                formElement: FormTypes.FormElement,\n              ) =>\n                // eslint-disable-next-line react-hooks/immutability\n                reducer(\n                  partialSummary,\n                  formElement,\n                  // Pleasing TypeScript\n                  entry instanceof Object ? entry : {},\n                ),\n              [],\n            )\n            if (repeatableSetSummaryValues.length) {\n              partialSummary.push(repeatableSetSummaryValues)\n            }\n          }\n          break\n        }\n        case 'form': {\n          const formSummaryValues = (formElement.elements || []).reduce(\n            (\n              partialSummary: FormElementSummaryResults,\n              formElement: FormTypes.FormElement,\n            ) =>\n              reducer(\n                partialSummary,\n                formElement,\n                // @ts-expect-error Pleasing TypeScript\n                formElementValue instanceof Object ? formElementValue : {},\n              ),\n            [],\n          )\n          if (formSummaryValues.length) {\n            partialSummary.push(formSummaryValues)\n          }\n\n          break\n        }\n        case 'select':\n        case 'autocomplete':\n        case 'radio':\n        case 'checkboxes': {\n          const optionValues = []\n          if (Array.isArray(formElementValue)) {\n            optionValues.push(...formElementValue)\n          } else {\n            optionValues.push(formElementValue)\n          }\n          if (Array.isArray(formElement.options)) {\n            partialSummary.push(\n              ...optionValues.reduce((optionLabels, optionValue) => {\n                const option = formElement.options?.find(\n                  ({ value }: FormTypes.ChoiceElementOption) =>\n                    optionValue === value,\n                )\n                if (option) {\n                  optionLabels.push(option.label)\n                }\n                return optionLabels\n              }, []),\n            )\n          }\n          break\n        }\n        case 'date': {\n          const date = localisationService.generateDate({\n            daysOffset: undefined,\n            value: formElementValue as string,\n          })\n          if (date) {\n            partialSummary.push(localisationService.formatDate(date))\n          }\n          break\n        }\n        case 'datetime': {\n          if (typeof formElementValue !== 'string') return partialSummary\n          partialSummary.push(\n            localisationService.formatDatetime(new Date(formElementValue)),\n          )\n          break\n        }\n        case 'time': {\n          if (typeof formElementValue !== 'string') return partialSummary\n          partialSummary.push(\n            localisationService.formatTime(new Date(formElementValue)),\n          )\n          break\n        }\n        default: {\n          // Pleasing TypeScript WHILE COVERING ALL BASES\n          if (\n            typeof formElementValue !== 'string' &&\n            typeof formElementValue !== 'object' &&\n            typeof formElementValue !== 'number' &&\n            typeof formElementValue !== 'function' &&\n            typeof formElementValue !== 'boolean'\n          ) {\n            return partialSummary\n          }\n\n          partialSummary.push(formElementValue.toString())\n        }\n      }\n      return partialSummary\n    },\n    [element.elementIds],\n  )\n\n  // MODEL LISTENER\n  React.useEffect(() => {\n    const summary = flattenedElements.reduce<FormElementSummaryResults>(\n      (partialSummary, formElement) => {\n        return reducer(partialSummary, formElement, formSubmissionModel)\n      },\n\n      [],\n    )\n\n    if (value === undefined) {\n      if (!summary.length) return\n    }\n    if (arraysAreEqual(value as FormElementSummaryResults, summary)) {\n      return\n    }\n    if (summary.length) {\n      onChange(element, {\n        value: summary,\n        isDerivedChange: true,\n      })\n    } else {\n      onChange(element, {\n        value: undefined,\n        isDerivedChange: true,\n      })\n    }\n  }, [\n    element,\n    flattenedElements,\n    formSubmissionModel,\n    onChange,\n    reducer,\n    value,\n  ])\n\n  return (\n    <div className=\"ob-form__element ob-summary cypress-summary-result \">\n      {!!value && Array.isArray(value) && (\n        <SummaryResult results={value}></SummaryResult>\n      )}\n    </div>\n  )\n}\n\ntype FormElementSummaryResults = Array<string | FormElementSummaryResults>\ntype FormElementSummaryResultProps = {\n  results: FormElementSummaryResults\n}\n\nconst SummaryResult = React.memo<FormElementSummaryResultProps>(\n  function SummaryResult({ results }) {\n    return (\n      <>\n        {results.map((result, i) => {\n          return (\n            <div\n              key={`${result.toString()}-${i}`}\n              className=\"ob-summary__result-container\"\n            >\n              {typeof result === 'string' ? (\n                <p className=\"ob-summary__result has-line-breaks cypress-summary-result-text\">\n                  {result}\n                </p>\n              ) : (\n                <SummaryResult results={result}></SummaryResult>\n              )}\n            </div>\n          )\n        })}\n      </>\n    )\n  },\n)\n\nexport default React.memo(FormElementSummary)\n"]}

package/dist/hooks/useAreLookupsDisallowed.d.ts

@@ -0,0 +1,2 @@
+import { FormTypes } from '@oneblink/types';
+export default function useAreLookupsDisallowed(element: FormTypes.FormElement | FormTypes.LookupFormElement): boolean;

package/dist/hooks/useAreLookupsDisallowed.js

@@ -0,0 +1,12 @@
+import useEditableFormElementIds from './useEditableFormElementIds';
+import useFormIsReadOnly from './useFormIsReadOnly';
+import { checkAreLookupsDisallowed } from '../utils/read-only-form-elements';
+export default function useAreLookupsDisallowed(element) {
+    const isFormReadOnly = useFormIsReadOnly();
+    const editableFormElementIds = useEditableFormElementIds();
+    return checkAreLookupsDisallowed(element, {
+        isFormReadOnly,
+        editableFormElementIds,
+    });
+}
+//# sourceMappingURL=useAreLookupsDisallowed.js.map

package/dist/hooks/useAreLookupsDisallowed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAreLookupsDisallowed.js","sourceRoot":"","sources":["../../src/hooks/useAreLookupsDisallowed.ts"],"names":[],"mappings":"AACA,OAAO,yBAAyB,MAAM,6BAA6B,CAAA;AACnE,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAA;AAE5E,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAC7C,OAA4D;IAE5D,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAA;IAC1C,MAAM,sBAAsB,GAAG,yBAAyB,EAAE,CAAA;IAE1D,OAAO,yBAAyB,CAAC,OAAO,EAAE;QACxC,cAAc;QACd,sBAAsB;KACvB,CAAC,CAAA;AACJ,CAAC","sourcesContent":["import { FormTypes } from '@oneblink/types'\r\nimport useEditableFormElementIds from './useEditableFormElementIds'\r\nimport useFormIsReadOnly from './useFormIsReadOnly'\r\nimport { checkAreLookupsDisallowed } from '../utils/read-only-form-elements'\r\n\r\nexport default function useAreLookupsDisallowed(\r\n  element: FormTypes.FormElement | FormTypes.LookupFormElement,\r\n): boolean {\r\n  const isFormReadOnly = useFormIsReadOnly()\r\n  const editableFormElementIds = useEditableFormElementIds()\r\n\r\n  return checkAreLookupsDisallowed(element, {\r\n    isFormReadOnly,\r\n    editableFormElementIds,\r\n  })\r\n}\r\n"]}

package/dist/hooks/useEditableFormElementIds.d.ts

@@ -0,0 +1,3 @@
+import * as React from 'react';
+export declare const EditableFormElementIdsContext: React.Context<string[] | undefined>;
+export default function useEditableFormElementIds(): string[] | undefined;

package/dist/hooks/useEditableFormElementIds.js

@@ -0,0 +1,6 @@
+import * as React from 'react';
+export const EditableFormElementIdsContext = React.createContext(undefined);
+export default function useEditableFormElementIds() {
+    return React.useContext(EditableFormElementIdsContext);
+}
+//# sourceMappingURL=useEditableFormElementIds.js.map

package/dist/hooks/useEditableFormElementIds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEditableFormElementIds.js","sourceRoot":"","sources":["../../src/hooks/useEditableFormElementIds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,MAAM,CAAC,MAAM,6BAA6B,GAAG,KAAK,CAAC,aAAa,CAE9D,SAAS,CAAC,CAAA;AAEZ,MAAM,CAAC,OAAO,UAAU,yBAAyB;IAC/C,OAAO,KAAK,CAAC,UAAU,CAAC,6BAA6B,CAAC,CAAA;AACxD,CAAC","sourcesContent":["import * as React from 'react'\n\nexport const EditableFormElementIdsContext = React.createContext<\n  string[] | undefined\n>(undefined)\n\nexport default function useEditableFormElementIds(): string[] | undefined {\n  return React.useContext(EditableFormElementIdsContext)\n}\n"]}

package/dist/hooks/useFormElementOptions.js

@@ -63,6 +63,7 @@ export default function useFormElementOptions({ element, value, onChange, condit
             !filteredOptions.some((option) => value === option.value)) {
             onChange(element, {
                 value: undefined,
+                isDerivedChange: true,
             });
             return;
         }
@@ -72,6 +73,7 @@ export default function useFormElementOptions({ element, value, onChange, condit
                 const newValueArray = newValue.length ? newValue : undefined;
                 onChange(element, {
                     value: newValueArray,
+                    isDerivedChange: true,
                 });
             }
         }

package/dist/hooks/useFormElementOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFormElementOptions.js","sourceRoot":"","sources":["../../src/hooks/useFormElementOptions.ts"],"names":[],"mappings":"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","sourcesContent":["import { FormTypes } from '@oneblink/types'\nimport * as React from 'react'\nimport {\n  FormElementValueChangeHandler,\n  FormElementConditionallyShownElement,\n  UpdateFormElementsHandler,\n} from '../types/form'\nimport { useLoadDynamicOptionsEffect } from './useDynamicOptionsLoaderState'\nimport useFormSubmissionModel from './useFormSubmissionModelContext'\nimport processInjectableOption from '../services/injectableOptions'\nimport useTaskContext from './useTaskContext'\nimport useUserProfileForInjectables from './useUserProfileForInjectables'\n\nexport default function useFormElementOptions<T>({\n  element,\n  value,\n  onChange,\n  conditionallyShownOptionsElement,\n  onFilter,\n  onUpdateFormElements,\n}: {\n  element: FormTypes.FormElementWithOptions\n  value: unknown | undefined\n  onChange: FormElementValueChangeHandler<T>\n  conditionallyShownOptionsElement:\n    | FormElementConditionallyShownElement\n    | undefined\n  onFilter?: (choiceElementOption: FormTypes.ChoiceElementOption) => boolean\n  onUpdateFormElements: UpdateFormElementsHandler\n}) {\n  const taskContext = useTaskContext()\n  const userProfileForInjectables = useUserProfileForInjectables()\n\n  const { formSubmissionModel, elements, parent } = useFormSubmissionModel()\n  const conditionallyShownOptions = conditionallyShownOptionsElement?.options\n  //options that are shown due to conditional logic\n  const shownOptions = React.useMemo<FormTypes.ChoiceElementOption[]>(() => {\n    if (!element.options) {\n      return []\n    }\n    if (!conditionallyShownOptions && !onFilter) {\n      return element.options\n    }\n    return element.options.filter((option) => {\n      return (\n        !conditionallyShownOptions ||\n        conditionallyShownOptions.some(({ id }) => id === option.id)\n      )\n    })\n  }, [conditionallyShownOptions, element.options, onFilter])\n\n  //\n  const withInjectedOptions = React.useMemo(() => {\n    return shownOptions.reduce<FormTypes.ChoiceElementOption[]>(\n      (memo, option) => {\n        const newOptions = processInjectableOption({\n          option,\n          submission: formSubmissionModel,\n          formElements: elements,\n          contextSubmission: parent?.formSubmissionModel || {},\n          contextElements: parent?.elements || [],\n          taskContext,\n          userProfile: userProfileForInjectables,\n        })\n        memo.push(...newOptions)\n\n        return memo\n      },\n      [],\n    )\n  }, [\n    elements,\n    formSubmissionModel,\n    parent,\n    shownOptions,\n    taskContext,\n    userProfileForInjectables,\n  ])\n\n  //options that are shown based on conditional logic, attributes, and user input\n  const filteredOptions = React.useMemo<FormTypes.ChoiceElementOption[]>(() => {\n    const reducedOptions = withInjectedOptions.filter(\n      (option) => !onFilter || (onFilter(option) && !option.displayAlways),\n    )\n    if (element.type === 'autocomplete') {\n      const alwaysShownOptions = withInjectedOptions.filter(\n        (option) => option.displayAlways,\n      )\n      reducedOptions.push(...alwaysShownOptions)\n    }\n    return reducedOptions\n  }, [withInjectedOptions, element.type, onFilter])\n\n  React.useEffect(() => {\n    if (\n      !element.options ||\n      conditionallyShownOptionsElement?.dependencyIsLoading\n    ) {\n      return\n    }\n\n    if (\n      typeof value === 'string' &&\n      !filteredOptions.some((option) => value === option.value)\n    ) {\n      onChange(element, {\n        value: undefined,\n      })\n      return\n    }\n\n    if (Array.isArray(value)) {\n      const newValue = value.filter((selectedValue) =>\n        filteredOptions.some((option) => selectedValue === option.value),\n      )\n      if (newValue.length !== value.length) {\n        const newValueArray = newValue.length ? newValue : undefined\n        onChange(element, {\n          value: newValueArray as T | undefined,\n        })\n      }\n    }\n  }, [\n    element,\n    onChange,\n    value,\n    conditionallyShownOptionsElement?.dependencyIsLoading,\n    filteredOptions,\n  ])\n\n  useLoadDynamicOptionsEffect(element, onUpdateFormElements)\n\n  return filteredOptions\n}\n"]}
+{"version":3,"file":"useFormElementOptions.js","sourceRoot":"","sources":["../../src/hooks/useFormElementOptions.ts"],"names":[],"mappings":"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","sourcesContent":["import { FormTypes } from '@oneblink/types'\nimport * as React from 'react'\nimport {\n  FormElementValueChangeHandler,\n  FormElementConditionallyShownElement,\n  UpdateFormElementsHandler,\n} from '../types/form'\nimport { useLoadDynamicOptionsEffect } from './useDynamicOptionsLoaderState'\nimport useFormSubmissionModel from './useFormSubmissionModelContext'\nimport processInjectableOption from '../services/injectableOptions'\nimport useTaskContext from './useTaskContext'\nimport useUserProfileForInjectables from './useUserProfileForInjectables'\n\nexport default function useFormElementOptions<T>({\n  element,\n  value,\n  onChange,\n  conditionallyShownOptionsElement,\n  onFilter,\n  onUpdateFormElements,\n}: {\n  element: FormTypes.FormElementWithOptions\n  value: unknown | undefined\n  onChange: FormElementValueChangeHandler<T>\n  conditionallyShownOptionsElement:\n    | FormElementConditionallyShownElement\n    | undefined\n  onFilter?: (choiceElementOption: FormTypes.ChoiceElementOption) => boolean\n  onUpdateFormElements: UpdateFormElementsHandler\n}) {\n  const taskContext = useTaskContext()\n  const userProfileForInjectables = useUserProfileForInjectables()\n\n  const { formSubmissionModel, elements, parent } = useFormSubmissionModel()\n  const conditionallyShownOptions = conditionallyShownOptionsElement?.options\n  //options that are shown due to conditional logic\n  const shownOptions = React.useMemo<FormTypes.ChoiceElementOption[]>(() => {\n    if (!element.options) {\n      return []\n    }\n    if (!conditionallyShownOptions && !onFilter) {\n      return element.options\n    }\n    return element.options.filter((option) => {\n      return (\n        !conditionallyShownOptions ||\n        conditionallyShownOptions.some(({ id }) => id === option.id)\n      )\n    })\n  }, [conditionallyShownOptions, element.options, onFilter])\n\n  //\n  const withInjectedOptions = React.useMemo(() => {\n    return shownOptions.reduce<FormTypes.ChoiceElementOption[]>(\n      (memo, option) => {\n        const newOptions = processInjectableOption({\n          option,\n          submission: formSubmissionModel,\n          formElements: elements,\n          contextSubmission: parent?.formSubmissionModel || {},\n          contextElements: parent?.elements || [],\n          taskContext,\n          userProfile: userProfileForInjectables,\n        })\n        memo.push(...newOptions)\n\n        return memo\n      },\n      [],\n    )\n  }, [\n    elements,\n    formSubmissionModel,\n    parent,\n    shownOptions,\n    taskContext,\n    userProfileForInjectables,\n  ])\n\n  //options that are shown based on conditional logic, attributes, and user input\n  const filteredOptions = React.useMemo<FormTypes.ChoiceElementOption[]>(() => {\n    const reducedOptions = withInjectedOptions.filter(\n      (option) => !onFilter || (onFilter(option) && !option.displayAlways),\n    )\n    if (element.type === 'autocomplete') {\n      const alwaysShownOptions = withInjectedOptions.filter(\n        (option) => option.displayAlways,\n      )\n      reducedOptions.push(...alwaysShownOptions)\n    }\n    return reducedOptions\n  }, [withInjectedOptions, element.type, onFilter])\n\n  React.useEffect(() => {\n    if (\n      !element.options ||\n      conditionallyShownOptionsElement?.dependencyIsLoading\n    ) {\n      return\n    }\n\n    if (\n      typeof value === 'string' &&\n      !filteredOptions.some((option) => value === option.value)\n    ) {\n      onChange(element, {\n        value: undefined,\n        isDerivedChange: true,\n      })\n      return\n    }\n\n    if (Array.isArray(value)) {\n      const newValue = value.filter((selectedValue) =>\n        filteredOptions.some((option) => selectedValue === option.value),\n      )\n      if (newValue.length !== value.length) {\n        const newValueArray = newValue.length ? newValue : undefined\n        onChange(element, {\n          value: newValueArray as T | undefined,\n          isDerivedChange: true,\n        })\n      }\n    }\n  }, [\n    element,\n    onChange,\n    value,\n    conditionallyShownOptionsElement?.dependencyIsLoading,\n    filteredOptions,\n  ])\n\n  useLoadDynamicOptionsEffect(element, onUpdateFormElements)\n\n  return filteredOptions\n}\n"]}

package/dist/hooks/useFormIsDirty.d.ts

@@ -0,0 +1,38 @@
+import * as React from 'react';
+export declare function useMarkFormDirty(): () => void;
+export declare function FormMarkDirtyContextProvider({ markDirty, children, }: {
+    markDirty: () => void;
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Optional context that lets a host (for example Approvals) read whether a
+ * rendered form has unsaved user edits. Derived writes (`isDerivedChange`) do
+ * not set this.
+ *
+ * Wrap both the form and the host action so they share one registry. Each form
+ * registers under its `formId`, so multiple forms under the same provider (for
+ * example an approval form in a dialog) keep independent flags. If nothing is
+ * registered for a form, {@link useFormIsDirty} is `false`.
+ *
+ * @param props
+ * @returns
+ * @group Components
+ */
+export declare function FormIsDirtyContextProvider({ children, }: {
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Whether the form with `formId` has unsaved user edits. Safe to call without a
+ * provider: returns `false`.
+ *
+ * @param formId
+ * The id of the form whose dirty flag to read.
+ * @returns
+ * @group Hooks
+ */
+export declare function useFormIsDirty(formId: number): boolean;
+/**
+ * Registers this form’s unsaved-changes flag with the nearest
+ * {@link FormIsDirtyContextProvider}. Used internally by `OneBlinkFormBase`.
+ */
+export declare function useRegisterFormIsDirty(formId: number, isDirty: boolean): void;

package/dist/hooks/useFormIsDirty.js

@@ -0,0 +1,78 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as React from 'react';
+const emptyDirtyByFormId = new Map();
+const FormIsDirtyContext = React.createContext(emptyDirtyByFormId);
+// Kept separate from the value so registering does not re-render the form
+// every time the flag changes.
+const RegisterFormIsDirtyContext = React.createContext(undefined);
+const FormMarkDirtyContext = React.createContext(() => { });
+export function useMarkFormDirty() {
+    return React.useContext(FormMarkDirtyContext);
+}
+export function FormMarkDirtyContextProvider({ markDirty, children, }) {
+    return (_jsx(FormMarkDirtyContext.Provider, { value: markDirty, children: children }));
+}
+/**
+ * Optional context that lets a host (for example Approvals) read whether a
+ * rendered form has unsaved user edits. Derived writes (`isDerivedChange`) do
+ * not set this.
+ *
+ * Wrap both the form and the host action so they share one registry. Each form
+ * registers under its `formId`, so multiple forms under the same provider (for
+ * example an approval form in a dialog) keep independent flags. If nothing is
+ * registered for a form, {@link useFormIsDirty} is `false`.
+ *
+ * @param props
+ * @returns
+ * @group Components
+ */
+export function FormIsDirtyContextProvider({ children, }) {
+    // Must be state, not a ref. Hosts reading this are siblings of the form, so
+    // they only re-render if the context value itself changes.
+    const [isDirtyByFormId, setIsDirtyByFormId] = React.useState(() => new Map());
+    const register = React.useCallback((formId, isDirty) => {
+        setIsDirtyByFormId((current) => {
+            if (current.get(formId) === isDirty) {
+                return current;
+            }
+            const next = new Map(current);
+            next.set(formId, isDirty);
+            return next;
+        });
+        return () => {
+            setIsDirtyByFormId((current) => {
+                if (!current.has(formId)) {
+                    return current;
+                }
+                const next = new Map(current);
+                next.delete(formId);
+                return next;
+            });
+        };
+    }, []);
+    return (_jsx(RegisterFormIsDirtyContext.Provider, { value: register, children: _jsx(FormIsDirtyContext.Provider, { value: isDirtyByFormId, children: children }) }));
+}
+/**
+ * Whether the form with `formId` has unsaved user edits. Safe to call without a
+ * provider: returns `false`.
+ *
+ * @param formId
+ * The id of the form whose dirty flag to read.
+ * @returns
+ * @group Hooks
+ */
+export function useFormIsDirty(formId) {
+    var _a;
+    return (_a = React.useContext(FormIsDirtyContext).get(formId)) !== null && _a !== void 0 ? _a : false;
+}
+/**
+ * Registers this form’s unsaved-changes flag with the nearest
+ * {@link FormIsDirtyContextProvider}. Used internally by `OneBlinkFormBase`.
+ */
+export function useRegisterFormIsDirty(formId, isDirty) {
+    const register = React.useContext(RegisterFormIsDirtyContext);
+    React.useLayoutEffect(() => {
+        return register === null || register === void 0 ? void 0 : register(formId, isDirty);
+    }, [register, formId, isDirty]);
+}
+//# sourceMappingURL=useFormIsDirty.js.map

package/dist/hooks/useFormIsDirty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormIsDirty.js","sourceRoot":"","sources":["../../src/hooks/useFormIsDirty.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,MAAM,kBAAkB,GAAiC,IAAI,GAAG,EAAE,CAAA;AAElE,MAAM,kBAAkB,GACtB,KAAK,CAAC,aAAa,CAA+B,kBAAkB,CAAC,CAAA;AAEvE,0EAA0E;AAC1E,+BAA+B;AAC/B,MAAM,0BAA0B,GAAG,KAAK,CAAC,aAAa,CAEpD,SAAS,CAAC,CAAA;AAEZ,MAAM,oBAAoB,GAAG,KAAK,CAAC,aAAa,CAAa,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;AAEtE,MAAM,UAAU,gBAAgB;IAC9B,OAAO,KAAK,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAA;AAC/C,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,EAC3C,SAAS,EACT,QAAQ,GAIT;IACC,OAAO,CACL,KAAC,oBAAoB,CAAC,QAAQ,IAAC,KAAK,EAAE,SAAS,YAC5C,QAAQ,GACqB,CACjC,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,0BAA0B,CAAC,EACzC,QAAQ,GAGT;IACC,4EAA4E;IAC5E,2DAA2D;IAC3D,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAC1D,GAAG,EAAE,CAAC,IAAI,GAAG,EAAmB,CACjC,CAAA;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,MAAc,EAAE,OAAgB,EAAE,EAAE;QACtE,kBAAkB,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,OAAO,EAAE,CAAC;gBACpC,OAAO,OAAO,CAAA;YAChB,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAA;YAC7B,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;YACzB,OAAO,IAAI,CAAA;QACb,CAAC,CAAC,CAAA;QACF,OAAO,GAAG,EAAE;YACV,kBAAkB,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;oBACzB,OAAO,OAAO,CAAA;gBAChB,CAAC;gBACD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAA;gBAC7B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;gBACnB,OAAO,IAAI,CAAA;YACb,CAAC,CAAC,CAAA;QACJ,CAAC,CAAA;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO,CACL,KAAC,0BAA0B,CAAC,QAAQ,IAAC,KAAK,EAAE,QAAQ,YAClD,KAAC,kBAAkB,CAAC,QAAQ,IAAC,KAAK,EAAE,eAAe,YAChD,QAAQ,GACmB,GACM,CACvC,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;;IAC3C,OAAO,MAAA,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,mCAAI,KAAK,CAAA;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAc,EAAE,OAAgB;IACrE,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,0BAA0B,CAAC,CAAA;IAE7D,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE;QACzB,OAAO,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAG,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AACjC,CAAC","sourcesContent":["import * as React from 'react'\n\nconst emptyDirtyByFormId: ReadonlyMap<number, boolean> = new Map()\n\nconst FormIsDirtyContext =\n  React.createContext<ReadonlyMap<number, boolean>>(emptyDirtyByFormId)\n\n// Kept separate from the value so registering does not re-render the form\n// every time the flag changes.\nconst RegisterFormIsDirtyContext = React.createContext<\n  ((formId: number, isDirty: boolean) => () => void) | undefined\n>(undefined)\n\nconst FormMarkDirtyContext = React.createContext<() => void>(() => {})\n\nexport function useMarkFormDirty(): () => void {\n  return React.useContext(FormMarkDirtyContext)\n}\n\nexport function FormMarkDirtyContextProvider({\n  markDirty,\n  children,\n}: {\n  markDirty: () => void\n  children: React.ReactNode\n}) {\n  return (\n    <FormMarkDirtyContext.Provider value={markDirty}>\n      {children}\n    </FormMarkDirtyContext.Provider>\n  )\n}\n\n/**\n * Optional context that lets a host (for example Approvals) read whether a\n * rendered form has unsaved user edits. Derived writes (`isDerivedChange`) do\n * not set this.\n *\n * Wrap both the form and the host action so they share one registry. Each form\n * registers under its `formId`, so multiple forms under the same provider (for\n * example an approval form in a dialog) keep independent flags. If nothing is\n * registered for a form, {@link useFormIsDirty} is `false`.\n *\n * @param props\n * @returns\n * @group Components\n */\nexport function FormIsDirtyContextProvider({\n  children,\n}: {\n  children: React.ReactNode\n}) {\n  // Must be state, not a ref. Hosts reading this are siblings of the form, so\n  // they only re-render if the context value itself changes.\n  const [isDirtyByFormId, setIsDirtyByFormId] = React.useState(\n    () => new Map<number, boolean>(),\n  )\n\n  const register = React.useCallback((formId: number, isDirty: boolean) => {\n    setIsDirtyByFormId((current) => {\n      if (current.get(formId) === isDirty) {\n        return current\n      }\n      const next = new Map(current)\n      next.set(formId, isDirty)\n      return next\n    })\n    return () => {\n      setIsDirtyByFormId((current) => {\n        if (!current.has(formId)) {\n          return current\n        }\n        const next = new Map(current)\n        next.delete(formId)\n        return next\n      })\n    }\n  }, [])\n\n  return (\n    <RegisterFormIsDirtyContext.Provider value={register}>\n      <FormIsDirtyContext.Provider value={isDirtyByFormId}>\n        {children}\n      </FormIsDirtyContext.Provider>\n    </RegisterFormIsDirtyContext.Provider>\n  )\n}\n\n/**\n * Whether the form with `formId` has unsaved user edits. Safe to call without a\n * provider: returns `false`.\n *\n * @param formId\n * The id of the form whose dirty flag to read.\n * @returns\n * @group Hooks\n */\nexport function useFormIsDirty(formId: number): boolean {\n  return React.useContext(FormIsDirtyContext).get(formId) ?? false\n}\n\n/**\n * Registers this form’s unsaved-changes flag with the nearest\n * {@link FormIsDirtyContextProvider}. Used internally by `OneBlinkFormBase`.\n */\nexport function useRegisterFormIsDirty(formId: number, isDirty: boolean): void {\n  const register = React.useContext(RegisterFormIsDirtyContext)\n\n  React.useLayoutEffect(() => {\n    return register?.(formId, isDirty)\n  }, [register, formId, isDirty])\n}\n"]}

package/dist/hooks/useFormSubmissionAttempt.d.ts

@@ -0,0 +1,88 @@
+import * as React from 'react';
+/**
+ * Call after the host has successfully persisted the edits (for example after
+ * an approval upload). This clears the unsaved-changes navigation guard.
+ *
+ * Do not call it until that work has finished: cancelling a confirmation dialog
+ * after a successful attempt must still prompt if the user navigates away.
+ */
+export type FormSubmissionAttemptAllowNavigation = () => void;
+/**
+ * Runs the form’s existing submit-preparation path (validation, BSB checks,
+ * attachments, and the same error UI as a real submit).
+ *
+ * Resolves with {@link FormSubmissionAttemptAllowNavigation} when the host may
+ * continue (for example approve and upload an edit). Resolves `false` when
+ * preparation failed; field errors and toasts have already been shown. Does
+ * **not** call `onSubmit`, captcha, or analytics.
+ */
+export type FormSubmissionAttempt = () => Promise<false | FormSubmissionAttemptAllowNavigation>;
+/**
+ * Optional context that lets a host (for example Approvals) trigger the
+ * rendered form’s submit-preparation path without duplicating it.
+ *
+ * Wrap both the form and the host action (Approve) so they share one registry.
+ * `OneBlinkFormBase` registers when `editableFormElementIds` is set. If nothing
+ * is registered, {@link useFormSubmissionAttempt} still resolves with a no-op
+ * {@link FormSubmissionAttemptAllowNavigation} so hosts without an editable form
+ * are unchanged.
+ *
+ * #### Example
+ *
+ * ```jsx
+ * import {
+ *   FormSubmissionAttemptContextProvider,
+ *   OneBlinkReadOnlyForm,
+ *   useFormSubmissionAttempt,
+ * } from '@oneblink/apps-react'
+ *
+ * function ApproveButton() {
+ *   const attemptFormSubmission = useFormSubmissionAttempt()
+ *
+ *   const onClickApprove = async () => {
+ *     const allowNavigation = await attemptFormSubmission()
+ *     if (!allowNavigation) {
+ *       return
+ *     }
+ *     // continue with the host action, then:
+ *     allowNavigation()
+ *   }
+ *
+ *   return <button onClick={onClickApprove}>Approve</button>
+ * }
+ *
+ * function Approval() {
+ *   return (
+ *     <FormSubmissionAttemptContextProvider>
+ *       <OneBlinkReadOnlyForm editableFormElementIds={['element-id']} />
+ *       <ApproveButton />
+ *     </FormSubmissionAttemptContextProvider>
+ *   )
+ * }
+ * ```
+ *
+ * @param props
+ * @returns
+ * @group Components
+ */
+export declare function FormSubmissionAttemptContextProvider({ children, }: {
+    /** The form and the host action that must share one submission attempt. */
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Returns the latest form submission attempt registered under a
+ * {@link FormSubmissionAttemptContextProvider}. Safe to call without a provider:
+ * preparation is skipped and the promise resolves with a no-op
+ * {@link FormSubmissionAttemptAllowNavigation}.
+ *
+ * @returns
+ * @group Hooks
+ */
+export declare function useFormSubmissionAttempt(): FormSubmissionAttempt;
+/**
+ * Registers this form’s {@link FormSubmissionAttempt} with the nearest
+ * {@link FormSubmissionAttemptContextProvider}, if one exists. Used internally
+ * by `OneBlinkFormBase` when `editableFormElementIds` is provided. Pass
+ * `undefined` to skip registration (for example a fully read-only form).
+ */
+export declare function useRegisterFormSubmissionAttempt(attempt: FormSubmissionAttempt | undefined): void;

package/dist/hooks/useFormSubmissionAttempt.js

@@ -0,0 +1,103 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as React from 'react';
+const FormSubmissionAttemptContext = React.createContext(null);
+/**
+ * Optional context that lets a host (for example Approvals) trigger the
+ * rendered form’s submit-preparation path without duplicating it.
+ *
+ * Wrap both the form and the host action (Approve) so they share one registry.
+ * `OneBlinkFormBase` registers when `editableFormElementIds` is set. If nothing
+ * is registered, {@link useFormSubmissionAttempt} still resolves with a no-op
+ * {@link FormSubmissionAttemptAllowNavigation} so hosts without an editable form
+ * are unchanged.
+ *
+ * #### Example
+ *
+ * ```jsx
+ * import {
+ *   FormSubmissionAttemptContextProvider,
+ *   OneBlinkReadOnlyForm,
+ *   useFormSubmissionAttempt,
+ * } from '@oneblink/apps-react'
+ *
+ * function ApproveButton() {
+ *   const attemptFormSubmission = useFormSubmissionAttempt()
+ *
+ *   const onClickApprove = async () => {
+ *     const allowNavigation = await attemptFormSubmission()
+ *     if (!allowNavigation) {
+ *       return
+ *     }
+ *     // continue with the host action, then:
+ *     allowNavigation()
+ *   }
+ *
+ *   return <button onClick={onClickApprove}>Approve</button>
+ * }
+ *
+ * function Approval() {
+ *   return (
+ *     <FormSubmissionAttemptContextProvider>
+ *       <OneBlinkReadOnlyForm editableFormElementIds={['element-id']} />
+ *       <ApproveButton />
+ *     </FormSubmissionAttemptContextProvider>
+ *   )
+ * }
+ * ```
+ *
+ * @param props
+ * @returns
+ * @group Components
+ */
+export function FormSubmissionAttemptContextProvider({ children, }) {
+    const attemptsRef = React.useRef([]);
+    const register = React.useCallback((attempt) => {
+        attemptsRef.current.push(attempt);
+        return () => {
+            attemptsRef.current = attemptsRef.current.filter((registeredAttempt) => registeredAttempt !== attempt);
+        };
+    }, []);
+    const attempt = React.useCallback(() => {
+        var _a, _b;
+        const registeredAttempts = attemptsRef.current;
+        return ((_b = (_a = registeredAttempts[registeredAttempts.length - 1]) === null || _a === void 0 ? void 0 : _a.call(registeredAttempts)) !== null && _b !== void 0 ? _b : Promise.resolve(noopAllowNavigation));
+    }, []);
+    const value = React.useMemo(() => ({
+        register,
+        attempt,
+    }), [attempt, register]);
+    return (_jsx(FormSubmissionAttemptContext.Provider, { value: value, children: children }));
+}
+/**
+ * Returns the latest form submission attempt registered under a
+ * {@link FormSubmissionAttemptContextProvider}. Safe to call without a provider:
+ * preparation is skipped and the promise resolves with a no-op
+ * {@link FormSubmissionAttemptAllowNavigation}.
+ *
+ * @returns
+ * @group Hooks
+ */
+export function useFormSubmissionAttempt() {
+    var _a;
+    const context = React.useContext(FormSubmissionAttemptContext);
+    return (_a = context === null || context === void 0 ? void 0 : context.attempt) !== null && _a !== void 0 ? _a : allowSubmissionAttempt;
+}
+/**
+ * Registers this form’s {@link FormSubmissionAttempt} with the nearest
+ * {@link FormSubmissionAttemptContextProvider}, if one exists. Used internally
+ * by `OneBlinkFormBase` when `editableFormElementIds` is provided. Pass
+ * `undefined` to skip registration (for example a fully read-only form).
+ */
+export function useRegisterFormSubmissionAttempt(attempt) {
+    const context = React.useContext(FormSubmissionAttemptContext);
+    React.useLayoutEffect(() => {
+        if (attempt) {
+            return context === null || context === void 0 ? void 0 : context.register(attempt);
+        }
+    }, [attempt, context]);
+}
+function noopAllowNavigation() { }
+function allowSubmissionAttempt() {
+    return Promise.resolve(noopAllowNavigation);
+}
+//# sourceMappingURL=useFormSubmissionAttempt.js.map

package/dist/hooks/useFormSubmissionAttempt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormSubmissionAttempt.js","sourceRoot":"","sources":["../../src/hooks/useFormSubmissionAttempt.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AA6B9B,MAAM,4BAA4B,GAChC,KAAK,CAAC,aAAa,CAA2C,IAAI,CAAC,CAAA;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAM,UAAU,oCAAoC,CAAC,EACnD,QAAQ,GAIT;IACC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAA0B,EAAE,CAAC,CAAA;IAE7D,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,OAA8B,EAAE,EAAE;QACpE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACjC,OAAO,GAAG,EAAE;YACV,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAC9C,CAAC,iBAAiB,EAAE,EAAE,CAAC,iBAAiB,KAAK,OAAO,CACrD,CAAA;QACH,CAAC,CAAA;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,CAAwB,GAAG,EAAE;;QAC5D,MAAM,kBAAkB,GAAG,WAAW,CAAC,OAAO,CAAA;QAC9C,OAAO,CACL,MAAA,MAAA,kBAAkB,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC,kEAAI,mCACrD,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CACrC,CAAA;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CACzB,GAAG,EAAE,CAAC,CAAC;QACL,QAAQ;QACR,OAAO;KACR,CAAC,EACF,CAAC,OAAO,EAAE,QAAQ,CAAC,CACpB,CAAA;IAED,OAAO,CACL,KAAC,4BAA4B,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAChD,QAAQ,GAC6B,CACzC,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB;;IACtC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,4BAA4B,CAAC,CAAA;IAC9D,OAAO,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,mCAAI,sBAAsB,CAAA;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gCAAgC,CAC9C,OAA0C;IAE1C,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,4BAA4B,CAAC,CAAA;IAE9D,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE;QACzB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;QACnC,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;AACxB,CAAC;AAED,SAAS,mBAAmB,KAAI,CAAC;AAEjC,SAAS,sBAAsB;IAC7B,OAAO,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAA;AAC7C,CAAC","sourcesContent":["import * as React from 'react'\n\n/**\n * Call after the host has successfully persisted the edits (for example after\n * an approval upload). This clears the unsaved-changes navigation guard.\n *\n * Do not call it until that work has finished: cancelling a confirmation dialog\n * after a successful attempt must still prompt if the user navigates away.\n */\nexport type FormSubmissionAttemptAllowNavigation = () => void\n\n/**\n * Runs the form’s existing submit-preparation path (validation, BSB checks,\n * attachments, and the same error UI as a real submit).\n *\n * Resolves with {@link FormSubmissionAttemptAllowNavigation} when the host may\n * continue (for example approve and upload an edit). Resolves `false` when\n * preparation failed; field errors and toasts have already been shown. Does\n * **not** call `onSubmit`, captcha, or analytics.\n */\nexport type FormSubmissionAttempt = () => Promise<\n  false | FormSubmissionAttemptAllowNavigation\n>\n\ntype FormSubmissionAttemptContextValue = {\n  register: (attempt: FormSubmissionAttempt) => () => void\n  attempt: FormSubmissionAttempt\n}\n\nconst FormSubmissionAttemptContext =\n  React.createContext<FormSubmissionAttemptContextValue | null>(null)\n\n/**\n * Optional context that lets a host (for example Approvals) trigger the\n * rendered form’s submit-preparation path without duplicating it.\n *\n * Wrap both the form and the host action (Approve) so they share one registry.\n * `OneBlinkFormBase` registers when `editableFormElementIds` is set. If nothing\n * is registered, {@link useFormSubmissionAttempt} still resolves with a no-op\n * {@link FormSubmissionAttemptAllowNavigation} so hosts without an editable form\n * are unchanged.\n *\n * #### Example\n *\n * ```jsx\n * import {\n *   FormSubmissionAttemptContextProvider,\n *   OneBlinkReadOnlyForm,\n *   useFormSubmissionAttempt,\n * } from '@oneblink/apps-react'\n *\n * function ApproveButton() {\n *   const attemptFormSubmission = useFormSubmissionAttempt()\n *\n *   const onClickApprove = async () => {\n *     const allowNavigation = await attemptFormSubmission()\n *     if (!allowNavigation) {\n *       return\n *     }\n *     // continue with the host action, then:\n *     allowNavigation()\n *   }\n *\n *   return <button onClick={onClickApprove}>Approve</button>\n * }\n *\n * function Approval() {\n *   return (\n *     <FormSubmissionAttemptContextProvider>\n *       <OneBlinkReadOnlyForm editableFormElementIds={['element-id']} />\n *       <ApproveButton />\n *     </FormSubmissionAttemptContextProvider>\n *   )\n * }\n * ```\n *\n * @param props\n * @returns\n * @group Components\n */\nexport function FormSubmissionAttemptContextProvider({\n  children,\n}: {\n  /** The form and the host action that must share one submission attempt. */\n  children: React.ReactNode\n}) {\n  const attemptsRef = React.useRef<FormSubmissionAttempt[]>([])\n\n  const register = React.useCallback((attempt: FormSubmissionAttempt) => {\n    attemptsRef.current.push(attempt)\n    return () => {\n      attemptsRef.current = attemptsRef.current.filter(\n        (registeredAttempt) => registeredAttempt !== attempt,\n      )\n    }\n  }, [])\n\n  const attempt = React.useCallback<FormSubmissionAttempt>(() => {\n    const registeredAttempts = attemptsRef.current\n    return (\n      registeredAttempts[registeredAttempts.length - 1]?.() ??\n      Promise.resolve(noopAllowNavigation)\n    )\n  }, [])\n\n  const value = React.useMemo(\n    () => ({\n      register,\n      attempt,\n    }),\n    [attempt, register],\n  )\n\n  return (\n    <FormSubmissionAttemptContext.Provider value={value}>\n      {children}\n    </FormSubmissionAttemptContext.Provider>\n  )\n}\n\n/**\n * Returns the latest form submission attempt registered under a\n * {@link FormSubmissionAttemptContextProvider}. Safe to call without a provider:\n * preparation is skipped and the promise resolves with a no-op\n * {@link FormSubmissionAttemptAllowNavigation}.\n *\n * @returns\n * @group Hooks\n */\nexport function useFormSubmissionAttempt(): FormSubmissionAttempt {\n  const context = React.useContext(FormSubmissionAttemptContext)\n  return context?.attempt ?? allowSubmissionAttempt\n}\n\n/**\n * Registers this form’s {@link FormSubmissionAttempt} with the nearest\n * {@link FormSubmissionAttemptContextProvider}, if one exists. Used internally\n * by `OneBlinkFormBase` when `editableFormElementIds` is provided. Pass\n * `undefined` to skip registration (for example a fully read-only form).\n */\nexport function useRegisterFormSubmissionAttempt(\n  attempt: FormSubmissionAttempt | undefined,\n): void {\n  const context = React.useContext(FormSubmissionAttemptContext)\n\n  React.useLayoutEffect(() => {\n    if (attempt) {\n      return context?.register(attempt)\n    }\n  }, [attempt, context])\n}\n\nfunction noopAllowNavigation() {}\n\nfunction allowSubmissionAttempt(): Promise<FormSubmissionAttemptAllowNavigation> {\n  return Promise.resolve(noopAllowNavigation)\n}\n"]}

package/dist/hooks/useFormSubmissionAutoSaveState.d.ts

@@ -1,7 +1,6 @@
-import * as React from 'react';
 import { submissionService } from '../apps';
 import { FormTypes, SubmissionTypes } from '@oneblink/types';
-import { SectionState } from '../types/form';
+import { SectionState, SetFormSubmission } from '../types/form';
 /**
  * Use this if you want to implement a controlled auto saving form. See
  * {@link OneBlinkFormControlled} for a full example. If you do not need to
@@ -44,12 +43,6 @@ export default function useFormSubmissionAutoSaveState({ form, initialSubmission
     handleCancel: () => void;
     handleSaveDraft: ((newDraftSubmission: submissionService.NewDraftSubmission) => void) | undefined;
     handleNavigateAway: () => void;
-    setFormSubmission: React.Dispatch<React.SetStateAction<{
-        definition: FormTypes.Form;
-        submission: SubmissionTypes.S3SubmissionData["submission"];
-        lastElementUpdated: FormTypes.FormElement | undefined;
-        executedLookups: import("../types/form").ExecutedLookups;
-        sectionState: SectionState | undefined;
-    }>>;
+    setFormSubmission: SetFormSubmission;
     getCurrentSubmissionDuration: () => number;
 };

package/dist/hooks/useFormSubmissionAutoSaveState.js

@@ -158,12 +158,14 @@ export default function useFormSubmissionAutoSaveState({ form, initialSubmission
             cancelAutoSave();
         };
     }, [cancelAutoSave]);
-    const setFormSubmissionAutoSave = React.useCallback((formSubmission) => {
+    const setFormSubmissionAutoSave = React.useCallback((formSubmission, options) => {
         setFormSubmission((currentFormSubmission) => {
             const newFormSubmission = typeof formSubmission === 'function'
                 ? formSubmission(currentFormSubmission)
                 : formSubmission;
-            throttledAutoSave(newFormSubmission.submission, newFormSubmission.lastElementUpdated, newFormSubmission.sectionState);
+            if (!(options === null || options === void 0 ? void 0 : options.isDerivedChange)) {
+                throttledAutoSave(newFormSubmission.submission, newFormSubmission.lastElementUpdated, newFormSubmission.sectionState);
+            }
             return newFormSubmission;
         });
     }, [setFormSubmission, throttledAutoSave]);