@aehrc/smart-forms-renderer 0.2.0 → 0.4.0

package/src/utils/mapItem.js

@@ -0,0 +1,80 @@
+/*
+ * 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 { isRepeatItemAndNotCheckbox } from './qItem';
+/**
+ * Generate an array of QuestionnaireResponseItems corresponding to its QuestionnaireItem indexes an array.
+ * QuestionnaireItems without a corresponding QuestionnaireResponseItem is set as undefined.
+ * i.e. QItems = [QItem0, QItem1, QItem2]. Only QItem0 and QItem2 have QrItems
+ * Generated array: [QrItem0, undefined, QrItem2]
+ *
+ * @author Sean Fong
+ */
+export function getQrItemsIndex(qItems, qrItems, qItemsIndexMap) {
+    // Generate a <linkId, QrItem OR QrItems> dictionary
+    const qrItemsCollected = {};
+    for (const qrItem of qrItems) {
+        const linkId = qrItem.linkId;
+        // If item already exists, it has multiple qrItems and is therefore a repeat group
+        if (qrItemsCollected[linkId]) {
+            let storedValue = qrItemsCollected[linkId];
+            // Create an array out of initial stored value if it is not an array initially
+            if (!Array.isArray(storedValue)) {
+                storedValue = [storedValue];
+            }
+            // Push new qrItem into array
+            storedValue.push(qrItem);
+            qrItemsCollected[linkId] = storedValue;
+        }
+        else {
+            const qItemIndex = qItemsIndexMap[linkId];
+            // Assign either a qrItem array or a single qrItem based on whether it is a repeatGroup or not
+            const isRepeatGroup = isRepeatItemAndNotCheckbox(qItems[qItemIndex]) && qItems[qItemIndex].type === 'group';
+            qrItemsCollected[linkId] = isRepeatGroup ? [qrItem] : qrItem;
+        }
+    }
+    // Generate an array of QuestionnaireResponseItems corresponding to its QuestionnaireItem indexes in sequence
+    // Qitems with no answers has a default value of undefined
+    return qItems.reduce((mapping, qItem, i) => {
+        const qrItemOrItems = qrItemsCollected[qItem.linkId];
+        // If qItem is a repeat group, default its value to an array instead of undefined
+        if (isRepeatItemAndNotCheckbox(qItem) && qItem.type === 'group') {
+            mapping[i] = qrItemOrItems ? qrItemsCollected[qItem.linkId] : [];
+        }
+        else {
+            mapping[i] = qrItemsCollected[qItem.linkId];
+        }
+        return mapping;
+    }, []);
+}
+/**
+ * Generate a dictionary of QuestionnaireItems linkIds mapped to their respective array indexes <linkId, QItemIndex>
+ * i.e. { ee2589d5: 0, f9aaa187: 1, 88cab112: 2 }
+ * where ee2589d5, f9aaa187 and 88cab112 are linkIds of QItem0, QItem1 and QItem2 respectively
+ *
+ * @author Sean Fong
+ */
+export function mapQItemsIndex(qGroup) {
+    if (!qGroup.item) {
+        return {};
+    }
+    // generate a <linkId, QItemIndex> dictionary
+    return qGroup.item.reduce((mapping, item, i) => {
+        mapping[item.linkId] = i;
+        return mapping;
+    }, {});
+}
+//# sourceMappingURL=mapItem.js.map

