@aehrc/smart-forms-renderer 0.2.0 → 0.4.0

package/src/utils/debounce.ts

@@ -0,0 +1,20 @@
+/*
+ * 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 const DEBOUNCE_DURATION = 200;
+
+export const AUTOCOMPLETE_DEBOUNCE_DURATION = 300;

package/src/utils/emptyResource.js

@@ -0,0 +1,25 @@
+/*
+ * 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 const emptyQuestionnaire = {
+    resourceType: 'Questionnaire',
+    status: 'draft'
+};
+export const emptyResponse = {
+    resourceType: 'QuestionnaireResponse',
+    status: 'in-progress'
+};
+//# sourceMappingURL=emptyResource.js.map

package/src/utils/emptyResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emptyResource.js","sourceRoot":"","sources":["emptyResource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAAkB;IAC/C,YAAY,EAAE,eAAe;IAC7B,MAAM,EAAE,OAAO;CAChB,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAA0B;IAClD,YAAY,EAAE,uBAAuB;IACrC,MAAM,EAAE,aAAa;CACtB,CAAC"}

package/src/utils/emptyResource.ts

@@ -0,0 +1,28 @@
+/*
+ * 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 { Questionnaire, QuestionnaireResponse } from 'fhir/r4';
+
+export const emptyQuestionnaire: Questionnaire = {
+  resourceType: 'Questionnaire',
+  status: 'draft'
+};
+
+export const emptyResponse: QuestionnaireResponse = {
+  resourceType: 'QuestionnaireResponse',
+  status: 'in-progress'
+};

package/src/utils/enableWhen.js

@@ -0,0 +1,228 @@
+/*
+ * 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 cloneDeep from 'lodash.clonedeep';
+/**
+ * Create a linkedQuestionsMap that contains linked items of enableWhen items
+ * mapped to an array containing all its respective enableWhen items' linkIds
+ * returns a key-value pair of <linkedItemId, [enableWhenItem1LinkId, enableWhenItem2LinkId, enableWhenItem3LinkId]>
+ *
+ * @author Sean Fong
+ */
+export function createEnableWhenLinkedQuestions(enableWhenItems) {
+    const linkedQuestionsMap = {};
+    for (const linkId in enableWhenItems) {
+        enableWhenItems[linkId].linked.forEach((linkedItem) => {
+            const linkQId = linkedItem.enableWhen.question;
+            if (!linkedQuestionsMap[linkQId]) {
+                linkedQuestionsMap[linkQId] = [];
+            }
+            if (!linkedQuestionsMap[linkQId].includes(linkId)) {
+                linkedQuestionsMap[linkQId].push(linkId);
+            }
+        });
+    }
+    return linkedQuestionsMap;
+}
+/**
+ * Performs switching for non-group enableWhenItems based on their item types.
+ *
+ * @author Sean Fong
+ */
+export function isEnabledAnswerTypeSwitcher(enableWhen, answer) {
+    var _a, _b;
+    if (enableWhen['answerBoolean'] !== undefined && enableWhen.operator === 'exists') {
+        return answerOperatorSwitcher(enableWhen.answerBoolean, answer, enableWhen.operator);
+    }
+    else if (enableWhen['answerBoolean'] !== undefined && answer.valueBoolean !== undefined) {
+        return answerOperatorSwitcher(enableWhen.answerBoolean, answer.valueBoolean, enableWhen.operator);
+    }
+    else if (enableWhen['answerDecimal'] && answer.valueDecimal) {
+        return answerOperatorSwitcher(enableWhen.answerDecimal, answer.valueDecimal, enableWhen.operator);
+    }
+    else if (enableWhen['answerInteger'] !== undefined && answer.valueInteger !== undefined) {
+        return answerOperatorSwitcher(enableWhen.answerInteger, answer.valueInteger, enableWhen.operator);
+    }
+    else if (enableWhen['answerDate'] && answer.valueDate) {
+        return answerOperatorSwitcher(enableWhen.answerDate, answer.valueDate, enableWhen.operator);
+    }
+    else if (enableWhen['answerDateTime'] && answer.valueDateTime) {
+        return answerOperatorSwitcher(enableWhen.answerDateTime, answer.valueDateTime, enableWhen.operator);
+    }
+    else if (enableWhen['answerTime'] && answer.valueTime) {
+        return answerOperatorSwitcher(enableWhen.answerTime, answer.valueTime, enableWhen.operator);
+    }
+    else if (enableWhen['answerString'] && answer.valueString) {
+        return answerOperatorSwitcher(enableWhen.answerString, answer.valueString, enableWhen.operator);
+    }
+    else if (((_a = enableWhen['answerCoding']) === null || _a === void 0 ? void 0 : _a.code) && ((_b = answer.valueCoding) === null || _b === void 0 ? void 0 : _b.code)) {
+        return answerOperatorSwitcher(enableWhen.answerCoding.code, answer.valueCoding.code, enableWhen.operator);
+    }
+    else if (enableWhen['answerQuantity'] && answer.valueQuantity) {
+        return answerOperatorSwitcher(enableWhen.answerQuantity, answer.valueQuantity, enableWhen.operator);
+    }
+    return false;
+}
+/**
+ * Performs switching for value and expected comparisons based on given operator
+ *
+ * @author Sean Fong
+ */
+function answerOperatorSwitcher(expected, value, operator) {
+    // FIXME runs even when the linked textbox is not changed
+    switch (operator) {
+        case 'exists':
+            // check if value is an object and contains any answerValues
+            return typeof value === 'object' && Object.keys(value).length !== 0;
+        case '=':
+            return value === expected;
+        case '!=':
+            return value !== expected;
+        case '<':
+            return value < expected;
+        case '<=':
+            return value <= expected;
+        case '>':
+            return value > expected;
+        case '>=':
+            return value >= expected;
+        default:
+            return false;
+    }
+}
+/**
+ * Read initial answer values in questionnaireResponse
+ * return a map of initial values with key-value pair <linkedItemId, initial value>
+ *
+ * @author Sean Fong
+ */
+export function readInitialAnswers(questionnaireResponse, linkedQuestionsMap) {
+    if (!questionnaireResponse.item)
+        return {};
+    const initialValuesMap = {};
+    questionnaireResponse.item.forEach((item) => {
+        readQuestionnaireResponseItemRecursive(item, initialValuesMap, linkedQuestionsMap);
+    });
+    return initialValuesMap;
+}
+/**
+ * Read initial answer values of each qrItem recursively
+ *
+ * @author Sean Fong
+ */
+function readQuestionnaireResponseItemRecursive(item, initialValues, linkedQuestionsMap) {
+    const items = item.item;
+    if (items && items.length > 0) {
+        // iterate through items of item recursively
+        items.forEach((item) => {
+            readQuestionnaireResponseItemRecursive(item, initialValues, linkedQuestionsMap);
+        });
+        return;
+    }
+    // Read initial answer value of single qrItem
+    if (linkedQuestionsMap[item.linkId] && item.answer) {
+        initialValues[item.linkId] = item.answer;
+    }
+    return;
+}
+/**
+ * Set initial answer values into enableWhenItems' answer attributes
+ * Update enabled status of each enableWhenItem simultaneously
+ *
+ * @author Sean Fong
+ */
+export function setInitialAnswers(initialAnswers, items, linkedQuestionsMap) {
+    let updatedItems = cloneDeep(items);
+    if (initialAnswers) {
+        for (const linkId in initialAnswers) {
+            const linkedQuestions = linkedQuestionsMap[linkId];
+            const newAnswer = initialAnswers[linkId];
+            updatedItems = updateItemAnswer(updatedItems, linkedQuestions, linkId, newAnswer);
+        }
+    }
+    return updatedItems;
+}
+/**
+ * Update answer of the target linkId in every related enableWhenItem's linked items
+ * Then update the enabled status of every related enableWhenItem
+ *
+ * @author Sean Fong
+ */
+export function updateItemAnswer(items, linkedQuestions, linkId, newAnswer) {
+    linkedQuestions.forEach((question) => {
+        // Update modified linked answer
+        items[question].linked.forEach((linkedItem) => {
+            if (linkedItem.enableWhen.question === linkId) {
+                linkedItem.answer = newAnswer !== null && newAnswer !== void 0 ? newAnswer : undefined;
+            }
+        });
+        // Update enabled status of modified enableWhenItem
+        items[question].isEnabled = checkItemIsEnabled(items[question]);
+    });
+    return items;
+}
+/**
+ * Check if an enableWhenItem is enabled based on the answer of its linked items
+ *
+ * @author Sean Fong
+ */
+export function checkItemIsEnabled(enableWhenItemProperties) {
+    const checkedIsEnabledItems = [];
+    enableWhenItemProperties.linked.forEach((linkedItem) => {
+        if (linkedItem.answer && linkedItem.answer.length > 0) {
+            linkedItem.answer.forEach((answer) => {
+                checkedIsEnabledItems.push(isEnabledAnswerTypeSwitcher(linkedItem.enableWhen, answer));
+            });
+        }
+    });
+    if (checkedIsEnabledItems.length === 0)
+        return false;
+    return enableWhenItemProperties.enableBehavior === 'any'
+        ? checkedIsEnabledItems.some((isEnabled) => isEnabled)
+        : checkedIsEnabledItems.every((isEnabled) => isEnabled);
+}
+export function assignPopulatedAnswersToEnableWhen(items, questionnaireResponse) {
+    const linkedQuestions = createEnableWhenLinkedQuestions(items);
+    const initialAnswers = readInitialAnswers(questionnaireResponse, linkedQuestions);
+    items = initialiseBooleanFalses(items);
+    const initialisedItems = Object.keys(initialAnswers).length > 0
+        ? setInitialAnswers(initialAnswers, items, linkedQuestions)
+        : items;
+    return { initialisedItems, linkedQuestions };
+}
+function initialiseBooleanFalses(items) {
+    for (const linkId in items) {
+        const checkedIsEnabledItems = [];
+        const enableWhenItemProperties = items[linkId];
+        for (const linkedItem of enableWhenItemProperties.linked) {
+            if (linkedItem.enableWhen.answerBoolean === true && linkedItem.enableWhen.operator === '!=') {
+                checkedIsEnabledItems.push(true);
+                continue;
+            }
+            if (linkedItem.enableWhen.answerBoolean === false && linkedItem.enableWhen.operator === '=') {
+                checkedIsEnabledItems.push(true);
+                continue;
+            }
+            checkedIsEnabledItems.push(false);
+        }
+        enableWhenItemProperties.isEnabled =
+            enableWhenItemProperties.enableBehavior === 'any'
+                ? checkedIsEnabledItems.some((isEnabled) => isEnabled)
+                : checkedIsEnabledItems.every((isEnabled) => isEnabled);
+    }
+    return items;
+}
+//# sourceMappingURL=enableWhen.js.map

