@welshare/questionnaire 0.1.2 → 0.2.0

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

@@ -1,578 +0,0 @@
-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

@@ -1,122 +0,0 @@
-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;
-};
-
-/**
- * Recursively searches for a questionnaire item by linkId
- */
-export function findQuestionnaireItem(
-  items: QuestionnaireItem[] | undefined,
-  linkId: string
-): QuestionnaireItem | null {
-  if (!items) return null;
-
-  for (const item of items) {
-    if (item.linkId === linkId) {
-      return item;
-    }
-    // Recursively search nested items
-    if (item.item && item.item.length > 0) {
-      const found = findQuestionnaireItem(item.item, linkId);
-      if (found) return found;
-    }
-  }
-
-  return null;
-}
-
-/**
- * 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;
-};