package/src/utils/mapItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapItem.js","sourceRoot":"","sources":["mapItem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,MAA2B,EAC3B,OAAoC,EACpC,cAAsC;IAEtC,oDAAoD;IACpD,MAAM,gBAAgB,GACpB,EAAE,CAAC;IACL,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE;QAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAE7B,kFAAkF;QAClF,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE;YAC5B,IAAI,WAAW,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAE3C,8EAA8E;YAC9E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE;gBAC/B,WAAW,GAAG,CAAC,WAAW,CAAC,CAAC;aAC7B;YAED,6BAA6B;YAC7B,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzB,gBAAgB,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC;SACxC;aAAM;YACL,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;YAE1C,8FAA8F;YAC9F,MAAM,aAAa,GACjB,0BAA0B,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC;YAExF,gBAAgB,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;SAC9D;KACF;IAED,6GAA6G;IAC7G,0DAA0D;IAC1D,OAAO,MAAM,CAAC,MAAM,CAClB,CAAC,OAAoE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACjF,MAAM,aAAa,GAAG,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrD,iFAAiF;QACjF,IAAI,0BAA0B,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE;YAC/D,OAAO,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAClE;aAAM;YACL,OAAO,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;SAC7C;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,EACD,EAAE,CACH,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,MAAyB;IACtD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;QAChB,OAAO,EAAE,CAAC;KACX;IAED,6CAA6C;IAC7C,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAA+B,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE;QACrE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,OAAO,OAAO,CAAC;IACjB,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC"}

package/src/utils/mapItem.ts

@@ -0,0 +1,97 @@
+/*
+ * 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 { QuestionnaireItem, QuestionnaireResponseItem } from 'fhir/r4';
+import { isRepeatItemAndNotCheckbox } from './qItem';
+
+/**
+ * Generate an array of QuestionnaireResponseItems corresponding to its QuestionnaireItem indexes an array.
+ * QuestionnaireItems without a corresponding QuestionnaireResponseItem is set as undefined.
+ * i.e. QItems = [QItem0, QItem1, QItem2]. Only QItem0 and QItem2 have QrItems
+ * Generated array: [QrItem0, undefined, QrItem2]
+ *
+ * @author Sean Fong
+ */
+export function getQrItemsIndex(
+  qItems: QuestionnaireItem[],
+  qrItems: QuestionnaireResponseItem[],
+  qItemsIndexMap: Record<string, number>
+): (QuestionnaireResponseItem | QuestionnaireResponseItem[])[] {
+  // Generate a <linkId, QrItem OR QrItems> dictionary
+  const qrItemsCollected: Record<string, QuestionnaireResponseItem | QuestionnaireResponseItem[]> =
+    {};
+  for (const qrItem of qrItems) {
+    const linkId = qrItem.linkId;
+
+    // If item already exists, it has multiple qrItems and is therefore a repeat group
+    if (qrItemsCollected[linkId]) {
+      let storedValue = qrItemsCollected[linkId];
+
+      // Create an array out of initial stored value if it is not an array initially
+      if (!Array.isArray(storedValue)) {
+        storedValue = [storedValue];
+      }
+
+      // Push new qrItem into array
+      storedValue.push(qrItem);
+      qrItemsCollected[linkId] = storedValue;
+    } else {
+      const qItemIndex = qItemsIndexMap[linkId];
+
+      // Assign either a qrItem array or a single qrItem based on whether it is a repeatGroup or not
+      const isRepeatGroup =
+        isRepeatItemAndNotCheckbox(qItems[qItemIndex]) && qItems[qItemIndex].type === 'group';
+
+      qrItemsCollected[linkId] = isRepeatGroup ? [qrItem] : qrItem;
+    }
+  }
+
+  // Generate an array of QuestionnaireResponseItems corresponding to its QuestionnaireItem indexes in sequence
+  // Qitems with no answers has a default value of undefined
+  return qItems.reduce(
+    (mapping: (QuestionnaireResponseItem | QuestionnaireResponseItem[])[], qItem, i) => {
+      const qrItemOrItems = qrItemsCollected[qItem.linkId];
+      // If qItem is a repeat group, default its value to an array instead of undefined
+      if (isRepeatItemAndNotCheckbox(qItem) && qItem.type === 'group') {
+        mapping[i] = qrItemOrItems ? qrItemsCollected[qItem.linkId] : [];
+      } else {
+        mapping[i] = qrItemsCollected[qItem.linkId];
+      }
+      return mapping;
+    },
+    []
+  );
+}
+
+/**
+ * Generate a dictionary of QuestionnaireItems linkIds mapped to their respective array indexes <linkId, QItemIndex>
+ * i.e. { ee2589d5: 0, f9aaa187: 1, 88cab112: 2 }
+ * where ee2589d5, f9aaa187 and 88cab112 are linkIds of QItem0, QItem1 and QItem2 respectively
+ *
+ * @author Sean Fong
+ */
+export function mapQItemsIndex(qGroup: QuestionnaireItem): Record<string, number> {
+  if (!qGroup.item) {
+    return {};
+  }
+
+  // generate a <linkId, QItemIndex> dictionary
+  return qGroup.item.reduce((mapping: Record<string, number>, item, i) => {
+    mapping[item.linkId] = i;
+    return mapping;
+  }, {});
+}

