@welshare/questionnaire 0.1.0

package/dist/node_modules/@welshare/questionnaire/src/lib/__tests__/questionnaire-utils.test.ts

@@ -0,0 +1,578 @@
+import { describe, expect, it } from "vitest";
+import type { Questionnaire, QuestionnaireItem } from "../../types/fhir.js";
+import { getVisiblePages, getAllQuestionsFromPage } from "../questionnaire-utils.js";
+
+describe("questionnaire-utils", () => {
+  describe("getVisiblePages", () => {
+    it("should return empty array for questionnaire without items", () => {
+      const questionnaire: Questionnaire = {
+        resourceType: "Questionnaire",
+        id: "test-1",
+        status: "active",
+      };
+
+      const result = getVisiblePages(questionnaire);
+      expect(result).toEqual([]);
+    });
+
+    it("should return empty array for questionnaire with null items", () => {
+      const questionnaire: Questionnaire = {
+        resourceType: "Questionnaire",
+        id: "test-2",
+        status: "active",
+        item: undefined,
+      };
+
+      const result = getVisiblePages(questionnaire);
+      expect(result).toEqual([]);
+    });
+
+    it("should return visible group items only", () => {
+      const questionnaire: Questionnaire = {
+        resourceType: "Questionnaire",
+        id: "test-3",
+        status: "active",
+        item: [
+          {
+            linkId: "page1",
+            type: "group",
+            text: "Page 1",
+          },
+          {
+            linkId: "page2",
+            type: "group",
+            text: "Page 2",
+          },
+          {
+            linkId: "q1",
+            type: "string",
+            text: "Question 1",
+          },
+        ],
+      };
+
+      const result = getVisiblePages(questionnaire);
+      expect(result).toHaveLength(2);
+      expect(result[0].linkId).toBe("page1");
+      expect(result[1].linkId).toBe("page2");
+    });
+
+    it("should exclude hidden group items", () => {
+      const questionnaire: Questionnaire = {
+        resourceType: "Questionnaire",
+        id: "test-4",
+        status: "active",
+        item: [
+          {
+            linkId: "page1",
+            type: "group",
+            text: "Page 1",
+          },
+          {
+            linkId: "page2",
+            type: "group",
+            text: "Page 2",
+            extension: [
+              {
+                url: "http://hl7.org/fhir/StructureDefinition/questionnaire-hidden",
+                valueBoolean: true,
+              },
+            ],
+          },
+          {
+            linkId: "page3",
+            type: "group",
+            text: "Page 3",
+          },
+        ],
+      };
+
+      const result = getVisiblePages(questionnaire);
+      expect(result).toHaveLength(2);
+      expect(result[0].linkId).toBe("page1");
+      expect(result[1].linkId).toBe("page3");
+    });
+
+    it("should exclude non-group items", () => {
+      const questionnaire: Questionnaire = {
+        resourceType: "Questionnaire",
+        id: "test-5",
+        status: "active",
+        item: [
+          {
+            linkId: "page1",
+            type: "group",
+            text: "Page 1",
+          },
+          {
+            linkId: "q1",
+            type: "string",
+            text: "Question 1",
+          },
+          {
+            linkId: "q2",
+            type: "boolean",
+            text: "Question 2",
+          },
+        ],
+      };
+
+      const result = getVisiblePages(questionnaire);
+      expect(result).toHaveLength(1);
+      expect(result[0].linkId).toBe("page1");
+    });
+
+    it("should handle group with hidden extension set to false", () => {
+      const questionnaire: Questionnaire = {
+        resourceType: "Questionnaire",
+        id: "test-6",
+        status: "active",
+        item: [
+          {
+            linkId: "page1",
+            type: "group",
+            text: "Page 1",
+            extension: [
+              {
+                url: "http://hl7.org/fhir/StructureDefinition/questionnaire-hidden",
+                valueBoolean: false,
+              },
+            ],
+          },
+        ],
+      };
+
+      const result = getVisiblePages(questionnaire);
+      expect(result).toHaveLength(1);
+      expect(result[0].linkId).toBe("page1");
+    });
+
+    it("should handle nested group structures", () => {
+      const questionnaire: Questionnaire = {
+        resourceType: "Questionnaire",
+        id: "test-7",
+        status: "active",
+        item: [
+          {
+            linkId: "page1",
+            type: "group",
+            text: "Page 1",
+            item: [
+              {
+                linkId: "nested-group",
+                type: "group",
+                text: "Nested Group",
+              },
+            ],
+          },
+          {
+            linkId: "page2",
+            type: "group",
+            text: "Page 2",
+          },
+        ],
+      };
+
+      const result = getVisiblePages(questionnaire);
+      expect(result).toHaveLength(2);
+      expect(result[0].linkId).toBe("page1");
+      expect(result[1].linkId).toBe("page2");
+    });
+  });
+
+  describe("getAllQuestionsFromPage", () => {
+    it("should return empty array for page without items", () => {
+      const pageItem: QuestionnaireItem = {
+        linkId: "page1",
+        type: "group",
+        text: "Page 1",
+      };
+
+      const result = getAllQuestionsFromPage(pageItem);
+      expect(result).toEqual([]);
+    });
+
+    it("should return empty array for page with null items", () => {
+      const pageItem: QuestionnaireItem = {
+        linkId: "page1",
+        type: "group",
+        text: "Page 1",
+        item: undefined,
+      };
+
+      const result = getAllQuestionsFromPage(pageItem);
+      expect(result).toEqual([]);
+    });
+
+    it("should return all questions from a flat page", () => {
+      const pageItem: QuestionnaireItem = {
+        linkId: "page1",
+        type: "group",
+        text: "Page 1",
+        item: [
+          {
+            linkId: "q1",
+            type: "string",
+            text: "Question 1",
+          },
+          {
+            linkId: "q2",
+            type: "boolean",
+            text: "Question 2",
+          },
+          {
+            linkId: "q3",
+            type: "integer",
+            text: "Question 3",
+          },
+        ],
+      };
+
+      const result = getAllQuestionsFromPage(pageItem);
+      expect(result).toHaveLength(3);
+      expect(result[0].linkId).toBe("q1");
+      expect(result[1].linkId).toBe("q2");
+      expect(result[2].linkId).toBe("q3");
+    });
+
+    it("should exclude display items", () => {
+      const pageItem: QuestionnaireItem = {
+        linkId: "page1",
+        type: "group",
+        text: "Page 1",
+        item: [
+          {
+            linkId: "display1",
+            type: "display",
+            text: "This is a display item",
+          },
+          {
+            linkId: "q1",
+            type: "string",
+            text: "Question 1",
+          },
+          {
+            linkId: "display2",
+            type: "display",
+            text: "Another display item",
+          },
+          {
+            linkId: "q2",
+            type: "boolean",
+            text: "Question 2",
+          },
+        ],
+      };
+
+      const result = getAllQuestionsFromPage(pageItem);
+      expect(result).toHaveLength(2);
+      expect(result[0].linkId).toBe("q1");
+      expect(result[1].linkId).toBe("q2");
+    });
+
+    it("should flatten questions from nested groups", () => {
+      const pageItem: QuestionnaireItem = {
+        linkId: "page1",
+        type: "group",
+        text: "Page 1",
+        item: [
+          {
+            linkId: "q1",
+            type: "string",
+            text: "Question 1",
+          },
+          {
+            linkId: "nested-group",
+            type: "group",
+            text: "Nested Group",
+            item: [
+              {
+                linkId: "q2",
+                type: "boolean",
+                text: "Question 2",
+              },
+              {
+                linkId: "q3",
+                type: "integer",
+                text: "Question 3",
+              },
+            ],
+          },
+          {
+            linkId: "q4",
+            type: "decimal",
+            text: "Question 4",
+          },
+        ],
+      };
+
+      const result = getAllQuestionsFromPage(pageItem);
+      expect(result).toHaveLength(4);
+      expect(result[0].linkId).toBe("q1");
+      expect(result[1].linkId).toBe("q2");
+      expect(result[2].linkId).toBe("q3");
+      expect(result[3].linkId).toBe("q4");
+    });
+
+    it("should handle deeply nested groups", () => {
+      const pageItem: QuestionnaireItem = {
+        linkId: "page1",
+        type: "group",
+        text: "Page 1",
+        item: [
+          {
+            linkId: "q1",
+            type: "string",
+            text: "Question 1",
+          },
+          {
+            linkId: "level1-group",
+            type: "group",
+            text: "Level 1 Group",
+            item: [
+              {
+                linkId: "q2",
+                type: "boolean",
+                text: "Question 2",
+              },
+              {
+                linkId: "level2-group",
+                type: "group",
+                text: "Level 2 Group",
+                item: [
+                  {
+                    linkId: "q3",
+                    type: "integer",
+                    text: "Question 3",
+                  },
+                  {
+                    linkId: "level3-group",
+                    type: "group",
+                    text: "Level 3 Group",
+                    item: [
+                      {
+                        linkId: "q4",
+                        type: "decimal",
+                        text: "Question 4",
+                      },
+                    ],
+                  },
+                ],
+              },
+            ],
+          },
+          {
+            linkId: "q5",
+            type: "date",
+            text: "Question 5",
+          },
+        ],
+      };
+
+      const result = getAllQuestionsFromPage(pageItem);
+      expect(result).toHaveLength(5);
+      expect(result[0].linkId).toBe("q1");
+      expect(result[1].linkId).toBe("q2");
+      expect(result[2].linkId).toBe("q3");
+      expect(result[3].linkId).toBe("q4");
+      expect(result[4].linkId).toBe("q5");
+    });
+
+    it("should exclude display items from nested groups", () => {
+      const pageItem: QuestionnaireItem = {
+        linkId: "page1",
+        type: "group",
+        text: "Page 1",
+        item: [
+          {
+            linkId: "q1",
+            type: "string",
+            text: "Question 1",
+          },
+          {
+            linkId: "nested-group",
+            type: "group",
+            text: "Nested Group",
+            item: [
+              {
+                linkId: "display1",
+                type: "display",
+                text: "Display in nested group",
+              },
+              {
+                linkId: "q2",
+                type: "boolean",
+                text: "Question 2",
+              },
+            ],
+          },
+        ],
+      };
+
+      const result = getAllQuestionsFromPage(pageItem);
+      expect(result).toHaveLength(2);
+      expect(result[0].linkId).toBe("q1");
+      expect(result[1].linkId).toBe("q2");
+    });
+
+    it("should handle mixed nested groups and questions", () => {
+      const pageItem: QuestionnaireItem = {
+        linkId: "page1",
+        type: "group",
+        text: "Page 1",
+        item: [
+          {
+            linkId: "section1",
+            type: "group",
+            text: "Section 1",
+            item: [
+              {
+                linkId: "q1",
+                type: "string",
+                text: "Question 1",
+              },
+              {
+                linkId: "q2",
+                type: "boolean",
+                text: "Question 2",
+              },
+            ],
+          },
+          {
+            linkId: "q3",
+            type: "integer",
+            text: "Question 3",
+          },
+          {
+            linkId: "section2",
+            type: "group",
+            text: "Section 2",
+            item: [
+              {
+                linkId: "subsection",
+                type: "group",
+                text: "Subsection",
+                item: [
+                  {
+                    linkId: "q4",
+                    type: "decimal",
+                    text: "Question 4",
+                  },
+                ],
+              },
+              {
+                linkId: "q5",
+                type: "date",
+                text: "Question 5",
+              },
+            ],
+          },
+        ],
+      };
+
+      const result = getAllQuestionsFromPage(pageItem);
+      expect(result).toHaveLength(5);
+      expect(result.map((q) => q.linkId)).toEqual(["q1", "q2", "q3", "q4", "q5"]);
+    });
+
+    it("should handle all question types", () => {
+      const pageItem: QuestionnaireItem = {
+        linkId: "page1",
+        type: "group",
+        text: "Page 1",
+        item: [
+          {
+            linkId: "q1",
+            type: "boolean",
+            text: "Boolean question",
+          },
+          {
+            linkId: "q2",
+            type: "decimal",
+            text: "Decimal question",
+          },
+          {
+            linkId: "q3",
+            type: "integer",
+            text: "Integer question",
+          },
+          {
+            linkId: "q4",
+            type: "date",
+            text: "Date question",
+          },
+          {
+            linkId: "q5",
+            type: "dateTime",
+            text: "DateTime question",
+          },
+          {
+            linkId: "q6",
+            type: "time",
+            text: "Time question",
+          },
+          {
+            linkId: "q7",
+            type: "string",
+            text: "String question",
+          },
+          {
+            linkId: "q8",
+            type: "text",
+            text: "Text question",
+          },
+          {
+            linkId: "q9",
+            type: "url",
+            text: "URL question",
+          },
+          {
+            linkId: "q10",
+            type: "choice",
+            text: "Choice question",
+          },
+          {
+            linkId: "q11",
+            type: "open-choice",
+            text: "Open choice question",
+          },
+          {
+            linkId: "q12",
+            type: "attachment",
+            text: "Attachment question",
+          },
+          {
+            linkId: "q13",
+            type: "reference",
+            text: "Reference question",
+          },
+          {
+            linkId: "q14",
+            type: "quantity",
+            text: "Quantity question",
+          },
+        ],
+      };
+
+      const result = getAllQuestionsFromPage(pageItem);
+      expect(result).toHaveLength(14);
+      expect(result.map((q) => q.type)).toEqual([
+        "boolean",
+        "decimal",
+        "integer",
+        "date",
+        "dateTime",
+        "time",
+        "string",
+        "text",
+        "url",
+        "choice",
+        "open-choice",
+        "attachment",
+        "reference",
+        "quantity",
+      ]);
+    });
+  });
+});
+