package/src/utils/enableWhen.js.map

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

package/src/utils/enableWhen.ts

@@ -0,0 +1,303 @@
+/*
+ * 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 {
+  Quantity,
+  QuestionnaireItemEnableWhen,
+  QuestionnaireResponse,
+  QuestionnaireResponseItem,
+  QuestionnaireResponseItemAnswer
+} from 'fhir/r4';
+import cloneDeep from 'lodash.clonedeep';
+import type { EnableWhenItemProperties, EnableWhenItems } from '../interfaces/enableWhen.interface';
+
+/**
+ * Create a linkedQuestionsMap that contains linked items of enableWhen items
+ * mapped to an array containing all its respective enableWhen items' linkIds
+ * returns a key-value pair of <linkedItemId, [enableWhenItem1LinkId, enableWhenItem2LinkId, enableWhenItem3LinkId]>
+ *
+ * @author Sean Fong
+ */
+export function createEnableWhenLinkedQuestions(enableWhenItems: EnableWhenItems) {
+  const linkedQuestionsMap: Record<string, string[]> = {};
+
+  for (const linkId in enableWhenItems) {
+    enableWhenItems[linkId].linked.forEach((linkedItem) => {
+      const linkQId = linkedItem.enableWhen.question;
+      if (!linkedQuestionsMap[linkQId]) {
+        linkedQuestionsMap[linkQId] = [];
+      }
+
+      if (!linkedQuestionsMap[linkQId].includes(linkId)) {
+        linkedQuestionsMap[linkQId].push(linkId);
+      }
+    });
+  }
+  return linkedQuestionsMap;
+}
+
+/**
+ * Performs switching for non-group enableWhenItems based on their item types.
+ *
+ * @author Sean Fong
+ */
+export function isEnabledAnswerTypeSwitcher(
+  enableWhen: QuestionnaireItemEnableWhen,
+  answer: QuestionnaireResponseItemAnswer
+): boolean {
+  if (enableWhen['answerBoolean'] !== undefined && enableWhen.operator === 'exists') {
+    return answerOperatorSwitcher(enableWhen.answerBoolean, answer, enableWhen.operator);
+  } else if (enableWhen['answerBoolean'] !== undefined && answer.valueBoolean !== undefined) {
+    return answerOperatorSwitcher(
+      enableWhen.answerBoolean,
+      answer.valueBoolean,
+      enableWhen.operator
+    );
+  } else if (enableWhen['answerDecimal'] && answer.valueDecimal) {
+    return answerOperatorSwitcher(
+      enableWhen.answerDecimal,
+      answer.valueDecimal,
+      enableWhen.operator
+    );
+  } else if (enableWhen['answerInteger'] !== undefined && answer.valueInteger !== undefined) {
+    return answerOperatorSwitcher(
+      enableWhen.answerInteger,
+      answer.valueInteger,
+      enableWhen.operator
+    );
+  } else if (enableWhen['answerDate'] && answer.valueDate) {
+    return answerOperatorSwitcher(enableWhen.answerDate, answer.valueDate, enableWhen.operator);
+  } else if (enableWhen['answerDateTime'] && answer.valueDateTime) {
+    return answerOperatorSwitcher(
+      enableWhen.answerDateTime,
+      answer.valueDateTime,
+      enableWhen.operator
+    );
+  } else if (enableWhen['answerTime'] && answer.valueTime) {
+    return answerOperatorSwitcher(enableWhen.answerTime, answer.valueTime, enableWhen.operator);
+  } else if (enableWhen['answerString'] && answer.valueString) {
+    return answerOperatorSwitcher(enableWhen.answerString, answer.valueString, enableWhen.operator);
+  } else if (enableWhen['answerCoding']?.code && answer.valueCoding?.code) {
+    return answerOperatorSwitcher(
+      enableWhen.answerCoding.code,
+      answer.valueCoding.code,
+      enableWhen.operator
+    );
+  } else if (enableWhen['answerQuantity'] && answer.valueQuantity) {
+    return answerOperatorSwitcher(
+      enableWhen.answerQuantity,
+      answer.valueQuantity,
+      enableWhen.operator
+    );
+  }
+  return false;
+}
+
+/**
+ * Performs switching for value and expected comparisons based on given operator
+ *
+ * @author Sean Fong
+ */
+function answerOperatorSwitcher(
+  expected: boolean | string | number | Quantity,
+  value: boolean | string | number | Quantity | QuestionnaireResponseItemAnswer,
+  operator: QuestionnaireItemEnableWhen['operator']
+): boolean {
+  // FIXME runs even when the linked textbox is not changed
+  switch (operator) {
+    case 'exists':
+      // check if value is an object and contains any answerValues
+      return typeof value === 'object' && Object.keys(value).length !== 0;
+    case '=':
+      return value === expected;
+    case '!=':
+      return value !== expected;
+    case '<':
+      return value < expected;
+    case '<=':
+      return value <= expected;
+    case '>':
+      return value > expected;
+    case '>=':
+      return value >= expected;
+    default:
+      return false;
+  }
+}
+
+/**
+ * Read initial answer values in questionnaireResponse
+ * return a map of initial values with key-value pair <linkedItemId, initial value>
+ *
+ * @author Sean Fong
+ */
+export function readInitialAnswers(
+  questionnaireResponse: QuestionnaireResponse,
+  linkedQuestionsMap: Record<string, string[]>
+): Record<string, QuestionnaireResponseItemAnswer[]> {
+  if (!questionnaireResponse.item) return {};
+
+  const initialValuesMap: Record<string, QuestionnaireResponseItemAnswer[]> = {};
+  questionnaireResponse.item.forEach((item) => {
+    readQuestionnaireResponseItemRecursive(item, initialValuesMap, linkedQuestionsMap);
+  });
+  return initialValuesMap;
+}
+
+/**
+ * Read initial answer values of each qrItem recursively
+ *
+ * @author Sean Fong
+ */
+function readQuestionnaireResponseItemRecursive(
+  item: QuestionnaireResponseItem,
+  initialValues: Record<string, QuestionnaireResponseItemAnswer[]>,
+  linkedQuestionsMap: Record<string, string[]>
+) {
+  const items = item.item;
+  if (items && items.length > 0) {
+    // iterate through items of item recursively
+    items.forEach((item) => {
+      readQuestionnaireResponseItemRecursive(item, initialValues, linkedQuestionsMap);
+    });
+    return;
+  }
+
+  // Read initial answer value of single qrItem
+  if (linkedQuestionsMap[item.linkId] && item.answer) {
+    initialValues[item.linkId] = item.answer;
+  }
+
+  return;
+}
+
+/**
+ * Set initial answer values into enableWhenItems' answer attributes
+ * Update enabled status of each enableWhenItem simultaneously
+ *
+ * @author Sean Fong
+ */
+export function setInitialAnswers(
+  initialAnswers: Record<string, QuestionnaireResponseItemAnswer[]>,
+  items: EnableWhenItems,
+  linkedQuestionsMap: Record<string, string[]>
+): EnableWhenItems {
+  let updatedItems = cloneDeep(items);
+
+  if (initialAnswers) {
+    for (const linkId in initialAnswers) {
+      const linkedQuestions = linkedQuestionsMap[linkId];
+      const newAnswer = initialAnswers[linkId];
+
+      updatedItems = updateItemAnswer(updatedItems, linkedQuestions, linkId, newAnswer);
+    }
+  }
+  return updatedItems;
+}
+
+/**
+ * Update answer of the target linkId in every related enableWhenItem's linked items
+ * Then update the enabled status of every related enableWhenItem
+ *
+ * @author Sean Fong
+ */
+export function updateItemAnswer(
+  items: EnableWhenItems,
+  linkedQuestions: string[],
+  linkId: string,
+  newAnswer: QuestionnaireResponseItemAnswer[]
+): EnableWhenItems {
+  linkedQuestions.forEach((question) => {
+    // Update modified linked answer
+    items[question].linked.forEach((linkedItem) => {
+      if (linkedItem.enableWhen.question === linkId) {
+        linkedItem.answer = newAnswer ?? undefined;
+      }
+    });
+
+    // Update enabled status of modified enableWhenItem
+    items[question].isEnabled = checkItemIsEnabled(items[question]);
+  });
+  return items;
+}
+
+/**
+ * Check if an enableWhenItem is enabled based on the answer of its linked items
+ *
+ * @author Sean Fong
+ */
+export function checkItemIsEnabled(enableWhenItemProperties: EnableWhenItemProperties): boolean {
+  const checkedIsEnabledItems: boolean[] = [];
+
+  enableWhenItemProperties.linked.forEach((linkedItem) => {
+    if (linkedItem.answer && linkedItem.answer.length > 0) {
+      linkedItem.answer.forEach((answer) => {
+        checkedIsEnabledItems.push(isEnabledAnswerTypeSwitcher(linkedItem.enableWhen, answer));
+      });
+    }
+  });
+
+  if (checkedIsEnabledItems.length === 0) return false;
+
+  return enableWhenItemProperties.enableBehavior === 'any'
+    ? checkedIsEnabledItems.some((isEnabled) => isEnabled)
+    : checkedIsEnabledItems.every((isEnabled) => isEnabled);
+}
+
+export function assignPopulatedAnswersToEnableWhen(
+  items: EnableWhenItems,
+  questionnaireResponse: QuestionnaireResponse
+): { initialisedItems: EnableWhenItems; linkedQuestions: Record<string, string[]> } {
+  const linkedQuestions = createEnableWhenLinkedQuestions(items);
+  const initialAnswers = readInitialAnswers(questionnaireResponse, linkedQuestions);
+  items = initialiseBooleanFalses(items);
+
+  const initialisedItems =
+    Object.keys(initialAnswers).length > 0
+      ? setInitialAnswers(initialAnswers, items, linkedQuestions)
+      : items;
+
+  return { initialisedItems, linkedQuestions };
+}
+
+function initialiseBooleanFalses(items: EnableWhenItems): EnableWhenItems {
+  for (const linkId in items) {
+    const checkedIsEnabledItems: boolean[] = [];
+    const enableWhenItemProperties = items[linkId];
+
+    for (const linkedItem of enableWhenItemProperties.linked) {
+      if (linkedItem.enableWhen.answerBoolean === true && linkedItem.enableWhen.operator === '!=') {
+        checkedIsEnabledItems.push(true);
+        continue;
+      }
+
+      if (linkedItem.enableWhen.answerBoolean === false && linkedItem.enableWhen.operator === '=') {
+        checkedIsEnabledItems.push(true);
+        continue;
+      }
+
+      checkedIsEnabledItems.push(false);
+    }
+
+    enableWhenItemProperties.isEnabled =
+      enableWhenItemProperties.enableBehavior === 'any'
+        ? checkedIsEnabledItems.some((isEnabled) => isEnabled)
+        : checkedIsEnabledItems.every((isEnabled) => isEnabled);
+  }
+
+  return items;
+}