package/src/utils/openChoice.js

@@ -0,0 +1,150 @@
+/*
+ * 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 { CheckBoxOptionType, QItemOpenChoiceControl } from '../interfaces/choice.enum';
+import { isSpecificItemControl } from './itemControl';
+import { findInAnswerOptions, findInAnswerValueSetCodings } from './choice';
+/**
+ * Update open-choice checkbox group answers based on checkbox changes
+ *
+ * @author Sean Fong
+ */
+export function updateQrOpenChoiceCheckboxAnswers(changedOptionAnswer, changedOpenLabelAnswer, answers, answerOptions, qrChoiceCheckbox, checkboxOptionType, isMultiSelection) {
+    if (changedOptionAnswer) {
+        const newAnswer = checkboxOptionType === CheckBoxOptionType.AnswerOption
+            ? findInAnswerOptions(answerOptions, changedOptionAnswer)
+            : findInAnswerValueSetCodings(answerOptions, changedOptionAnswer);
+        if (!newAnswer)
+            return null;
+        if (isMultiSelection && answers.length > 0) {
+            // check if new answer exists in existing answers
+            const newAnswerInAnswers = checkboxOptionType === CheckBoxOptionType.AnswerOption
+                ? findInAnswerOptions(answers, changedOptionAnswer)
+                : findInAnswerValueSetCodings(answers, changedOptionAnswer);
+            if (newAnswerInAnswers) {
+                // remove new answer from qrAnswers
+                const newAnswers = [...answers].filter((answer) => JSON.stringify(answer) !== JSON.stringify(newAnswerInAnswers));
+                return Object.assign(Object.assign({}, qrChoiceCheckbox), { answer: newAnswers });
+            }
+            else {
+                // add new answer to qrAnswers
+                return Object.assign(Object.assign({}, qrChoiceCheckbox), { answer: [...answers, newAnswer] });
+            }
+        }
+        else {
+            return answers.some((answer) => JSON.stringify(answer) === JSON.stringify(newAnswer))
+                ? Object.assign(Object.assign({}, qrChoiceCheckbox), { answer: [] }) : Object.assign(Object.assign({}, qrChoiceCheckbox), { answer: [newAnswer] });
+        }
+    }
+    else if (changedOpenLabelAnswer !== null) {
+        const newOpenLabelAnswer = { valueString: changedOpenLabelAnswer };
+        const oldOpenLabelAnswer = getOldOpenLabelAnswer(answers, answerOptions);
+        if (answers.length === 0) {
+            if (changedOpenLabelAnswer === '') {
+                return { linkId: qrChoiceCheckbox.linkId, text: qrChoiceCheckbox.text };
+            }
+            else {
+                return Object.assign(Object.assign({}, qrChoiceCheckbox), { answer: [newOpenLabelAnswer] });
+            }
+        }
+        if (isMultiSelection) {
+            if (!oldOpenLabelAnswer) {
+                // append newOpenLabel if oldOpenLabel doesnt exist
+                return Object.assign(Object.assign({}, qrChoiceCheckbox), { answer: [...answers, newOpenLabelAnswer] });
+            }
+            else {
+                // An oldOpenLabel already exists
+                // Remove oldOpenLabel from answers
+                const answersWithoutOpenLabel = [...answers].filter((answer) => JSON.stringify(answer) !== JSON.stringify(oldOpenLabelAnswer));
+                if (JSON.stringify(newOpenLabelAnswer) === JSON.stringify(oldOpenLabelAnswer) ||
+                    changedOpenLabelAnswer === '') {
+                    // User unchecks openLabel checkbox or clears field
+                    if (answersWithoutOpenLabel.length > 0) {
+                        return Object.assign(Object.assign({}, qrChoiceCheckbox), { answer: answersWithoutOpenLabel });
+                    }
+                    else {
+                        return { linkId: qrChoiceCheckbox.linkId, text: qrChoiceCheckbox.text };
+                    }
+                }
+                else {
+                    // User changes openLabel value
+                    return Object.assign(Object.assign({}, qrChoiceCheckbox), { answer: [...answersWithoutOpenLabel, newOpenLabelAnswer] });
+                }
+            }
+        }
+        else {
+            if (!oldOpenLabelAnswer || newOpenLabelAnswer !== oldOpenLabelAnswer) {
+                // set newOpenLabel as sole answer if oldOpenLabel doesnt exist OR if user changed openLabel value
+                return Object.assign(Object.assign({}, qrChoiceCheckbox), { answer: [newOpenLabelAnswer] });
+            }
+            else {
+                // User unchecks openLabel checkbox
+                return Object.assign(Object.assign({}, qrChoiceCheckbox), { answer: [] });
+            }
+        }
+    }
+    else {
+        // Default condition which will not happen
+        return Object.assign({}, qrChoiceCheckbox);
+    }
+}
+export function getOldOpenLabelAnswer(answers, options) {
+    const openLabelAnswers = answers.filter((answer) => options.indexOf(answer) === -1);
+    return openLabelAnswers.length > 0 ? openLabelAnswers[0] : null;
+}
+/**
+ * Get openChoice control type from qItem
+ * defaults to select if no control code is provided
+ *
+ * @author Sean Fong
+ */
+export function getOpenChoiceControlType(qItem) {
+    if (isSpecificItemControl(qItem, 'autocomplete')) {
+        return QItemOpenChoiceControl.Autocomplete;
+    }
+    else if (isSpecificItemControl(qItem, 'check-box')) {
+        return QItemOpenChoiceControl.Checkbox;
+    }
+    else if (isSpecificItemControl(qItem, 'radio-button')) {
+        return QItemOpenChoiceControl.Radio;
+    }
+    else {
+        return QItemOpenChoiceControl.Select;
+    }
+}
+/**
+ * Get string label from given answerOption
+ *
+ * @author Sean Fong
+ */
+export function getAnswerOptionLabel(option) {
+    if (typeof option === 'string') {
+        return option;
+    }
+    if (option['valueCoding']) {
+        return `${option.valueCoding.display}`;
+    }
+    else if (option['valueString']) {
+        return option.valueString;
+    }
+    else if (option['valueInteger']) {
+        return option.valueInteger.toString();
+    }
+    else {
+        return '';
+    }
+}
+//# sourceMappingURL=openChoice.js.map

