@aehrc/smart-forms-renderer 0.2.0 → 0.4.0

package/lib/hooks/useValidationError.js

@@ -0,0 +1,38 @@
+/*
+ * 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.
+ */
+function useValidationError(input, regexValidation, maxLength) {
+    var _a;
+    let feedback = '';
+    if (input) {
+        // Test regex
+        if (regexValidation) {
+            if (!regexValidation.expression.test(input)) {
+                feedback =
+                    (_a = regexValidation.feedback) !== null && _a !== void 0 ? _a : `Input should match the specified regex ${regexValidation.expression}`;
+            }
+        }
+        // Test max character limit
+        if (maxLength) {
+            if (input.length > maxLength) {
+                feedback = 'Input exceeds maximum character limit.';
+            }
+        }
+    }
+    return feedback;
+}
+export default useValidationError;
+//# sourceMappingURL=useValidationError.js.map

package/lib/hooks/useValidationError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useValidationError.js","sourceRoot":"","sources":["../../src/hooks/useValidationError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,SAAS,kBAAkB,CACzB,KAAa,EACb,eAAuC,EACvC,SAAwB;;IAExB,IAAI,QAAQ,GAAG,EAAE,CAAC;IAElB,IAAI,KAAK,EAAE;QACT,aAAa;QACb,IAAI,eAAe,EAAE;YACnB,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;gBAC3C,QAAQ;oBACN,MAAA,eAAe,CAAC,QAAQ,mCACxB,0CAA0C,eAAe,CAAC,UAAU,EAAE,CAAC;aAC1E;SACF;QAED,2BAA2B;QAC3B,IAAI,SAAS,EAAE;YACb,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS,EAAE;gBAC5B,QAAQ,GAAG,wCAAwC,CAAC;aACrD;SACF;KACF;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,eAAe,kBAAkB,CAAC"}

package/{dist → lib}/hooks/useValueSetCodings.d.ts

@@ -1,6 +1,6 @@
 import type { Coding, QuestionnaireItem } from 'fhir/r4';
 declare function useValueSetCodings(qItem: QuestionnaireItem): {
     codings: Coding[];
-    serverError: Error;
+    serverError: Error | null;
 };
 export default useValueSetCodings;

package/lib/hooks/useValueSetCodings.js

