@aehrc/smart-forms-renderer 0.44.3 → 0.44.4

package/lib/src/interfaces/renderProps.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderProps.interface.js","sourceRoot":"","sources":["../../../src/interfaces/renderProps.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/lib/src/interfaces/repeatGroup.interface.d.ts

@@ -0,0 +1,9 @@
+import type { QuestionnaireResponseItem } from 'fhir/r4';
+export interface QrRepeatGroup {
+    linkId: string;
+    qrItems: QuestionnaireResponseItem[];
+}
+export interface RepeatGroupSingleModel {
+    id: string;
+    qrItem: QuestionnaireResponseItem | null;
+}

package/lib/src/interfaces/repeatGroup.interface.js

@@ -0,0 +1,18 @@
+/*
+ * Copyright 2024 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 {};
+//# sourceMappingURL=repeatGroup.interface.js.map

package/lib/src/interfaces/repeatGroup.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repeatGroup.interface.js","sourceRoot":"","sources":["../../../src/interfaces/repeatGroup.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/lib/src/interfaces/tab.interface.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tab interface
+ *
+ * @property tabIndex - The index of the tab
+ * @property isComplete - Whether the tab is marked as complete
+ * @property isHidden - Whether the tab is hidden
+ */
+export type Tab = {
+    tabIndex: number;
+    isComplete: boolean;
+    isHidden: boolean;
+};
+/**
+ * Key-value pair of tabs `Record<linkId, Tab>`
+ */
+export type Tabs = Record<string, Tab>;

package/lib/src/interfaces/tab.interface.js

@@ -0,0 +1,18 @@
+/*
+ * Copyright 2024 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 {};
+//# sourceMappingURL=tab.interface.js.map

package/lib/src/interfaces/tab.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tab.interface.js","sourceRoot":"","sources":["../../../src/interfaces/tab.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/lib/src/interfaces/valueSet.interface.d.ts

@@ -0,0 +1,20 @@
+import type { ValueSet } from 'fhir/r4';
+export interface ValueSetPromise {
+    promise: Promise<ValueSet>;
+    valueSet?: ValueSet;
+}
+export interface ValidateCodeResponse extends Parameters<any> {
+    parameter: [SystemParameter, CodeParameter, DisplayParameter];
+}
+export interface SystemParameter {
+    name: 'system';
+    valueUri: string;
+}
+export interface CodeParameter {
+    name: 'code';
+    valueCode: string;
+}
+export interface DisplayParameter {
+    name: 'display';
+    valueString: string;
+}

package/lib/src/interfaces/valueSet.interface.js

@@ -0,0 +1,18 @@
+/*
+ * Copyright 2024 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 {};
+//# sourceMappingURL=valueSet.interface.js.map

package/lib/src/interfaces/valueSet.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"valueSet.interface.js","sourceRoot":"","sources":["../../../src/interfaces/valueSet.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/lib/src/interfaces/variables.interface.d.ts

@@ -0,0 +1,21 @@
+import type { Expression, FhirResource } from 'fhir/r4';
+/**
+ * Variables interface
+ *
+ * @property fhirPathVariables - Key-value pair of FHIRPath variable expressions in a Questionnaire item `Record<linkId, array of FHIRPath expressions>`
+ * @property xFhirQueryVariables - Key-value pair of x-fhir-query variables `Record<variable name, x-fhir-query variable properties>`
+ */
+export interface Variables {
+    fhirPathVariables: Record<string, Expression[]>;
+    xFhirQueryVariables: Record<string, VariableXFhirQuery>;
+}
+/**
+ * VariableXFhirQuery interface
+ *
+ * @property valueExpression - FHIRPath Expression of the variable
+ * @property result - FHIR resource result of the executed query
+ */
+export interface VariableXFhirQuery {
+    valueExpression: Expression;
+    result?: FhirResource;
+}

package/lib/src/interfaces/variables.interface.js