package/src/utils/openChoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openChoice.js","sourceRoot":"","sources":["openChoice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAE5E;;;;GAIG;AACH,MAAM,UAAU,iCAAiC,CAC/C,mBAAkC,EAClC,sBAAqC,EACrC,OAA0C,EAC1C,aAAyD,EACzD,gBAA2C,EAC3C,kBAAsC,EACtC,gBAAyB;IAEzB,IAAI,mBAAmB,EAAE;QACvB,MAAM,SAAS,GACb,kBAAkB,KAAK,kBAAkB,CAAC,YAAY;YACpD,CAAC,CAAC,mBAAmB,CAAC,aAAa,EAAE,mBAAmB,CAAC;YACzD,CAAC,CAAC,2BAA2B,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC;QACtE,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAE5B,IAAI,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE;YAC1C,iDAAiD;YACjD,MAAM,kBAAkB,GACtB,kBAAkB,KAAK,kBAAkB,CAAC,YAAY;gBACpD,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,CAAC;gBACnD,CAAC,CAAC,2BAA2B,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;YAEhE,IAAI,kBAAkB,EAAE;gBACtB,mCAAmC;gBACnC,MAAM,UAAU,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,MAAM,CACpC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAC1E,CAAC;gBACF,uCAAY,gBAAgB,KAAE,MAAM,EAAE,UAAU,IAAG;aACpD;iBAAM;gBACL,8BAA8B;gBAC9B,uCAAY,gBAAgB,KAAE,MAAM,EAAE,CAAC,GAAG,OAAO,EAAE,SAAS,CAAC,IAAG;aACjE;SACF;aAAM;YACL,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;gBACnF,CAAC,iCAAM,gBAAgB,KAAE,MAAM,EAAE,EAAE,IACnC,CAAC,iCAAM,gBAAgB,KAAE,MAAM,EAAE,CAAC,SAAS,CAAC,GAAE,CAAC;SAClD;KACF;SAAM,IAAI,sBAAsB,KAAK,IAAI,EAAE;QAC1C,MAAM,kBAAkB,GAAG,EAAE,WAAW,EAAE,sBAAsB,EAAE,CAAC;QACnE,MAAM,kBAAkB,GAA2C,qBAAqB,CACtF,OAAO,EACP,aAAa,CACd,CAAC;QAEF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE;YACxB,IAAI,sBAAsB,KAAK,EAAE,EAAE;gBACjC,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,gBAAgB,CAAC,IAAI,EAAE,CAAC;aACzE;iBAAM;gBACL,uCAAY,gBAAgB,KAAE,MAAM,EAAE,CAAC,kBAAkB,CAAC,IAAG;aAC9D;SACF;QAED,IAAI,gBAAgB,EAAE;YACpB,IAAI,CAAC,kBAAkB,EAAE;gBACvB,mDAAmD;gBACnD,uCACK,gBAAgB,KACnB,MAAM,EAAE,CAAC,GAAG,OAAO,EAAE,kBAAkB,CAAC,IACxC;aACH;iBAAM;gBACL,iCAAiC;gBACjC,mCAAmC;gBACnC,MAAM,uBAAuB,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,MAAM,CACjD,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAC1E,CAAC;gBAEF,IACE,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC;oBACzE,sBAAsB,KAAK,EAAE,EAC7B;oBACA,mDAAmD;oBACnD,IAAI,uBAAuB,CAAC,MAAM,GAAG,CAAC,EAAE;wBACtC,uCAAY,gBAAgB,KAAE,MAAM,EAAE,uBAAuB,IAAG;qBACjE;yBAAM;wBACL,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,gBAAgB,CAAC,IAAI,EAAE,CAAC;qBACzE;iBACF;qBAAM;oBACL,+BAA+B;oBAC/B,uCACK,gBAAgB,KACnB,MAAM,EAAE,CAAC,GAAG,uBAAuB,EAAE,kBAAkB,CAAC,IACxD;iBACH;aACF;SACF;aAAM;YACL,IAAI,CAAC,kBAAkB,IAAI,kBAAkB,KAAK,kBAAkB,EAAE;gBACpE,kGAAkG;gBAClG,uCAAY,gBAAgB,KAAE,MAAM,EAAE,CAAC,kBAAkB,CAAC,IAAG;aAC9D;iBAAM;gBACL,mCAAmC;gBACnC,uCAAY,gBAAgB,KAAE,MAAM,EAAE,EAAE,IAAG;aAC5C;SACF;KACF;SAAM;QACL,0CAA0C;QAC1C,yBAAY,gBAAgB,EAAG;KAChC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAA0C,EAC1C,OAAwC;IAExC,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACpF,OAAO,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAClE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAwB;IAC/D,IAAI,qBAAqB,CAAC,KAAK,EAAE,cAAc,CAAC,EAAE;QAChD,OAAO,sBAAsB,CAAC,YAAY,CAAC;KAC5C;SAAM,IAAI,qBAAqB,CAAC,KAAK,EAAE,WAAW,CAAC,EAAE;QACpD,OAAO,sBAAsB,CAAC,QAAQ,CAAC;KACxC;SAAM,IAAI,qBAAqB,CAAC,KAAK,EAAE,cAAc,CAAC,EAAE;QACvD,OAAO,sBAAsB,CAAC,KAAK,CAAC;KACrC;SAAM;QACL,OAAO,sBAAsB,CAAC,MAAM,CAAC;KACtC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA8C;IACjF,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;QAC9B,OAAO,MAAM,CAAC;KACf;IAED,IAAI,MAAM,CAAC,aAAa,CAAC,EAAE;QACzB,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;KACxC;SAAM,IAAI,MAAM,CAAC,aAAa,CAAC,EAAE;QAChC,OAAO,MAAM,CAAC,WAAW,CAAC;KAC3B;SAAM,IAAI,MAAM,CAAC,cAAc,CAAC,EAAE;QACjC,OAAO,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;KACvC;SAAM;QACL,OAAO,EAAE,CAAC;KACX;AACH,CAAC"}