package/dist/node_modules/@welshare/questionnaire/src/lib/questionnaire-utils.ts

@@ -0,0 +1,99 @@
+import type { Questionnaire, QuestionnaireItem } from "../types/fhir.js";
+
+/**
+ * Get visible pages from a questionnaire (excludes hidden groups)
+ */
+export const getVisiblePages = (questionnaire: Questionnaire): QuestionnaireItem[] => {
+  if (!questionnaire.item) return [];
+
+  return questionnaire.item.filter((item) => {
+    // Check if hidden
+    const isHidden = item.extension?.some(
+      (ext) =>
+        ext.url === "http://hl7.org/fhir/StructureDefinition/questionnaire-hidden" &&
+        ext.valueBoolean === true
+    );
+
+    // Only include visible group items
+    return item.type === "group" && !isHidden;
+  });
+};
+
+/**
+ * Calculate progress percentage
+ * @param currentPageIndex 0-based page index
+ * @param totalPages Total number of pages
+ * @returns Progress percentage (0-100)
+ */
+export const calculateProgress = (currentPageIndex: number, totalPages: number): number => {
+  if (totalPages === 0) return 0;
+  return ((currentPageIndex + 1) / totalPages) * 100;
+};
+
+/**
+ * Get all questions from a page (flattens nested groups)
+ */
+export const getAllQuestionsFromPage = (pageItem: QuestionnaireItem): QuestionnaireItem[] => {
+  const questions: QuestionnaireItem[] = [];
+
+  const collectQuestions = (items?: QuestionnaireItem[]) => {
+    if (!items) return;
+
+    for (const item of items) {
+      if (item.type === "group" && item.item) {
+        // Recursively collect from nested groups
+        collectQuestions(item.item);
+      } else if (item.type !== "display") {
+        // Add non-display items (actual questions)
+        questions.push(item);
+      }
+    }
+  };
+
+  if (pageItem.item) {
+    collectQuestions(pageItem.item);
+  }
+
+  return questions;
+};
+
+/**
+ * Check if a question has any answer value
+ */
+export const hasAnswerValue = (answer: any): boolean => {
+  if (!answer) return false;
+
+  return (
+    answer.valueBoolean !== undefined ||
+    answer.valueInteger !== undefined ||
+    answer.valueDecimal !== undefined ||
+    answer.valueString !== undefined ||
+    answer.valueCoding !== undefined ||
+    answer.valueDate !== undefined ||
+    answer.valueDateTime !== undefined ||
+    answer.valueTime !== undefined ||
+    answer.valueUri !== undefined ||
+    answer.valueQuantity !== undefined
+  );
+};
+
+/**
+ * Check if a question item should be hidden based on extensions
+ */
+export const isQuestionHidden = (item: QuestionnaireItem): boolean => {
+  return item.extension?.some(
+    (ext) =>
+      ext.url === "http://hl7.org/fhir/StructureDefinition/questionnaire-hidden" &&
+      ext.valueBoolean === true
+  ) ?? false;
+};
+
+/**
+ * Get the exclusive option code from a question item (if any)
+ */
+export const getExclusiveOptionCode = (item: QuestionnaireItem): string | undefined => {
+  const exclusiveExt = item.extension?.find(
+    (ext) => ext.url === "http://codes.welshare.app/StructureDefinition/questionnaire-exclusive-option"
+  );
+  return exclusiveExt?.valueString;
+};