@@ -0,0 +1,18 @@
+/*
+ * Copyright 2024 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 {};
+//# sourceMappingURL=variables.interface.js.map

package/lib/src/interfaces/variables.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables.interface.js","sourceRoot":"","sources":["../../../src/interfaces/variables.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/lib/src/stores/index.d.ts

@@ -0,0 +1,8 @@
+export type { QuestionnaireStoreType } from './questionnaireStore';
+export { questionnaireStore, useQuestionnaireStore } from './questionnaireStore';
+export type { QuestionnaireResponseStoreType } from './questionnaireResponseStore';
+export { questionnaireResponseStore, useQuestionnaireResponseStore } from './questionnaireResponseStore';
+export type { SmartConfigStoreType } from './smartConfigStore';
+export { smartConfigStore, useSmartConfigStore } from './smartConfigStore';
+export type { TerminologyServerStoreType } from './terminologyServerStore';
+export { terminologyServerStore, useTerminologyServerStore } from './terminologyServerStore';

package/lib/src/stores/index.js

@@ -0,0 +1,5 @@
+export { questionnaireStore, useQuestionnaireStore } from './questionnaireStore';
+export { questionnaireResponseStore, useQuestionnaireResponseStore } from './questionnaireResponseStore';
+export { smartConfigStore, useSmartConfigStore } from './smartConfigStore';
+export { terminologyServerStore, useTerminologyServerStore } from './terminologyServerStore';
+//# sourceMappingURL=index.js.map

package/lib/src/stores/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/stores/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGjF,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC9B,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG3E,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC"}

package/lib/src/stores/questionnaireResponseStore.d.ts

@@ -0,0 +1,74 @@
+import type { OperationOutcome, Questionnaire, QuestionnaireResponse, QuestionnaireResponseItem } from 'fhir/r4';
+import type { Diff } from 'deep-diff';
+/**
+ * QuestionnaireResponseStore properties and methods
+ * Properties can be accessed for fine-grain details.
+ * Methods are usually used internally, using them from an external source is not recommended.
+ *
+ * @property key - The React key of the questionnaireResponse, used internally for refreshing the BaseRenderer
+ * @property sourceResponse - The original response created when the form is first initialised i.e. empty, pre-populated, opened saved draft
+ * @property updatableResponse - The current state of the response that is being updated via form fields
+ * @property updatableResponseItems - Key-value pair of updatableResponse items `Record<linkId, QR.item(s)>`
+ * @property formChangesHistory - Array of form changes history in the form of deep-diff objects
+ * @property invalidItems - Key-value pair of invalid items based on defined value constraints in the questionnaire `Record<linkId, OperationOutcome>`
+ * @property responseIsValid - Whether there are any invalid items in the response
+ * @property validateQuestionnaire - Used to validate the questionnaire response based on the questionnaire
+ * @property buildSourceResponse - Used to build the source response when the form is first initialised
+ * @property setUpdatableResponseAsPopulated - Used to set a pre-populated response as the current response
+ * @property updateResponse - Used to update the current response
+ * @property setUpdatableResponseAsSaved - Used to set a saved response as the current response
+ * @property setUpdatableResponseAsEmpty - Used to set an empty response as the current response
+ * @property destroySourceResponse - Used to destroy the source response  and reset all properties
+ *
+ * @author Sean Fong
+ */
+export interface QuestionnaireResponseStoreType {
+    key: string;
+    sourceResponse: QuestionnaireResponse;
+    updatableResponse: QuestionnaireResponse;
+    updatableResponseItems: Record<string, QuestionnaireResponseItem[]>;
+    formChangesHistory: (Diff<QuestionnaireResponse, QuestionnaireResponse>[] | null)[];
+    invalidItems: Record<string, OperationOutcome>;
+    responseIsValid: boolean;
+    validateQuestionnaire: (questionnaire: Questionnaire, updatedResponse: QuestionnaireResponse) => void;
+    buildSourceResponse: (response: QuestionnaireResponse) => void;
+    setUpdatableResponseAsPopulated: (populatedResponse: QuestionnaireResponse) => void;
+    updateResponse: (updatedResponse: QuestionnaireResponse) => void;
+    setUpdatableResponseAsSaved: (savedResponse: QuestionnaireResponse) => void;
+    setUpdatableResponseAsEmpty: (clearedResponse: QuestionnaireResponse) => void;
+    destroySourceResponse: () => void;
+}
+/**
+ * QuestionnaireResponse state management store which contains all properties and methods to manage the state of the questionnaireResponse.
+ * This is the vanilla version of the store which can be used in non-React environments.
+ * @see QuestionnaireResponseStoreType for available properties and methods.
+ *
+ * @author Sean Fong
+ */
+export declare const questionnaireResponseStore: import("zustand/vanilla").StoreApi<QuestionnaireResponseStoreType>;
+/**
+ * QuestionnaireResponse state management store which contains all properties and methods to manage the state of the questionnaire.
+ * This is the React version of the store which can be used as React hooks in React functional components.
+ * @see QuestionnaireResponseStoreType for available properties and methods.
+ * @see questionnaireResponseStore for the vanilla store.
+ *
+ * @author Sean Fong
+ */
+export declare const useQuestionnaireResponseStore: import("zustand/vanilla").StoreApi<QuestionnaireResponseStoreType> & {
+    use: {
+        key: () => string;
+        sourceResponse: () => QuestionnaireResponse;
+        updatableResponse: () => QuestionnaireResponse;
+        updatableResponseItems: () => Record<string, QuestionnaireResponseItem[]>;
+        formChangesHistory: () => (Diff<QuestionnaireResponse, QuestionnaireResponse>[] | null)[];
+        invalidItems: () => Record<string, OperationOutcome>;
+        responseIsValid: () => boolean;
+        validateQuestionnaire: () => (questionnaire: Questionnaire, updatedResponse: QuestionnaireResponse) => void;
+        buildSourceResponse: () => (response: QuestionnaireResponse) => void;
+        setUpdatableResponseAsPopulated: () => (populatedResponse: QuestionnaireResponse) => void;
+        updateResponse: () => (updatedResponse: QuestionnaireResponse) => void;
+        setUpdatableResponseAsSaved: () => (savedResponse: QuestionnaireResponse) => void;
+        setUpdatableResponseAsEmpty: () => (clearedResponse: QuestionnaireResponse) => void;
+        destroySourceResponse: () => () => void;
+    };
+};