package/src/utils/openChoice.ts

@@ -0,0 +1,179 @@
+/*
+ * 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 {
+  Coding,
+  QuestionnaireItem,
+  QuestionnaireItemAnswerOption,
+  QuestionnaireResponseItem,
+  QuestionnaireResponseItemAnswer
+} from 'fhir/r4';
+import { CheckBoxOptionType, QItemOpenChoiceControl } from '../interfaces/choice.enum';
+import { isSpecificItemControl } from './itemControl';
+import { findInAnswerOptions, findInAnswerValueSetCodings } from './choice';
+
+/**
+ * Update open-choice checkbox group answers based on checkbox changes
+ *
+ * @author Sean Fong
+ */
+export function updateQrOpenChoiceCheckboxAnswers(
+  changedOptionAnswer: string | null,
+  changedOpenLabelAnswer: string | null,
+  answers: QuestionnaireResponseItemAnswer[],
+  answerOptions: QuestionnaireItemAnswerOption[] | Coding[],
+  qrChoiceCheckbox: QuestionnaireResponseItem,
+  checkboxOptionType: CheckBoxOptionType,
+  isMultiSelection: boolean
+): QuestionnaireResponseItem | null {
+  if (changedOptionAnswer) {
+    const newAnswer =
+      checkboxOptionType === CheckBoxOptionType.AnswerOption
+        ? findInAnswerOptions(answerOptions, changedOptionAnswer)
+        : findInAnswerValueSetCodings(answerOptions, changedOptionAnswer);
+    if (!newAnswer) return null;
+
+    if (isMultiSelection && answers.length > 0) {
+      // check if new answer exists in existing answers
+      const newAnswerInAnswers =
+        checkboxOptionType === CheckBoxOptionType.AnswerOption
+          ? findInAnswerOptions(answers, changedOptionAnswer)
+          : findInAnswerValueSetCodings(answers, changedOptionAnswer);
+
+      if (newAnswerInAnswers) {
+        // remove new answer from qrAnswers
+        const newAnswers = [...answers].filter(
+          (answer) => JSON.stringify(answer) !== JSON.stringify(newAnswerInAnswers)
+        );
+        return { ...qrChoiceCheckbox, answer: newAnswers };
+      } else {
+        // add new answer to qrAnswers
+        return { ...qrChoiceCheckbox, answer: [...answers, newAnswer] };
+      }
+    } else {
+      return answers.some((answer) => JSON.stringify(answer) === JSON.stringify(newAnswer))
+        ? { ...qrChoiceCheckbox, answer: [] }
+        : { ...qrChoiceCheckbox, answer: [newAnswer] };
+    }
+  } else if (changedOpenLabelAnswer !== null) {
+    const newOpenLabelAnswer = { valueString: changedOpenLabelAnswer };
+    const oldOpenLabelAnswer: QuestionnaireResponseItemAnswer | null = getOldOpenLabelAnswer(
+      answers,
+      answerOptions
+    );
+
+    if (answers.length === 0) {
+      if (changedOpenLabelAnswer === '') {
+        return { linkId: qrChoiceCheckbox.linkId, text: qrChoiceCheckbox.text };
+      } else {
+        return { ...qrChoiceCheckbox, answer: [newOpenLabelAnswer] };
+      }
+    }
+
+    if (isMultiSelection) {
+      if (!oldOpenLabelAnswer) {
+        // append newOpenLabel if oldOpenLabel doesnt exist
+        return {
+          ...qrChoiceCheckbox,
+          answer: [...answers, newOpenLabelAnswer]
+        };
+      } else {
+        // An oldOpenLabel already exists
+        // Remove oldOpenLabel from answers
+        const answersWithoutOpenLabel = [...answers].filter(
+          (answer) => JSON.stringify(answer) !== JSON.stringify(oldOpenLabelAnswer)
+        );
+
+        if (
+          JSON.stringify(newOpenLabelAnswer) === JSON.stringify(oldOpenLabelAnswer) ||
+          changedOpenLabelAnswer === ''
+        ) {
+          // User unchecks openLabel checkbox or clears field
+          if (answersWithoutOpenLabel.length > 0) {
+            return { ...qrChoiceCheckbox, answer: answersWithoutOpenLabel };
+          } else {
+            return { linkId: qrChoiceCheckbox.linkId, text: qrChoiceCheckbox.text };
+          }
+        } else {
+          // User changes openLabel value
+          return {
+            ...qrChoiceCheckbox,
+            answer: [...answersWithoutOpenLabel, newOpenLabelAnswer]
+          };
+        }
+      }
+    } else {
+      if (!oldOpenLabelAnswer || newOpenLabelAnswer !== oldOpenLabelAnswer) {
+        // set newOpenLabel as sole answer if oldOpenLabel doesnt exist OR if user changed openLabel value
+        return { ...qrChoiceCheckbox, answer: [newOpenLabelAnswer] };
+      } else {
+        // User unchecks openLabel checkbox
+        return { ...qrChoiceCheckbox, answer: [] };
+      }
+    }
+  } else {
+    // Default condition which will not happen
+    return { ...qrChoiceCheckbox };
+  }
+}
+
+export function getOldOpenLabelAnswer(
+  answers: QuestionnaireResponseItemAnswer[],
+  options: QuestionnaireItemAnswerOption[]
+): QuestionnaireResponseItemAnswer | null {
+  const openLabelAnswers = answers.filter((answer) => options.indexOf(answer) === -1);
+  return openLabelAnswers.length > 0 ? openLabelAnswers[0] : null;
+}
+
+/**
+ * Get openChoice control type from qItem
+ * defaults to select if no control code is provided
+ *
+ * @author Sean Fong
+ */
+export function getOpenChoiceControlType(qItem: QuestionnaireItem) {
+  if (isSpecificItemControl(qItem, 'autocomplete')) {
+    return QItemOpenChoiceControl.Autocomplete;
+  } else if (isSpecificItemControl(qItem, 'check-box')) {
+    return QItemOpenChoiceControl.Checkbox;
+  } else if (isSpecificItemControl(qItem, 'radio-button')) {
+    return QItemOpenChoiceControl.Radio;
+  } else {
+    return QItemOpenChoiceControl.Select;
+  }
+}
+
+/**
+ * Get string label from given answerOption
+ *
+ * @author Sean Fong
+ */
+export function getAnswerOptionLabel(option: QuestionnaireItemAnswerOption | string): string {
+  if (typeof option === 'string') {
+    return option;
+  }
+
+  if (option['valueCoding']) {
+    return `${option.valueCoding.display}`;
+  } else if (option['valueString']) {
+    return option.valueString;
+  } else if (option['valueInteger']) {
+    return option.valueInteger.toString();
+  } else {
+    return '';
+  }
+}

