@aehrc/smart-forms-renderer 0.23.1 → 0.24.1

package/src/utils/getExpressionsFromItem.ts

@@ -0,0 +1,96 @@
+/*
+ * Copyright 2024 Commonwealth Scientific and Industrial Research
+ * Organisation (CSIRO) ABN 41 687 119 230.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import type { Expression, Extension, QuestionnaireItem } from 'fhir/r4';
+import type { CalculatedExpression } from '../interfaces/calculatedExpression.interface';
+
+/**
+ * Get enableWhenExpression.valueExpression if its present in item
+ *
+ * @author Sean Fong
+ */
+export function getEnableWhenExpression(qItem: QuestionnaireItem): Expression | null {
+  const enableWhenExpression = qItem.extension?.find(
+    (extension: Extension) =>
+      extension.url ===
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-enableWhenExpression' &&
+      extension.valueExpression?.language === 'text/fhirpath'
+  );
+
+  if (enableWhenExpression?.valueExpression) {
+    return enableWhenExpression.valueExpression;
+  }
+  return null;
+}
+
+/**
+ * Get calculatedExpression.valueExpression if its present in item or item._text
+ *
+ * @author Sean Fong
+ */
+export function getCalculatedExpressions(qItem: QuestionnaireItem): CalculatedExpression[] {
+  const calculatedExpressionsInItem = findCalculatedExpressionsInExtensions(qItem.extension ?? [])
+    .map(
+      (calculatedExpression): CalculatedExpression => ({
+        expression: calculatedExpression.valueExpression?.expression ?? '',
+        from: 'item'
+      })
+    )
+    .filter((calculatedExpression) => calculatedExpression.expression !== '');
+
+  const calculatedExpressionsInText = findCalculatedExpressionsInExtensions(
+    qItem._text?.extension ?? []
+  )
+    .map(
+      (calculatedExpression): CalculatedExpression => ({
+        expression: calculatedExpression.valueExpression?.expression ?? '',
+        from: 'item._text'
+      })
+    )
+    .filter((calculatedExpression) => calculatedExpression.expression !== '');
+
+  return [...calculatedExpressionsInItem, ...calculatedExpressionsInText];
+}
+
+function findCalculatedExpressionsInExtensions(extensions: Extension[]): Extension[] {
+  return extensions.filter(
+    (extension) =>
+      extension.url ===
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-calculatedExpression' &&
+      extension.valueExpression?.language === 'text/fhirpath'
+  );
+}
+
+/**
+ * Get answerExpression.valueExpression if its present in item
+ *
+ * @author Sean Fong
+ */
+export function getAnswerExpression(qItem: QuestionnaireItem): Expression | null {
+  const itemControl = qItem.extension?.find(
+    (extension: Extension) =>
+      extension.url ===
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-answerExpression' &&
+      extension.valueExpression?.language === 'text/fhirpath'
+  );
+  if (itemControl) {
+    if (itemControl.valueExpression) {
+      return itemControl.valueExpression;
+    }
+  }
+  return null;
+}

package/src/utils/initialise.ts