@@ -0,0 +1,125 @@
+/*
+ * 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 { useEffect, useMemo, useState } from 'react';
+import { getResourceFromLaunchContext, getTerminologyServerUrl, getValueSetCodings, getValueSetPromise } from '../utils/valueSet';
+import { getAnswerExpression } from '../utils/itemControl';
+import fhirpath from 'fhirpath';
+import fhirpath_r4_model from 'fhirpath/fhir-context/r4';
+import useConfigStore from '../stores/useConfigStore';
+import useQuestionnaireStore from '../stores/useQuestionnaireStore';
+function useValueSetCodings(qItem) {
+    var _a;
+    const patient = useConfigStore((state) => state.patient);
+    const user = useConfigStore((state) => state.user);
+    const encounter = useConfigStore((state) => state.encounter);
+    const launchContexts = useQuestionnaireStore((state) => state.launchContexts);
+    const processedValueSetCodings = useQuestionnaireStore((state) => state.processedValueSetCodings);
+    const cachedValueSetCodings = useQuestionnaireStore((state) => state.cachedValueSetCodings);
+    const addCodingToCache = useQuestionnaireStore((state) => state.addCodingToCache);
+    const { xFhirQueryVariables } = useQuestionnaireStore((state) => state.variables);
+    const valueSetUrl = qItem.answerValueSet;
+    let initialCodings = useMemo(() => {
+        // set options from cached answer options if present
+        if (valueSetUrl) {
+            let cleanValueSetUrl = valueSetUrl;
+            if (valueSetUrl.startsWith('#')) {
+                cleanValueSetUrl = valueSetUrl.slice(1);
+            }
+            // attempt to get codings from value sets preprocessed when loading questionnaire
+            if (processedValueSetCodings[cleanValueSetUrl]) {
+                return processedValueSetCodings[cleanValueSetUrl];
+            }
+            // attempt to get codings from cached queried value sets
+            if (cachedValueSetCodings[cleanValueSetUrl]) {
+                return cachedValueSetCodings[cleanValueSetUrl];
+            }
+        }
+        return [];
+    }, [cachedValueSetCodings, processedValueSetCodings, valueSetUrl]);
+    const answerExpression = (_a = getAnswerExpression(qItem)) === null || _a === void 0 ? void 0 : _a.expression;
+    initialCodings = useMemo(() => {
+        if (initialCodings.length === 0 && answerExpression) {
+            const variable = answerExpression.substring(answerExpression.indexOf('%') + 1, answerExpression.indexOf('.'));
+            const contextMap = {};
+            // get answer expression resource from launch contexts
+            if (launchContexts[variable]) {
+                const resourceType = launchContexts[variable].extension[1].valueCode;
+                const resource = getResourceFromLaunchContext(resourceType, patient, user, encounter);
+                if (resource) {
+                    contextMap[variable] = resource;
+                }
+            }
+            else if (xFhirQueryVariables[variable]) {
+                const resource = xFhirQueryVariables[variable].result;
+                if (resource) {
+                    contextMap[variable] = resource;
+                }
+            }
+            if (contextMap[variable]) {
+                try {
+                    const evaluated = fhirpath.evaluate({}, answerExpression, contextMap, fhirpath_r4_model);
+                    if (evaluated[0].system || evaluated[0].code) {
+                        // determine if the evaluated array is a coding array
+                        return evaluated;
+                    }
+                    else if (evaluated[0].coding) {
+                        // determine and return if the evaluated array is a codeable concept
+                        return evaluated[0].coding;
+                    }
+                }
+                catch (e) {
+                    console.warn(e.message);
+                }
+            }
+        }
+        return initialCodings;
+    }, [
+        answerExpression,
+        encounter,
+        initialCodings,
+        launchContexts,
+        patient,
+        user,
+        xFhirQueryVariables
+    ]);
+    const [codings, setCodings] = useState(initialCodings);
+    const [serverError, setServerError] = useState(null);
+    // get options from answerValueSet on render
+    useEffect(() => {
+        const valueSetUrl = qItem.answerValueSet;
+        if (!valueSetUrl || codings.length > 0)
+            return;
+        const terminologyServer = getTerminologyServerUrl(qItem);
+        const promise = getValueSetPromise(valueSetUrl, terminologyServer);
+        if (promise) {
+            promise
+                .then((valueSet) => {
+                const codings = getValueSetCodings(valueSet);
+                if (codings.length > 0) {
+                    addCodingToCache(valueSetUrl, codings);
+                    setCodings(codings);
+                }
+            })
+                .catch((error) => {
+                setServerError(error);
+            });
+        }
+    }, [qItem]);
+    return { codings, serverError };
+}
+export default useValueSetCodings;
+//# sourceMappingURL=useValueSetCodings.js.map

package/lib/hooks/useValueSetCodings.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,89 @@
+import type { Questionnaire, QuestionnaireResponse } from 'fhir/r4';
+export * from './components';
+export * from './hooks';
+/**
+ * Get the initial Questionnaire.
+ *
+ * @author Sean Fong
+ */
+export declare function useSourceQuestionnaire(): Questionnaire;
+/**
+ * Get the initial QuestionnaireResponse.
+ * An empty QuestionnaireResponse is returned if no initial QuestionnaireResponse is provided when building the form.
+ *
+ * @author Sean Fong
+ */
+export declare function useSourceResponse(): QuestionnaireResponse;
+/**
+ * Get the filled QuestionnaireResponse.
+ * If no changes have been made to the form, the initial QuestionnaireResponse is returned.
+ *
+ * @author Sean Fong
+ */
+export declare function useUpdatableResponse(): QuestionnaireResponse;
+/**
+ * Get the boolean value of whether any changes have been made to the form.
+ *
+ * @author Sean Fong
+ */
+export declare function useFormHasChanges(): boolean;
+/**
+ * Get the boolean value of whether enableWhen (and enableWhenExpression) is activated.
+ *
+ * @author Sean Fong
+ */
+export declare function useEnableWhenActivated(): boolean;
+/**
+ * Set the initial Questionnaire.
+ * In most cases, <pre>buildForm()</pre> should be used instead.
+ *
+ * @author Sean Fong
+ */
+export declare function setSourceQuestionnaire(questionnaire: Questionnaire): Promise<void>;
+/**
+ * Build the form with an initial Questionnaire and an optional filled QuestionnaireResponse.
+ * If a QuestionnaireResponse is not provided, an empty QuestionnaireResponse is set as the initial QuestionnaireResponse.
+ * In most cases, <pre>buildForm()</pre> is sufficient. Other fine-grained functions are provided for more control.
+ *
+ * @author Sean Fong
+ */
+export declare function buildForm(questionnaire: Questionnaire, questionnaireResponse?: QuestionnaireResponse): Promise<void>;
+/**
+ * Destroy the form to clean up the store.
+ *
+ * @author Sean Fong
+ */
+export declare function destroyForm(): void;
+/**
+ * Toggle activation of enableWhen (and enableWhenExpression).
+ *
+ * @author Sean Fong
+ */
+export declare function setEnableWhenActivation(isActivated: boolean): void;
+/**
+ * Set the filled QuestionnaireResponse.
+ * In most cases, <pre>buildForm()</pre> should be used instead.
+ *
+ * @author Sean Fong
+ */
+export declare function setUpdatableResponse(populatedResponse: QuestionnaireResponse): void;
+/**
+ * Set the filled QuestionnaireResponse to be empty.
+ * This is used to quickly clear the form.
+ *
+ * @author Sean Fong
+ */
+export declare function setUpdatableResponseAsEmpty(emptyResponse: QuestionnaireResponse): void;
+/**
+ * Save the filled QuestionnaireResponse to be the initial QuestionnaireResponse and reset the <pre>hasChanges</pre> flag.
+ *
+ * @author Sean Fong
+ */
+export declare function setUpdatableResponseAsSaved(savedResponse: QuestionnaireResponse): void;
+/**
+ * Remove all hidden answers from the filled QuestionnaireResponse.
+ * This takes into account the questionnaire-hidden extension, enableWhens and enableWhenExpressions.
+ *
+ * @author Sean Fong
+ */
+export declare function removeHiddenAnswersFromResponse(questionnaire: Questionnaire, questionnaireResponse: QuestionnaireResponse): QuestionnaireResponse;