package/src/utils/parseInputs.js

@@ -0,0 +1,49 @@
+/*
+ * 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.
+ */
+export function parseValidInteger(input) {
+    const validNumericString = parseValidNumericString(input);
+    return parseInt(validNumericString);
+}
+export function parseValidNumericString(input) {
+    const hasNumber = /\d/;
+    if (!hasNumber.test(input)) {
+        return '0';
+    }
+    return input;
+}
+export function parseDecimalStringWithPrecision(input, precision) {
+    input = parseValidNumericString(input);
+    let parsedInput = parseFloat(input).toString();
+    // restore decimal digits if parseFloat() removes them
+    const decimalPoint = input.indexOf('.');
+    if (decimalPoint !== -1) {
+        const decimalDigits = input.slice(decimalPoint);
+        if (parsedInput.indexOf('.') === -1) {
+            parsedInput += decimalDigits;
+        }
+    }
+    // truncate decimal digits based on precision
+    const parsedDecimalPoint = input.indexOf('.');
+    if (precision && parsedDecimalPoint !== -1) {
+        parsedInput = parsedInput.substring(0, parsedDecimalPoint + precision + 1);
+    }
+    return parsedInput;
+}
+export function parseDecimalStringToFloat(input, precision) {
+    return parseFloat(parseFloat(input).toFixed(precision));
+}
+//# sourceMappingURL=parseInputs.js.map