package/lib/src/stores/questionnaireResponseStore.js

@@ -0,0 +1,146 @@
+/*
+ * Copyright 2024 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 { createStore } from 'zustand/vanilla';
+import { emptyResponse } from '../utils/emptyResource';
+import { diff } from 'deep-diff';
+import { createSelectors } from './selector';
+import { validateQuestionnaire } from '../utils/validateQuestionnaire';
+import { questionnaireStore } from './questionnaireStore';
+import { createQuestionnaireResponseItemMap } from '../utils/questionnaireResponseStoreUtils/updatableResponseItems';
+import { generateUniqueId } from '../utils/extractObservation';
+/**
+ * QuestionnaireResponse state management store which contains all properties and methods to manage the state of the questionnaireResponse.
+ * This is the vanilla version of the store which can be used in non-React environments.
+ * @see QuestionnaireResponseStoreType for available properties and methods.
+ *
+ * @author Sean Fong
+ */
+export const questionnaireResponseStore = createStore()((set, get) => ({
+    key: 'QR-initial-key',
+    sourceResponse: structuredClone(emptyResponse),
+    updatableResponse: structuredClone(emptyResponse),
+    updatableResponseItems: {},
+    formChangesHistory: [],
+    invalidItems: {},
+    responseIsValid: true,
+    validateQuestionnaire: (questionnaire, updatedResponse) => {
+        const updatedInvalidItems = validateQuestionnaire({
+            questionnaire,
+            questionnaireResponse: updatedResponse
+        });
+        set(() => ({
+            invalidItems: updatedInvalidItems,
+            responseIsValid: Object.keys(updatedInvalidItems).length === 0
+        }));
+    },
+    buildSourceResponse: (questionnaireResponse) => {
+        const sourceQuestionnaire = questionnaireStore.getState().sourceQuestionnaire;
+        const initialInvalidItems = validateQuestionnaire({
+            questionnaire: sourceQuestionnaire,
+            questionnaireResponse: questionnaireResponse
+        });
+        set(() => ({
+            key: generateUniqueId('QR'),
+            sourceResponse: questionnaireResponse,
+            updatableResponse: questionnaireResponse,
+            updatableResponseItems: createQuestionnaireResponseItemMap(questionnaireResponse),
+            invalidItems: initialInvalidItems,
+            responseIsValid: Object.keys(initialInvalidItems).length === 0
+        }));
+    },
+    setUpdatableResponseAsPopulated: (populatedResponse) => {
+        var _a;
+        const sourceQuestionnaire = questionnaireStore.getState().sourceQuestionnaire;
+        const formChanges = (_a = diff(get().updatableResponse, populatedResponse)) !== null && _a !== void 0 ? _a : null;
+        const updatedInvalidItems = validateQuestionnaire({
+            questionnaire: sourceQuestionnaire,
+            questionnaireResponse: populatedResponse
+        });
+        set(() => ({
+            updatableResponse: populatedResponse,
+            updatableResponseItems: createQuestionnaireResponseItemMap(populatedResponse),
+            formChangesHistory: [...get().formChangesHistory, formChanges],
+            invalidItems: updatedInvalidItems,
+            responseIsValid: Object.keys(updatedInvalidItems).length === 0
+        }));
+    },
+    updateResponse: (updatedResponse) => {
+        var _a;
+        const sourceQuestionnaire = questionnaireStore.getState().sourceQuestionnaire;
+        const formChanges = (_a = diff(get().updatableResponse, updatedResponse)) !== null && _a !== void 0 ? _a : null;
+        const updatedInvalidItems = validateQuestionnaire({
+            questionnaire: sourceQuestionnaire,
+            questionnaireResponse: updatedResponse
+        });
+        set(() => ({
+            updatableResponse: updatedResponse,
+            updatableResponseItems: createQuestionnaireResponseItemMap(updatedResponse),
+            formChangesHistory: [...get().formChangesHistory, formChanges],
+            invalidItems: updatedInvalidItems,
+            responseIsValid: Object.keys(updatedInvalidItems).length === 0
+        }));
+    },
+    setUpdatableResponseAsSaved: (savedResponse) => {
+        const sourceQuestionnaire = questionnaireStore.getState().sourceQuestionnaire;
+        const updatedInvalidItems = validateQuestionnaire({
+            questionnaire: sourceQuestionnaire,
+            questionnaireResponse: savedResponse
+        });
+        set(() => ({
+            key: generateUniqueId('QR'),
+            sourceResponse: savedResponse,
+            updatableResponse: savedResponse,
+            updatableResponseItems: createQuestionnaireResponseItemMap(savedResponse),
+            formChangesHistory: [],
+            invalidItems: updatedInvalidItems,
+            responseIsValid: Object.keys(updatedInvalidItems).length === 0
+        }));
+    },
+    setUpdatableResponseAsEmpty: (clearedResponse) => {
+        const sourceQuestionnaire = questionnaireStore.getState().sourceQuestionnaire;
+        const updatedInvalidItems = validateQuestionnaire({
+            questionnaire: sourceQuestionnaire,
+            questionnaireResponse: clearedResponse
+        });
+        set(() => ({
+            updatableResponse: clearedResponse,
+            updatableResponseItems: createQuestionnaireResponseItemMap(clearedResponse),
+            formChangesHistory: [],
+            invalidItems: updatedInvalidItems,
+            responseIsValid: Object.keys(updatedInvalidItems).length === 0
+        }));
+    },
+    destroySourceResponse: () => set(() => ({
+        key: generateUniqueId('QR'),
+        sourceResponse: structuredClone(emptyResponse),
+        updatableResponse: structuredClone(emptyResponse),
+        updatableResponseItems: createQuestionnaireResponseItemMap(structuredClone(emptyResponse)),
+        formChangesHistory: [],
+        invalidItems: {},
+        responseIsValid: true
+    }))
+}));
+/**
+ * QuestionnaireResponse state management store which contains all properties and methods to manage the state of the questionnaire.
+ * This is the React version of the store which can be used as React hooks in React functional components.
+ * @see QuestionnaireResponseStoreType for available properties and methods.
+ * @see questionnaireResponseStore for the vanilla store.
+ *
+ * @author Sean Fong
+ */
+export const useQuestionnaireResponseStore = createSelectors(questionnaireResponseStore);
+//# sourceMappingURL=questionnaireResponseStore.js.map