package/lib/index.js

@@ -0,0 +1,153 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import useQuestionnaireStore from './stores/useQuestionnaireStore';
+import { createQuestionnaireResponse } from './utils/qrItem';
+import useQuestionnaireResponseStore from './stores/useQuestionnaireResponseStore';
+import { removeHiddenAnswers } from './utils/removeHidden';
+export * from './components';
+export * from './hooks';
+/**
+ * Get the initial Questionnaire.
+ *
+ * @author Sean Fong
+ */
+export function useSourceQuestionnaire() {
+    return useQuestionnaireStore.getState().sourceQuestionnaire;
+}
+/**
+ * Get the initial QuestionnaireResponse.
+ * An empty QuestionnaireResponse is returned if no initial QuestionnaireResponse is provided when building the form.
+ *
+ * @author Sean Fong
+ */
+export function useSourceResponse() {
+    return useQuestionnaireResponseStore.getState().sourceResponse;
+}
+/**
+ * Get the filled QuestionnaireResponse.
+ * If no changes have been made to the form, the initial QuestionnaireResponse is returned.
+ *
+ * @author Sean Fong
+ */
+export function useUpdatableResponse() {
+    return useQuestionnaireResponseStore.getState().updatableResponse;
+}
+/**
+ * Get the boolean value of whether any changes have been made to the form.
+ *
+ * @author Sean Fong
+ */
+export function useFormHasChanges() {
+    return useQuestionnaireResponseStore.getState().hasChanges;
+}
+/**
+ * Get the boolean value of whether enableWhen (and enableWhenExpression) is activated.
+ *
+ * @author Sean Fong
+ */
+export function useEnableWhenActivated() {
+    return useQuestionnaireStore.getState().enableWhenIsActivated;
+}
+/**
+ * Set the initial Questionnaire.
+ * In most cases, <pre>buildForm()</pre> should be used instead.
+ *
+ * @author Sean Fong
+ */
+export function setSourceQuestionnaire(questionnaire) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield useQuestionnaireStore.getState().buildSourceQuestionnaire(questionnaire);
+    });
+}
+/**
+ * Build the form with an initial Questionnaire and an optional filled QuestionnaireResponse.
+ * If a QuestionnaireResponse is not provided, an empty QuestionnaireResponse is set as the initial QuestionnaireResponse.
+ * In most cases, <pre>buildForm()</pre> is sufficient. Other fine-grained functions are provided for more control.
+ *
+ * @author Sean Fong
+ */
+export function buildForm(questionnaire, questionnaireResponse) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield useQuestionnaireStore.getState().buildSourceQuestionnaire(questionnaire);
+        if (!questionnaireResponse) {
+            useQuestionnaireResponseStore
+                .getState()
+                .buildSourceResponse(createQuestionnaireResponse(questionnaire));
+            return;
+        }
+        useQuestionnaireResponseStore.getState().buildSourceResponse(questionnaireResponse);
+        useQuestionnaireStore.getState().updatePopulatedProperties(questionnaireResponse);
+    });
+}
+/**
+ * Destroy the form to clean up the store.
+ *
+ * @author Sean Fong
+ */
+export function destroyForm() {
+    useQuestionnaireStore.getState().destroySourceQuestionnaire();
+    useQuestionnaireResponseStore.getState().destroySourceResponse();
+}
+/**
+ * Toggle activation of enableWhen (and enableWhenExpression).
+ *
+ * @author Sean Fong
+ */
+export function setEnableWhenActivation(isActivated) {
+    useQuestionnaireStore.getState().toggleEnableWhenActivation(isActivated);
+}
+/**
+ * Set the filled QuestionnaireResponse.
+ * In most cases, <pre>buildForm()</pre> should be used instead.
+ *
+ * @author Sean Fong
+ */
+export function setUpdatableResponse(populatedResponse) {
+    const updatedResponse = useQuestionnaireStore
+        .getState()
+        .updatePopulatedProperties(populatedResponse);
+    useQuestionnaireResponseStore.getState().populateResponse(updatedResponse);
+}
+/**
+ * Set the filled QuestionnaireResponse to be empty.
+ * This is used to quickly clear the form.
+ *
+ * @author Sean Fong
+ */
+export function setUpdatableResponseAsEmpty(emptyResponse) {
+    return useQuestionnaireResponseStore.getState().clearResponse(emptyResponse);
+}
+/**
+ * Save the filled QuestionnaireResponse to be the initial QuestionnaireResponse and reset the <pre>hasChanges</pre> flag.
+ *
+ * @author Sean Fong
+ */
+export function setUpdatableResponseAsSaved(savedResponse) {
+    return useQuestionnaireResponseStore.getState().saveResponse(savedResponse);
+}
+/**
+ * Remove all hidden answers from the filled QuestionnaireResponse.
+ * This takes into account the questionnaire-hidden extension, enableWhens and enableWhenExpressions.
+ *
+ * @author Sean Fong
+ */
+export function removeHiddenAnswersFromResponse(questionnaire, questionnaireResponse) {
+    const enableWhenIsActivated = useQuestionnaireStore.getState().enableWhenIsActivated;
+    const enableWhenItems = useQuestionnaireStore.getState().enableWhenItems;
+    const enableWhenExpressions = useQuestionnaireStore.getState().enableWhenExpressions;
+    return removeHiddenAnswers({
+        questionnaire,
+        questionnaireResponse,
+        enableWhenIsActivated,
+        enableWhenItems,
+        enableWhenExpressions
+    });
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,qBAAqB,MAAM,gCAAgC,CAAC;AAEnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,6BAA6B,MAAM,wCAAwC,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AAExB;;;;GAIG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,qBAAqB,CAAC,QAAQ,EAAE,CAAC,mBAAmB,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,6BAA6B,CAAC,QAAQ,EAAE,CAAC,cAAc,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,6BAA6B,CAAC,QAAQ,EAAE,CAAC,iBAAiB,CAAC;AACpE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,6BAA6B,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,qBAAqB,CAAC,QAAQ,EAAE,CAAC,qBAAqB,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAgB,sBAAsB,CAAC,aAA4B;;QACvE,MAAM,qBAAqB,CAAC,QAAQ,EAAE,CAAC,wBAAwB,CAAC,aAAa,CAAC,CAAC;IACjF,CAAC;CAAA;AAED;;;;;;GAMG;AACH,MAAM,UAAgB,SAAS,CAC7B,aAA4B,EAC5B,qBAA6C;;QAE7C,MAAM,qBAAqB,CAAC,QAAQ,EAAE,CAAC,wBAAwB,CAAC,aAAa,CAAC,CAAC;QAE/E,IAAI,CAAC,qBAAqB,EAAE;YAC1B,6BAA6B;iBAC1B,QAAQ,EAAE;iBACV,mBAAmB,CAAC,2BAA2B,CAAC,aAAa,CAAC,CAAC,CAAC;YACnE,OAAO;SACR;QAED,6BAA6B,CAAC,QAAQ,EAAE,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,CAAC;QACpF,qBAAqB,CAAC,QAAQ,EAAE,CAAC,yBAAyB,CAAC,qBAAqB,CAAC,CAAC;IACpF,CAAC;CAAA;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,qBAAqB,CAAC,QAAQ,EAAE,CAAC,0BAA0B,EAAE,CAAC;IAC9D,6BAA6B,CAAC,QAAQ,EAAE,CAAC,qBAAqB,EAAE,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,WAAoB;IAC1D,qBAAqB,CAAC,QAAQ,EAAE,CAAC,0BAA0B,CAAC,WAAW,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,iBAAwC;IAC3E,MAAM,eAAe,GAAG,qBAAqB;SAC1C,QAAQ,EAAE;SACV,yBAAyB,CAAC,iBAAiB,CAAC,CAAC;IAChD,6BAA6B,CAAC,QAAQ,EAAE,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC;AAC7E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,aAAoC;IAC9E,OAAO,6BAA6B,CAAC,QAAQ,EAAE,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;AAC/E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,aAAoC;IAC9E,OAAO,6BAA6B,CAAC,QAAQ,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAC7C,aAA4B,EAC5B,qBAA4C;IAE5C,MAAM,qBAAqB,GAAG,qBAAqB,CAAC,QAAQ,EAAE,CAAC,qBAAqB,CAAC;IACrF,MAAM,eAAe,GAAG,qBAAqB,CAAC,QAAQ,EAAE,CAAC,eAAe,CAAC;IACzE,MAAM,qBAAqB,GAAG,qBAAqB,CAAC,QAAQ,EAAE,CAAC,qBAAqB,CAAC;IAErF,OAAO,mBAAmB,CAAC;QACzB,aAAa;QACb,qBAAqB;QACrB,qBAAqB;QACrB,eAAe;QACf,qBAAqB;KACtB,CAAC,CAAC;AACL,CAAC"}

package/lib/interfaces/answerExpression.interface.js

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

package/lib/interfaces/answerExpression.interface.js.map

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

package/lib/interfaces/calculatedExpression.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=calculatedExpression.interface.js.map

package/lib/interfaces/calculatedExpression.interface.js.map

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

package/lib/interfaces/choice.enum.js

@@ -0,0 +1,41 @@
+/*
+ * 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 var QItemChoiceControl;
+(function (QItemChoiceControl) {
+    QItemChoiceControl["Radio"] = "radio";
+    QItemChoiceControl["Select"] = "select";
+    QItemChoiceControl["Autocomplete"] = "autocomplete";
+    QItemChoiceControl["Checkbox"] = "check-box";
+})(QItemChoiceControl || (QItemChoiceControl = {}));
+export var QItemOpenChoiceControl;
+(function (QItemOpenChoiceControl) {
+    QItemOpenChoiceControl["Select"] = "select";
+    QItemOpenChoiceControl["Autocomplete"] = "autocomplete";
+    QItemOpenChoiceControl["Checkbox"] = "check-box";
+    QItemOpenChoiceControl["Radio"] = "radio";
+})(QItemOpenChoiceControl || (QItemOpenChoiceControl = {}));
+export var QItemChoiceOrientation;
+(function (QItemChoiceOrientation) {
+    QItemChoiceOrientation["Horizontal"] = "horizontal";
+    QItemChoiceOrientation["Vertical"] = "vertical";
+})(QItemChoiceOrientation || (QItemChoiceOrientation = {}));
+export var CheckBoxOptionType;
+(function (CheckBoxOptionType) {
+    CheckBoxOptionType["AnswerOption"] = "answerOption";
+    CheckBoxOptionType["AnswerValueSet"] = "answerValueSet";
+})(CheckBoxOptionType || (CheckBoxOptionType = {}));
+//# sourceMappingURL=choice.enum.js.map

package/lib/interfaces/choice.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"choice.enum.js","sourceRoot":"","sources":["../../src/interfaces/choice.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,qCAAe,CAAA;IACf,uCAAiB,CAAA;IACjB,mDAA6B,CAAA;IAC7B,4CAAsB,CAAA;AACxB,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B;AAED,MAAM,CAAN,IAAY,sBAKX;AALD,WAAY,sBAAsB;IAChC,2CAAiB,CAAA;IACjB,uDAA6B,CAAA;IAC7B,gDAAsB,CAAA;IACtB,yCAAe,CAAA;AACjB,CAAC,EALW,sBAAsB,KAAtB,sBAAsB,QAKjC;AAED,MAAM,CAAN,IAAY,sBAGX;AAHD,WAAY,sBAAsB;IAChC,mDAAyB,CAAA;IACzB,+CAAqB,CAAA;AACvB,CAAC,EAHW,sBAAsB,KAAtB,sBAAsB,QAGjC;AAED,MAAM,CAAN,IAAY,kBAGX;AAHD,WAAY,kBAAkB;IAC5B,mDAA6B,CAAA;IAC7B,uDAAiC,CAAA;AACnC,CAAC,EAHW,kBAAkB,KAAlB,kBAAkB,QAG7B"}

package/lib/interfaces/enableWhen.interface.js

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

package/lib/interfaces/enableWhen.interface.js.map

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

package/lib/interfaces/groupTable.interface.js

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

package/lib/interfaces/groupTable.interface.js.map

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

package/lib/interfaces/populate.interface.js

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

package/lib/interfaces/populate.interface.js.map

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

package/lib/interfaces/questionnaireStore.interface.js

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

package/lib/interfaces/questionnaireStore.interface.js.map

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

package/lib/interfaces/regex.interface.js

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

package/lib/interfaces/regex.interface.js.map

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

package/{dist → lib}/interfaces/renderProps.interface.d.ts

@@ -1,4 +1,4 @@
-import type { QrRepeatGroup } from './repeatGroup.interface.ts';
+import type { QrRepeatGroup } from './repeatGroup.interface';
 export interface PropsWithQrItemChangeHandler<QuestionnaireResponseItem> {
     onQrItemChange: (qrItem: QuestionnaireResponseItem) => unknown;
 }

package/lib/interfaces/renderProps.interface.js

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