@@ -316,7 +316,7 @@ export interface initialFormFromResponseParams {
   questionnaireResponse: QuestionnaireResponse;
   enableWhenItems: EnableWhenItems;
   enableWhenExpressions: EnableWhenExpressions;
-  calculatedExpressions: Record<string, CalculatedExpression>;
+  calculatedExpressions: Record<string, CalculatedExpression[]>;
   variablesFhirPath: Record<string, Expression[]>;
   tabs: Tabs;
   fhirPathContext: Record<string, any>;
@@ -326,7 +326,7 @@ export function initialiseFormFromResponse(params: initialFormFromResponseParams
   initialEnableWhenItems: EnableWhenItems;
   initialEnableWhenLinkedQuestions: Record<string, string[]>;
   initialEnableWhenExpressions: EnableWhenExpressions;
-  initialCalculatedExpressions: Record<string, CalculatedExpression>;
+  initialCalculatedExpressions: Record<string, CalculatedExpression[]>;
   firstVisibleTab: number;
   updatedFhirPathContext: Record<string, any>;
 } {

package/src/utils/itemControl.ts

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-import type { Coding, Expression, Extension, QuestionnaireItem } from 'fhir/r4';
+import type { Coding, Extension, QuestionnaireItem } from 'fhir/r4';
 import type { RegexValidation } from '../interfaces/regex.interface';
 import { structuredDataCapture } from 'fhir-sdc-helpers';
 
@@ -101,26 +101,6 @@ export function hasHiddenExtension(qItem: QuestionnaireItem): boolean {
   return false;
 }
 
-/**
- * Check if an answerExpression extension is present
- *
- * @author Sean Fong
- */
-export function getAnswerExpression(qItem: QuestionnaireItem): Expression | null {
-  const itemControl = qItem.extension?.find(
-    (extension: Extension) =>
-      extension.url ===
-        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-answerExpression' &&
-      extension.valueExpression?.language === 'text/fhirpath'
-  );
-  if (itemControl) {
-    if (itemControl.valueExpression) {
-      return itemControl.valueExpression;
-    }
-  }
-  return null;
-}
-
 /**
  * Check if the extension has url for items that use open label
  *

package/src/utils/questionnaireStoreUtils/extractOtherExtensions.ts

@@ -17,7 +17,6 @@
 
 import type {
   Expression,
-  Extension,
   Questionnaire,
   QuestionnaireItem,
   QuestionnaireItemEnableWhen
@@ -35,7 +34,6 @@ import type {
 } from '../../interfaces';
 import type { AnswerExpression } from '../../interfaces/answerExpression.interface';
 import type { ValueSetPromise } from '../../interfaces/valueSet.interface';
-import { getAnswerExpression } from '../itemControl';
 import { getTerminologyServerUrl, getValueSetPromise } from '../valueSet';
 import type { Variables } from '../../interfaces/variables.interface';
 import { getFhirPathVariables, getXFhirQueryVariables } from './extractVariables';
@@ -44,12 +42,17 @@ import { checkItemIsEnabledRepeat } from '../enableWhen';
 import cloneDeep from 'lodash.clonedeep';
 import { emptyResponse } from '../emptyResource';
 import { evaluateEnableWhenRepeatExpressionInstance } from '../enableWhenExpression';
+import {
+  getAnswerExpression,
+  getCalculatedExpressions,
+  getEnableWhenExpression
+} from '../getExpressionsFromItem';
 
 interface ReturnParamsRecursive {
   variables: Variables;
   enableWhenItems: EnableWhenItems;
   enableWhenExpressions: EnableWhenExpressions;
-  calculatedExpressions: Record<string, CalculatedExpression>;
+  calculatedExpressions: Record<string, CalculatedExpression[]>;
   answerExpressions: Record<string, AnswerExpression>;
   valueSetPromises: Record<string, ValueSetPromise>;
 }
@@ -65,7 +68,7 @@ export function extractOtherExtensions(
     singleExpressions: {},
     repeatExpressions: {}
   };
-  const calculatedExpressions: Record<string, CalculatedExpression> = {};
+  const calculatedExpressions: Record<string, CalculatedExpression[]> = {};
   const answerExpressions: Record<string, AnswerExpression> = {};
 
   if (!questionnaire.item || questionnaire.item.length === 0) {
@@ -114,7 +117,7 @@ interface extractExtensionsFromItemRecursiveParams {
   variables: Variables;
   enableWhenItems: EnableWhenItems;
   enableWhenExpressions: EnableWhenExpressions;
-  calculatedExpressions: Record<string, CalculatedExpression>;
+  calculatedExpressions: Record<string, CalculatedExpression[]>;
   answerExpressions: Record<string, AnswerExpression>;
   valueSetPromises: Record<string, ValueSetPromise>;
   defaultTerminologyServerUrl: string;
@@ -184,13 +187,13 @@ function extractExtensionsFromItemRecursive(
     }
   }
 
-  const calculatedExpression = getCalculatedExpression(item);
-  if (calculatedExpression) {
-    calculatedExpressions[item.linkId] = {
-      expression: `${calculatedExpression.expression}`
-    };
+  // Get calculatedExpressions
+  const calculatedExpressionsOfItem = getCalculatedExpressions(item);
+  if (calculatedExpressionsOfItem.length > 0) {
+    calculatedExpressions[item.linkId] = calculatedExpressionsOfItem;
   }
 
+  // Get answerExpressions
   const answerExpression = getAnswerExpression(item);
   if (answerExpression) {
     answerExpressions[item.linkId] = {
@@ -417,43 +420,3 @@ function initialiseEnableWhenExpression(
     }
   };
 }
-
-/**
- * Check if an enableWhenExpression extension is present
- *
- * @author Sean Fong
- */
-export function getEnableWhenExpression(qItem: QuestionnaireItem): Expression | null {
-  const itemControl = qItem.extension?.find(
-    (extension: Extension) =>
-      extension.url ===
-        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-enableWhenExpression' &&
-      extension.valueExpression?.language === 'text/fhirpath'
-  );
-  if (itemControl) {
-    if (itemControl.valueExpression) {
-      return itemControl.valueExpression;
-    }
-  }
-  return null;
-}
-
-/**
- * Check if an calculatedExpression extension is present
- *
- * @author Sean Fong
- */
-export function getCalculatedExpression(qItem: QuestionnaireItem): Expression | null {
-  const itemControl = qItem.extension?.find(
-    (extension: Extension) =>
-      extension.url ===
-        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-calculatedExpression' &&
-      extension.valueExpression?.language === 'text/fhirpath'
-  );
-  if (itemControl) {
-    if (itemControl.valueExpression) {
-      return itemControl.valueExpression;
-    }
-  }
-  return null;
-}

package/src/utils/removeEmptyAnswers.ts

@@ -184,6 +184,10 @@ function answerIsEmpty(
     return true;
   }
 
+  if (qrItem.answer.length === 0) {
+    return true;
+  }
+
   if (qrItem.answer[0]?.valueString === '') {
     return true;
   }