package/lib/src/stores/questionnaireResponseStore.js.map

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

package/lib/src/stores/questionnaireStore.d.ts

@@ -0,0 +1,152 @@
+import type { Coding, Questionnaire, QuestionnaireResponse, QuestionnaireResponseItemAnswer } from 'fhir/r4';
+import type { Variables } from '../interfaces/variables.interface';
+import type { LaunchContext } from '../interfaces/populate.interface';
+import type { CalculatedExpression } from '../interfaces/calculatedExpression.interface';
+import type { EnableWhenExpressions, EnableWhenItems } from '../interfaces/enableWhen.interface';
+import type { AnswerExpression } from '../interfaces/answerExpression.interface';
+import type { Tabs } from '../interfaces/tab.interface';
+import type { Pages } from '../interfaces/page.interface';
+import type { InitialExpression } from '../interfaces/initialExpression.interface';
+/**
+ * QuestionnaireStore properties and methods
+ * Properties can be accessed for fine-grain details.
+ * Methods are usually used internally, using them from an external source is not recommended.
+ *
+ * @property sourceQuestionnaire - FHIR R4 Questionnaire to render
+ * @property itemTypes - Key-value pair of item types `Record<linkId, item.type>`
+ * @property itemPreferredTerminologyServers - Key-value pair of item types `Record<linkId, preferred terminology servers>`
+ * @property tabs - Key-value pair of tabs `Record<linkId, Tab>`
+ * @property currentTabIndex - Index of the current tab
+ * @property pages - Key-value pair of pages `Record<linkId, Page>`
+ * @property currentPageIndex - Index of the current page
+ * @property variables - Questionnaire variables object containing FHIRPath and x-fhir-query variables
+ * @property launchContexts - Key-value pair of launch contexts `Record<launch context name, launch context properties>`
+ * @property enableWhenItems - EnableWhenItems object containing enableWhen items and their linked questions
+ * @property enableWhenLinkedQuestions - Key-value pair of linked questions to enableWhen items `Record<linkId, linkIds of linked questions>`
+ * @property enableWhenIsActivated - Flag to turn enableWhen checks on/off
+ * @property enableWhenExpressions - EnableWhenExpressions object containing enableWhen expressions
+ * @property calculatedExpressions - Key-value pair of calculated expressions `Record<linkId, array of calculated expression properties>`
+ * @property answerExpressions - Key-value pair of answer expressions `Record<linkId, answer expression properties>`
+ * @property processedValueSetCodings - Key-value pair of processed value set codings `Record<valueSetUrl, codings>`
+ * @property processedValueSetUrls - Key-value pair of contained value set urls `Record<valueSetName, valueSetUrl>`
+ * @property cachedValueSetCodings - Key-value pair of cached value set codings `Record<valueSetUrl, codings>`
+ * @property fhirPathContext - Key-value pair of evaluated FHIRPath values `Record<variable name, evaluated value(s)>`
+ * @property populatedContext - Key-value pair of one-off pre-populated FHIRPath values `Record<variable/launchContext/sourceQueries batch name, evaluated value(s)>`
+ * @property focusedLinkId - LinkId of the currently focused item
+ * @property readOnly - Flag to set the form to read-only mode
+ * @property buildSourceQuestionnaire - Used to build the source questionnaire with the provided questionnaire and optionally questionnaire response, additional variables, terminology server url and readyOnly flag
+ * @property destroySourceQuestionnaire - Used to destroy the source questionnaire and reset all properties
+ * @property switchTab - Used to switch the current tab index
+ * @property switchPage - Used to switch the current page index
+ * @property markTabAsComplete - Used to mark a tab index as complete
+ * @property markPageAsComplete - Used to mark a page index as complete
+ * @property updateEnableWhenItem - Used to update linked enableWhen items by updating a question with a new answer
+ * @property mutateRepeatEnableWhenItems - Used to add or remove instances of repeating enableWhen items
+ * @property toggleEnableWhenActivation - Used to toggle enableWhen checks on/off
+ * @property updateExpressions - Used to update all SDC expressions based on the updated questionnaire response
+ * @property addCodingToCache - Used to add a coding to the cached value set codings
+ * @property updatePopulatedProperties - Used to update all SDC expressions based on a pre-populated questionnaire response
+ * @property onFocusLinkId - Used to set the focused linkId
+ * @property setPopulatedContext - Used to set the populated contexts (launchContext, sourceQueries, x-fhir-query vars) for debugging purposes
+ * @property setFormAsReadOnly - Used to set the form as read-only
+ *
+ * @author Sean Fong
+ */
+export interface QuestionnaireStoreType {
+    sourceQuestionnaire: Questionnaire;
+    itemTypes: Record<string, string>;
+    itemPreferredTerminologyServers: Record<string, string>;
+    tabs: Tabs;
+    currentTabIndex: number;
+    pages: Pages;
+    currentPageIndex: number;
+    variables: Variables;
+    launchContexts: Record<string, LaunchContext>;
+    enableWhenItems: EnableWhenItems;
+    enableWhenLinkedQuestions: Record<string, string[]>;
+    enableWhenIsActivated: boolean;
+    enableWhenExpressions: EnableWhenExpressions;
+    calculatedExpressions: Record<string, CalculatedExpression[]>;
+    initialExpressions: Record<string, InitialExpression>;
+    answerExpressions: Record<string, AnswerExpression>;
+    processedValueSetCodings: Record<string, Coding[]>;
+    processedValueSetUrls: Record<string, string>;
+    cachedValueSetCodings: Record<string, Coding[]>;
+    fhirPathContext: Record<string, any>;
+    populatedContext: Record<string, any>;
+    focusedLinkId: string;
+    readOnly: boolean;
+    buildSourceQuestionnaire: (questionnaire: Questionnaire, questionnaireResponse?: QuestionnaireResponse, additionalVariables?: Record<string, object>, terminologyServerUrl?: string, readOnly?: boolean) => Promise<void>;
+    destroySourceQuestionnaire: () => void;
+    switchTab: (newTabIndex: number) => void;
+    switchPage: (newPageIndex: number) => void;
+    markTabAsComplete: (tabLinkId: string) => void;
+    markPageAsComplete: (pageLinkId: string) => void;
+    updateEnableWhenItem: (linkId: string, newAnswer: QuestionnaireResponseItemAnswer[] | undefined, parentRepeatGroupIndex: number | null) => void;
+    mutateRepeatEnableWhenItems: (parentRepeatGroupLinkId: string, parentRepeatGroupIndex: number, actionType: 'add' | 'remove') => void;
+    toggleEnableWhenActivation: (isActivated: boolean) => void;
+    updateExpressions: (updatedResponse: QuestionnaireResponse) => void;
+    addCodingToCache: (valueSetUrl: string, codings: Coding[]) => void;
+    updatePopulatedProperties: (populatedResponse: QuestionnaireResponse, populatedContext?: Record<string, any>, persistTabIndex?: boolean) => QuestionnaireResponse;
+    onFocusLinkId: (linkId: string) => void;
+    setPopulatedContext: (newPopulatedContext: Record<string, any>) => void;
+    setFormAsReadOnly: (readOnly: boolean) => void;
+}
+/**
+ * Questionnaire state management store which contains all properties and methods to manage the state of the questionnaire.
+ * This is the vanilla version of the store which can be used in non-React environments.
+ * @see QuestionnaireStoreType for available properties and methods.
+ *
+ * @author Sean Fong
+ */
+export declare const questionnaireStore: import("zustand/vanilla").StoreApi<QuestionnaireStoreType>;
+/**
+ * Questionnaire state management store which contains all properties and methods to manage the state of the questionnaire.
+ * This is the React version of the store which can be used as React hooks in React functional components.
+ * @see QuestionnaireStoreType for available properties and methods.
+ * @see questionnaireStore for the vanilla store.
+ *
+ * @author Sean Fong
+ */
+export declare const useQuestionnaireStore: import("zustand/vanilla").StoreApi<QuestionnaireStoreType> & {
+    use: {
+        sourceQuestionnaire: () => Questionnaire;
+        itemTypes: () => Record<string, string>;
+        itemPreferredTerminologyServers: () => Record<string, string>;
+        tabs: () => Tabs;
+        currentTabIndex: () => number;
+        pages: () => Pages;
+        currentPageIndex: () => number;
+        variables: () => Variables;
+        launchContexts: () => Record<string, LaunchContext>;
+        enableWhenItems: () => EnableWhenItems;
+        enableWhenLinkedQuestions: () => Record<string, string[]>;
+        enableWhenIsActivated: () => boolean;
+        enableWhenExpressions: () => EnableWhenExpressions;
+        calculatedExpressions: () => Record<string, CalculatedExpression[]>;
+        initialExpressions: () => Record<string, InitialExpression>;
+        answerExpressions: () => Record<string, AnswerExpression>;
+        processedValueSetCodings: () => Record<string, Coding[]>;
+        processedValueSetUrls: () => Record<string, string>;
+        cachedValueSetCodings: () => Record<string, Coding[]>;
+        fhirPathContext: () => Record<string, any>;
+        populatedContext: () => Record<string, any>;
+        focusedLinkId: () => string;
+        readOnly: () => boolean;
+        buildSourceQuestionnaire: () => (questionnaire: Questionnaire, questionnaireResponse?: QuestionnaireResponse, additionalVariables?: Record<string, object>, terminologyServerUrl?: string, readOnly?: boolean) => Promise<void>;
+        destroySourceQuestionnaire: () => () => void;
+        switchTab: () => (newTabIndex: number) => void;
+        switchPage: () => (newPageIndex: number) => void;
+        markTabAsComplete: () => (tabLinkId: string) => void;
+        markPageAsComplete: () => (pageLinkId: string) => void;
+        updateEnableWhenItem: () => (linkId: string, newAnswer: QuestionnaireResponseItemAnswer[] | undefined, parentRepeatGroupIndex: number | null) => void;
+        mutateRepeatEnableWhenItems: () => (parentRepeatGroupLinkId: string, parentRepeatGroupIndex: number, actionType: 'add' | 'remove') => void;
+        toggleEnableWhenActivation: () => (isActivated: boolean) => void;
+        updateExpressions: () => (updatedResponse: QuestionnaireResponse) => void;
+        addCodingToCache: () => (valueSetUrl: string, codings: Coding[]) => void;
+        updatePopulatedProperties: () => (populatedResponse: QuestionnaireResponse, populatedContext?: Record<string, any>, persistTabIndex?: boolean) => QuestionnaireResponse;
+        onFocusLinkId: () => (linkId: string) => void;
+        setPopulatedContext: () => (newPopulatedContext: Record<string, any>) => void;
+        setFormAsReadOnly: () => (readOnly: boolean) => void;
+    };
+};