@aehrc/smart-forms-renderer 0.2.0 → 0.4.0

package/src/utils/populateInputParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"populateInputParams.js","sourceRoot":"","sources":["populateInputParams.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAmBH,SAAS,oBAAoB,CAAC,aAA4B,EAAE,OAAgB;IAC1E,MAAM,YAAY,GAAG,aAAa,CAAC,WAAW,CAAC;IAE/C,sHAAsH;IACtH,IAAI,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE;QAC3C,MAAM,cAAc,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC;QAC7E,IAAI,CAAC,cAAc,EAAE;YACnB,OAAO,IAAI,CAAC;SACb;KACF;IAED,OAAO;QACL,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,EAAE;KACnC,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,YAAoB;IAChD,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,YAAY;KAC1B,CAAC;AACJ,CAAC;AAED,iGAAiG;AACjG,wEAAwE;AACxE,SAAS,gBAAgB;IACvB,OAAO;QACL,IAAI,EAAE,OAAO;QACb,YAAY,EAAE,KAAK;KACpB,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAC/B,aAA4B,EAC5B,OAAgB,EAChB,IAAkB,EAClB,SAA2B;;IAE3B,MAAM,IAAI,GAAG,MAAA,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,mCAAI,MAAA,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,0CAAE,IAAI,CAAC;IAChG,IAAI,CAAC,IAAI,EAAE;QACT,OAAO,IAAI,CAAC;KACb;IAED,uBAAuB;IACvB,MAAM,YAAY,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1D,IAAI,QAA6B,CAAC;IAClC,QAAQ,YAAY,EAAE;QACpB,KAAK,SAAS;YACZ,QAAQ,GAAG,OAAO,CAAC;YACnB,MAAM;QACR,KAAK,cAAc;YACjB,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM;QACR,KAAK,WAAW;YACd,QAAQ,GAAG,SAAS,CAAC;YACrB,MAAM;QACR;YACE,OAAO,IAAI,CAAC;KACf;IAED,IAAI,CAAC,QAAQ,EAAE;QACb,OAAO,IAAI,CAAC;KACb;IAED,OAAO;QACL,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ;gBACE,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,IAAI;aAClB;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,QAAQ;aACnB;SACF;KACF,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,WAAwB,EAAE,KAAa;IACtE,MAAM,SAAS,GAAG,WAAW,CAAC,cAAc,CAAC,SAAS,CAAC;IACvD,IAAI,SAAS,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;QAC1C,MAAM,kBAAkB,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9C,OAAO;YACL,IAAI,EAAE,SAAS;YACf,IAAI,EAAE;gBACJ;oBACE,IAAI,EAAE,MAAM;oBACZ,WAAW,EAAE,kBAAkB;iBAChC;gBACD;oBACE,IAAI,EAAE,SAAS;oBACf,cAAc,EAAE,WAAW,CAAC,cAAc;iBAC3C;aACF;SACF,CAAC;KACH;IAED,wFAAwF;IACxF,oCAAoC;IACpC,OAAO;QACL,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ;gBACE,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,cAAc,KAAK,EAAE;aACnC;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,cAAc,EAAE,WAAW,CAAC,cAAc;aAC3C;SACF;KACF,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,QAA8C;IACzE,MAAM,KAAK,GAAG,QAAQ,CAAC,eAAe,CAAC,UAAU,CAAC;IAClD,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzC,OAAO;QACL,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ;gBACE,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,QAAQ,CAAC,eAAe,CAAC,IAAI;aAC3C;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,cAAc,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE;aACzD;SACF;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAC3C,aAA4B,EAC5B,OAAgB,EAChB,IAAkB,EAClB,SAA2B,EAC3B,cAA+B,EAC/B,aAA4B,EAC5B,2BAAmE;;IAEnE,MAAM,cAAc,GAAG,oBAAoB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACpE,IAAI,CAAC,cAAc,EAAE;QACnB,OAAO,IAAI,CAAC;KACb;IAED,MAAM,eAAe,GAAe;QAClC,YAAY,EAAE,YAAY;QAC1B,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,eAAe;gBACrB,QAAQ,EAAE,aAAa;aACxB;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,cAAc,EAAE,cAAc;aAC/B;SACF;KACF,CAAC;IAEF,YAAY;IACZ,IAAI,aAAa,CAAC,GAAG,EAAE;QACrB,MAAA,eAAe,CAAC,SAAS,0CAAE,IAAI,CAAC,oBAAoB,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;KAC1E;IAED,WAAW;IACX,MAAM,QAAQ,GAA0B,EAAE,CAAC;IAC3C,sBAAsB;IACtB,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE;QAC7B,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE;YAC1C,MAAM,kBAAkB,GAAG,wBAAwB,CAAC,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;YAC7F,IAAI,kBAAkB,EAAE;gBACtB,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;aACnC;SACF;KACF;IAED,qBAAqB;IACrB,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE;QAC5B,KAAK,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,aAAa,CAAC,OAAO,EAAE,EAAE;YAC1D,QAAQ,CAAC,IAAI,CAAC,uBAAuB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;SAC5D;KACF;IAED,oCAAoC;IACpC,IAAI,2BAA2B,CAAC,MAAM,GAAG,CAAC,EAAE;QAC1C,KAAK,MAAM,QAAQ,IAAI,2BAA2B,EAAE;YAClD,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;SAC9C;KACF;IAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE;QACvB,MAAA,eAAe,CAAC,SAAS,0CAAE,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;KAC9C;IAED,QAAQ;IACR,MAAA,eAAe,CAAC,SAAS,0CAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAEpD,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/src/utils/populateInputParams.ts

@@ -0,0 +1,242 @@
+/*
+ * Copyright 2023 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.
+ */
+
+// If none are specified, then the subject is unlimited.
+import type {
+  Encounter,
+  FhirResource,
+  Parameters,
+  ParametersParameter,
+  Patient,
+  Practitioner,
+  Questionnaire,
+  Reference
+} from 'fhir/r4';
+import type {
+  LaunchContext,
+  QuestionnaireLevelXFhirQueryVariable,
+  SourceQuery
+} from '../interfaces/populate.interface';
+
+function createPatientSubject(questionnaire: Questionnaire, patient: Patient): Reference | null {
+  const subjectTypes = questionnaire.subjectType;
+
+  // If subjectTypes array is not empty AND "Patient" is not in the array, we cannot create a Patient subject reference.
+  if (subjectTypes && subjectTypes.length > 0) {
+    const patientSubject = subjectTypes.find((subject) => subject === 'Patient');
+    if (!patientSubject) {
+      return null;
+    }
+  }
+
+  return {
+    type: 'Patient',
+    reference: 'Patient/' + patient.id
+  };
+}
+
+function createCanonicalParam(canonicalUrl: string): ParametersParameter {
+  return {
+    name: 'canonical',
+    valueString: canonicalUrl
+  };
+}
+
+// setting local parameter as false as we are calling $populate with an NPM package, not a server
+// package doesn't contain any fhir resources to "know" the context from
+function createLocalParam(): ParametersParameter {
+  return {
+    name: 'local',
+    valueBoolean: false
+  };
+}
+
+function createLaunchContextParam(
+  launchContext: LaunchContext,
+  patient: Patient,
+  user: Practitioner,
+  encounter: Encounter | null
+): ParametersParameter | null {
+  const name = launchContext.extension[0].valueId ?? launchContext.extension[0].valueCoding?.code;
+  if (!name) {
+    return null;
+  }
+
+  // let resource :string
+  const resourceType = launchContext.extension[1].valueCode;
+  let resource: FhirResource | null;
+  switch (resourceType) {
+    case 'Patient':
+      resource = patient;
+      break;
+    case 'Practitioner':
+      resource = user;
+      break;
+    case 'Encounter':
+      resource = encounter;
+      break;
+    default:
+      return null;
+  }
+
+  if (!resource) {
+    return null;
+  }
+
+  return {
+    name: 'context',
+    part: [
+      {
+        name: 'name',
+        valueString: name
+      },
+      {
+        name: 'content',
+        resource: resource
+      }
+    ]
+  };
+}
+
+function createSourceQueryParams(sourceQuery: SourceQuery, index: number): ParametersParameter {
+  const reference = sourceQuery.valueReference.reference;
+  if (reference && reference.startsWith('#')) {
+    const containedReference = reference.slice(1);
+    return {
+      name: 'context',
+      part: [
+        {
+          name: 'name',
+          valueString: containedReference
+        },
+        {
+          name: 'content',
+          valueReference: sourceQuery.valueReference
+        }
+      ]
+    };
+  }
+
+  // if sourceQuery cannot be referenced to a contained bundle, return itself as a context
+  // this most likely shouldn't happen
+  return {
+    name: 'context',
+    part: [
+      {
+        name: 'name',
+        valueString: `sourceQuery${index}`
+      },
+      {
+        name: 'content',
+        valueReference: sourceQuery.valueReference
+      }
+    ]
+  };
+}
+
+function createVariableParam(variable: QuestionnaireLevelXFhirQueryVariable): ParametersParameter {
+  const query = variable.valueExpression.expression;
+  const resourceType = query.split('?')[0];
+
+  return {
+    name: 'context',
+    part: [
+      {
+        name: 'name',
+        valueString: variable.valueExpression.name
+      },
+      {
+        name: 'content',
+        valueReference: { reference: query, type: resourceType }
+      }
+    ]
+  };
+}
+
+/**
+ * Define population input parameters without any batch response contexts
+ *
+ * @author Sean Fong
+ */
+export function createPopulateInputParameters(
+  questionnaire: Questionnaire,
+  patient: Patient,
+  user: Practitioner,
+  encounter: Encounter | null,
+  launchContexts: LaunchContext[],
+  sourceQueries: SourceQuery[],
+  questionnaireLevelVariables: QuestionnaireLevelXFhirQueryVariable[]
+): Parameters | null {
+  const patientSubject = createPatientSubject(questionnaire, patient);
+  if (!patientSubject) {
+    return null;
+  }
+
+  const inputParameters: Parameters = {
+    resourceType: 'Parameters',
+    parameter: [
+      {
+        name: 'questionnaire',
+        resource: questionnaire
+      },
+      {
+        name: 'subject',
+        valueReference: patientSubject
+      }
+    ]
+  };
+
+  // canonical
+  if (questionnaire.url) {
+    inputParameters.parameter?.push(createCanonicalParam(questionnaire.url));
+  }
+
+  // contexts
+  const contexts: ParametersParameter[] = [];
+  // add launch contexts
+  if (launchContexts.length > 0) {
+    for (const launchContext of launchContexts) {
+      const launchContextParam = createLaunchContextParam(launchContext, patient, user, encounter);
+      if (launchContextParam) {
+        contexts.push(launchContextParam);
+      }
+    }
+  }
+
+  // add source queries
+  if (sourceQueries.length > 0) {
+    for (const [index, sourceQuery] of sourceQueries.entries()) {
+      contexts.push(createSourceQueryParams(sourceQuery, index));
+    }
+  }
+
+  // add questionnaire-level variables
+  if (questionnaireLevelVariables.length > 0) {
+    for (const variable of questionnaireLevelVariables) {
+      contexts.push(createVariableParam(variable));
+    }
+  }
+
+  if (contexts.length > 0) {
+    inputParameters.parameter?.push(...contexts);
+  }
+
+  // local
+  inputParameters.parameter?.push(createLocalParam());
+
+  return inputParameters;
+}

package/src/utils/qItem.js

@@ -0,0 +1,73 @@
+/*
+ * Copyright 2023 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 { hasHiddenExtension } from './itemControl';
+import { getChoiceControlType } from './choice';
+import { QItemChoiceControl, QItemOpenChoiceControl } from '../interfaces/choice.enum';
+import { getOpenChoiceControlType } from './openChoice';
+/**
+ * Test the given QItem on a series of checks to verify if the item should be displayed
+ * Check if qItem has hidden attribute
+ * Check if qItem fufilled its enableWhen criteria
+ *
+ * @author Sean Fong
+ */
+export function isHidden(params) {
+    const { questionnaireItem, enableWhenIsActivated, enableWhenItems, enableWhenExpressions } = params;
+    if (hasHiddenExtension(questionnaireItem)) {
+        return true;
+    }
+    return isHiddenByEnableWhens({
+        linkId: questionnaireItem.linkId,
+        enableWhenIsActivated,
+        enableWhenItems,
+        enableWhenExpressions
+    });
+}
+export function isHiddenByEnableWhens(params) {
+    const { linkId, enableWhenIsActivated, enableWhenItems, enableWhenExpressions } = params;
+    if (enableWhenIsActivated) {
+        if (enableWhenItems[linkId]) {
+            return !enableWhenItems[linkId].isEnabled;
+        }
+        if (enableWhenExpressions[linkId]) {
+            return !enableWhenExpressions[linkId].isEnabled;
+        }
+    }
+    return false;
+}
+/**
+ * Check if qItem is a repeat item AND if it isn't a checkbox item
+ * Note: repeat checkbox items are rendered as multi-select checkbox instead of being rendered as a traditional repeat item
+ *
+ * @author Sean Fong
+ */
+export function isRepeatItemAndNotCheckbox(qItem) {
+    const isCheckbox = getChoiceControlType(qItem) === QItemChoiceControl.Checkbox ||
+        getOpenChoiceControlType(qItem) === QItemOpenChoiceControl.Checkbox;
+    return !!qItem['repeats'] && !isCheckbox;
+}
+export function getXHtmlStringFromQuestionnaire(questionnaire) {
+    var _a, _b;
+    const itemControl = (_b = (_a = questionnaire._title) === null || _a === void 0 ? void 0 : _a.extension) === null || _b === void 0 ? void 0 : _b.find((extension) => extension.url === 'http://hl7.org/fhir/StructureDefinition/rendering-xhtml');
+    if (itemControl) {
+        if (itemControl.valueString) {
+            return itemControl.valueString;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=qItem.js.map

package/src/utils/qItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qItem.js","sourceRoot":"","sources":["qItem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAUxD;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAsB;IAC7C,MAAM,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,eAAe,EAAE,qBAAqB,EAAE,GACxF,MAAM,CAAC;IACT,IAAI,kBAAkB,CAAC,iBAAiB,CAAC,EAAE;QACzC,OAAO,IAAI,CAAC;KACb;IAED,OAAO,qBAAqB,CAAC;QAC3B,MAAM,EAAE,iBAAiB,CAAC,MAAM;QAChC,qBAAqB;QACrB,eAAe;QACf,qBAAqB;KACtB,CAAC,CAAC;AACL,CAAC;AASD,MAAM,UAAU,qBAAqB,CAAC,MAAmC;IACvE,MAAM,EAAE,MAAM,EAAE,qBAAqB,EAAE,eAAe,EAAE,qBAAqB,EAAE,GAAG,MAAM,CAAC;IAEzF,IAAI,qBAAqB,EAAE;QACzB,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE;YAC3B,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC;SAC3C;QAED,IAAI,qBAAqB,CAAC,MAAM,CAAC,EAAE;YACjC,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC;SACjD;KACF;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAwB;IACjE,MAAM,UAAU,GACd,oBAAoB,CAAC,KAAK,CAAC,KAAK,kBAAkB,CAAC,QAAQ;QAC3D,wBAAwB,CAAC,KAAK,CAAC,KAAK,sBAAsB,CAAC,QAAQ,CAAC;IAEtE,OAAO,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,aAA4B;;IAC1E,MAAM,WAAW,GAAG,MAAA,MAAA,aAAa,CAAC,MAAM,0CAAE,SAAS,0CAAE,IAAI,CACvD,CAAC,SAAoB,EAAE,EAAE,CACvB,SAAS,CAAC,GAAG,KAAK,yDAAyD,CAC9E,CAAC;IAEF,IAAI,WAAW,EAAE;QACf,IAAI,WAAW,CAAC,WAAW,EAAE;YAC3B,OAAO,WAAW,CAAC,WAAW,CAAC;SAChC;KACF;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/src/utils/qItem.ts

@@ -0,0 +1,103 @@
+/*
+ * Copyright 2023 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 { Extension, Questionnaire, QuestionnaireItem } from 'fhir/r4';
+import { hasHiddenExtension } from './itemControl';
+import { getChoiceControlType } from './choice';
+import { QItemChoiceControl, QItemOpenChoiceControl } from '../interfaces/choice.enum';
+import { getOpenChoiceControlType } from './openChoice';
+import type { EnableWhenExpression, EnableWhenItems } from '../interfaces/enableWhen.interface';
+
+interface isHiddenParams {
+  questionnaireItem: QuestionnaireItem;
+  enableWhenIsActivated: boolean;
+  enableWhenItems: EnableWhenItems;
+  enableWhenExpressions: Record<string, EnableWhenExpression>;
+}
+
+/**
+ * Test the given QItem on a series of checks to verify if the item should be displayed
+ * Check if qItem has hidden attribute
+ * Check if qItem fufilled its enableWhen criteria
+ *
+ * @author Sean Fong
+ */
+export function isHidden(params: isHiddenParams): boolean {
+  const { questionnaireItem, enableWhenIsActivated, enableWhenItems, enableWhenExpressions } =
+    params;
+  if (hasHiddenExtension(questionnaireItem)) {
+    return true;
+  }
+
+  return isHiddenByEnableWhens({
+    linkId: questionnaireItem.linkId,
+    enableWhenIsActivated,
+    enableWhenItems,
+    enableWhenExpressions
+  });
+}
+
+interface isHiddenByEnableWhensParams {
+  linkId: string;
+  enableWhenIsActivated: boolean;
+  enableWhenItems: EnableWhenItems;
+  enableWhenExpressions: Record<string, EnableWhenExpression>;
+}
+
+export function isHiddenByEnableWhens(params: isHiddenByEnableWhensParams): boolean {
+  const { linkId, enableWhenIsActivated, enableWhenItems, enableWhenExpressions } = params;
+
+  if (enableWhenIsActivated) {
+    if (enableWhenItems[linkId]) {
+      return !enableWhenItems[linkId].isEnabled;
+    }
+
+    if (enableWhenExpressions[linkId]) {
+      return !enableWhenExpressions[linkId].isEnabled;
+    }
+  }
+
+  return false;
+}
+
+/**
+ * Check if qItem is a repeat item AND if it isn't a checkbox item
+ * Note: repeat checkbox items are rendered as multi-select checkbox instead of being rendered as a traditional repeat item
+ *
+ * @author Sean Fong
+ */
+export function isRepeatItemAndNotCheckbox(qItem: QuestionnaireItem): boolean {
+  const isCheckbox =
+    getChoiceControlType(qItem) === QItemChoiceControl.Checkbox ||
+    getOpenChoiceControlType(qItem) === QItemOpenChoiceControl.Checkbox;
+
+  return !!qItem['repeats'] && !isCheckbox;
+}
+
+export function getXHtmlStringFromQuestionnaire(questionnaire: Questionnaire): string | null {
+  const itemControl = questionnaire._title?.extension?.find(
+    (extension: Extension) =>
+      extension.url === 'http://hl7.org/fhir/StructureDefinition/rendering-xhtml'
+  );
+
+  if (itemControl) {
+    if (itemControl.valueString) {
+      return itemControl.valueString;
+    }
+  }
+  return null;
+}

package/src/utils/qrItem.js

@@ -0,0 +1,221 @@
+/*
+ * Copyright 2023 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.
+ */
+/**
+ * Create a questionnaireResponse from a given questionnaire form item
+ * A questionnaire form item is the first item of a questionnaire
+ *
+ * @author Sean Fong
+ */
+export function createQuestionnaireResponse(questionnaire) {
+    var _a;
+    const questionnaireResponse = {
+        resourceType: 'QuestionnaireResponse',
+        status: 'in-progress'
+    };
+    const firstTopLevelItem = (_a = questionnaire === null || questionnaire === void 0 ? void 0 : questionnaire.item) === null || _a === void 0 ? void 0 : _a[0];
+    if (firstTopLevelItem) {
+        questionnaireResponse.item = [
+            {
+                linkId: firstTopLevelItem.linkId,
+                text: firstTopLevelItem.text,
+                item: []
+            }
+        ];
+    }
+    if (questionnaire.id) {
+        questionnaireResponse.questionnaire = `Questionnaire/${questionnaire.id}`;
+    }
+    return questionnaireResponse;
+}
+/**
+ * Remove items with no answers from a given questionnaireResponse
+ * Also remove any starting or trailing whitespace from valueStrings
+ * Generated questionnaireResponse only has items with answers
+ *
+ * @author Sean Fong
+ */
+export function removeNoAnswerQrItem(qrItem) {
+    const items = qrItem.item;
+    if (items && items.length > 0) {
+        const itemsCleaned = [];
+        // only get items with answers
+        items.forEach((item) => {
+            const QrItemCleaned = removeNoAnswerQrItem(item);
+            if (QrItemCleaned) {
+                itemsCleaned.push(QrItemCleaned);
+            }
+        });
+        return itemsCleaned.length > 0 ? Object.assign(Object.assign({}, qrItem), { item: itemsCleaned }) : undefined;
+    }
+    // remove starting or trailing whitespace
+    if (qrItem['answer'] && qrItem['answer'][0]['valueString']) {
+        qrItem['answer'][0]['valueString'] = qrItem['answer'][0]['valueString'].trim();
+    }
+    // check answer when qrItem is a single question
+    return qrItem['answer'] ? qrItem : undefined;
+}
+/**
+ * Create an empty group qrItem from a given group qItem
+ *
+ * @author Sean Fong
+ */
+export function createQrGroup(qItem) {
+    return {
+        linkId: qItem.linkId,
+        text: qItem.text,
+        item: []
+    };
+}
+/**
+ * Create an empty qrItem from a given qItem
+ *
+ * @author Sean Fong
+ */
+export function createEmptyQrItem(qItem) {
+    return {
+        linkId: qItem.linkId,
+        text: qItem.text
+    };
+}
+/**
+ * Create an empty qrItem from a given qItem with its display unit
+ *
+ * @author Sean Fong
+ */
+export function createEmptyQrItemWithUnit(qItem, unit) {
+    return {
+        linkId: qItem.linkId,
+        text: unit !== '' ? `${qItem.text} (${unit})` : qItem.text
+    };
+}
+/**
+ * Updates the QuestionnaireResponseItem group by adding/removing a new/modified child QuestionnaireResponseItem into/from a qrGroup
+ * Takes either a single newQrItem or an array of newQrItems
+ *
+ * @author Sean Fong
+ */
+export function updateQrGroup(newQrItem, newQrRepeatGroup, qrGroup, qItemsIndexMap) {
+    var _a, _b;
+    if (qrGroup['item']) {
+        // Get actual sequence indexes of qrItems present within a qrGroup
+        // e.g. qrGroup has 4 fields but only the 2nd and 3rd field have values - resulting array is [1, 2]
+        const qrItemsRealIndexArr = qrGroup.item.map((qrItem) => qItemsIndexMap[qrItem.linkId]);
+        if (newQrItem && newQrItem.linkId in qItemsIndexMap) {
+            if (qrGroup.item.length === 0) {
+                qrGroup.item.push(newQrItem);
+            }
+            else {
+                // Get actual sequence index of qrItem within qrGroup
+                const newQrItemIndex = qItemsIndexMap[newQrItem.linkId];
+                for (let i = 0; i < qrItemsRealIndexArr.length; i++) {
+                    // Add qrItem at the end of qrGroup if it is larger than the other indexes
+                    if (newQrItemIndex > qrItemsRealIndexArr[i]) {
+                        if (i === qrItemsRealIndexArr.length - 1) {
+                            qrGroup.item.push(newQrItem);
+                        }
+                        continue;
+                    }
+                    // Replace or delete qrItem at its supposed position if its index is already present within qrGroup
+                    if (newQrItemIndex === qrItemsRealIndexArr[i]) {
+                        if (((_a = newQrItem.item) === null || _a === void 0 ? void 0 : _a.length) || ((_b = newQrItem.answer) === null || _b === void 0 ? void 0 : _b.length)) {
+                            // newQrItem has answer value
+                            qrGroup.item[i] = newQrItem;
+                        }
+                        else {
+                            // newQrItem has no answer value
+                            qrGroup.item.splice(i, 1);
+                        }
+                        break;
+                    }
+                    // Add qrItem at its supposed position if its index is not present within qrGroup
+                    if (newQrItemIndex < qrItemsRealIndexArr[i]) {
+                        qrGroup.item.splice(i, 0, newQrItem);
+                        break;
+                    }
+                }
+            }
+        }
+        else if (newQrRepeatGroup && newQrRepeatGroup.linkId in qItemsIndexMap) {
+            const newQrItems = newQrRepeatGroup.qrItems;
+            if (qrGroup.item.length === 0) {
+                qrGroup.item.push(...newQrItems);
+            }
+            else {
+                // Get actual sequence index of qrItems within qrGroup
+                const newQrItemIndex = qItemsIndexMap[newQrRepeatGroup.linkId];
+                for (let i = 0; i < qrItemsRealIndexArr.length; i++) {
+                    // Add qrItem at the end of qrGroup if it is larger than the other indexes
+                    if (newQrItemIndex > qrItemsRealIndexArr[i]) {
+                        if (i === qrItemsRealIndexArr.length - 1) {
+                            qrGroup.item.push(...newQrItems);
+                        }
+                        continue;
+                    }
+                    // Replace or delete qrItem at its supposed position if its index is already present within qrGroup
+                    if (newQrItemIndex === qrItemsRealIndexArr[i]) {
+                        // Get number of repeatGroupItems that has the same linkId present in qrGroup
+                        let repeatGroupItemCount = 0;
+                        while (newQrItemIndex === qrItemsRealIndexArr[i + repeatGroupItemCount]) {
+                            repeatGroupItemCount++;
+                        }
+                        // Replace each repeat group qrItem with their new counterparts
+                        if (newQrItems.length === repeatGroupItemCount) {
+                            for (let j = 0; j < newQrItems.length; j++) {
+                                qrGroup.item[i + j] = newQrItems[j];
+                            }
+                            break;
+                        }
+                        else if (newQrItems.length > repeatGroupItemCount) {
+                            // Replace each repeat group qrItem with their new counterparts,
+                            // followed by adding an extra newQrItem behind the newly replaced qrItems
+                            for (let j = 0, k = repeatGroupItemCount; j < newQrItems.length; j++, k--) {
+                                if (k > 0) {
+                                    qrGroup.item[i + j] = newQrItems[j];
+                                }
+                                else {
+                                    qrGroup.item.splice(i + j, 0, newQrItems[j]);
+                                }
+                            }
+                            break;
+                        }
+                        else if (newQrItems.length < repeatGroupItemCount) {
+                            // Replace each repeat group qrItem with their new counterparts (except the last one),
+                            // followed by deleting the last newQrItem which wasn't replaced
+                            for (let j = 0; j < repeatGroupItemCount; j++) {
+                                if (j <= newQrItems.length - 1) {
+                                    qrGroup.item[i + j] = newQrItems[j];
+                                }
+                                else {
+                                    qrGroup.item.splice(i + j, 1);
+                                }
+                            }
+                            break;
+                        }
+                    }
+                    // Add qrItem at its supposed position if its index is not present within qrGroup
+                    if (newQrItemIndex < qrItemsRealIndexArr[i]) {
+                        for (let j = 0; j < newQrItems.length; j++) {
+                            qrGroup.item.splice(i + j, 0, newQrItems[j]);
+                        }
+                        break;
+                    }
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=qrItem.js.map

package/src/utils/qrItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qrItem.js","sourceRoot":"","sources":["qrItem.ts"],"names":[],"mappings":"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"}