package/src/utils/parseInputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseInputs.js","sourceRoot":"","sources":["parseInputs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAE1D,OAAO,QAAQ,CAAC,kBAAkB,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;QAC1B,OAAO,GAAG,CAAC;KACZ;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,KAAa,EAAE,SAAwB;IACrF,KAAK,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAEvC,IAAI,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;IAE/C,sDAAsD;IACtD,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE;QACvB,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAChD,IAAI,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE;YACnC,WAAW,IAAI,aAAa,CAAC;SAC9B;KACF;IAED,6CAA6C;IAC7C,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,SAAS,IAAI,kBAAkB,KAAK,CAAC,CAAC,EAAE;QAC1C,WAAW,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,kBAAkB,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC;KAC5E;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAa,EAAE,SAAiB;IACxE,OAAO,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/src/utils/parseInputs.ts

@@ -0,0 +1,58 @@
+/*
+ * 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.
+ */
+
+export function parseValidInteger(input: string): number {
+  const validNumericString = parseValidNumericString(input);
+
+  return parseInt(validNumericString);
+}
+
+export function parseValidNumericString(input: string): string {
+  const hasNumber = /\d/;
+  if (!hasNumber.test(input)) {
+    return '0';
+  }
+
+  return input;
+}
+
+export function parseDecimalStringWithPrecision(input: string, precision: number | null): string {
+  input = parseValidNumericString(input);
+
+  let parsedInput = parseFloat(input).toString();
+
+  // restore decimal digits if parseFloat() removes them
+  const decimalPoint = input.indexOf('.');
+  if (decimalPoint !== -1) {
+    const decimalDigits = input.slice(decimalPoint);
+    if (parsedInput.indexOf('.') === -1) {
+      parsedInput += decimalDigits;
+    }
+  }
+
+  // truncate decimal digits based on precision
+  const parsedDecimalPoint = input.indexOf('.');
+  if (precision && parsedDecimalPoint !== -1) {
+    parsedInput = parsedInput.substring(0, parsedDecimalPoint + precision + 1);
+  }
+
+  return parsedInput;
+}
+
+export function parseDecimalStringToFloat(input: string, precision: number): number {
+  return parseFloat(parseFloat(input).toFixed(precision));
+}