@openmrs/esm-fast-data-entry-app 1.0.0-pre.9 → 1.0.1-pre.8

package/README.md

@@ -1,12 +1,39 @@
-
-
-# OpenMRS ESM Fast Data Entry App
-
-This repository will hold modules which make the Fast Data Entry system work.
-
-## Running this code
-
-```sh
-yarn  # to install dependencies
-yarn start  # to run the dev server
-```
+
+
+# OpenMRS ESM Fast Data Entry App
+
+The Fast Data Entry App is a module for the [OpenMRS](https://openmrs.org/) healthcare platform which allows for a natural workflow when entering many pre-recorded forms at a time. It is not meant for point-of-care workflows, but rather as a way to do retrospective data entry.
+
+## Overview
+Currently the app consists of two main parts, a Forms Page to list available forms and a Form Workflow which allows the rapid input of forms.
+
+### Forms Page
+The Forms page lists all forms able to be seen by a user, filtered by that user's permission to edit the given form. Additionally implementors are able to customize the page by creating form categories and listing the forms inside of each category. These categories can then be shown or hidden using configuration (see more [here](docs/configuring-form-categories.md)). From these lists forms are able to be opened in the Form Workflow using the 'Fill form' button.
+
+### Form Workflow
+Forms can be entered quickly with the Form Entry Workflow. This workflow depends on a state machine managed by the [FormWorkflowReducer](src/context/FormWorkflowReducer.ts).
+
+See the video below of a normal workflow.
+
+https://user-images.githubusercontent.com/5445264/181378774-341b2a2f-3ecc-4052-b960-d61ba07980fb.mov
+
+State diagram for the Form Workflow.
+
+![Form Workflow State Diagram](docs/form-workflow-state-diagram.png)
+
+## Running this code
+
+Clone the repo locally, then install and run using
+
+```sh
+yarn  # to install dependencies
+yarn start  # to run the dev server
+```
+
+To customize your development build pass other arguments to yarn start (which under the hood is running `npx openmrs develop`). For example to point to a backend other than [dev3](https://dev3.openmrs.org/)  specify the `--backend` option. See the full example below for running against an ICRC backend.
+
+```sh
+yarn start --importmap "https://spa-modules.nyc3.digitaloceanspaces.com/import-map.json" --backend "https://openmrs-dev-v2.test.icrc.org/" --add-cookie "MRHSession=abcdefghijklmnop012345678910" --spa-path "/ui"
+```
+
+To see more options run `npx openmrs --help`

package/dist/openmrs-esm-fast-data-entry-app.js

@@ -1 +1 @@
-System.register("@openmrs/esm-fast-data-entry-app",[],function(a,b){var c=void 0;return{execute:function(){a((()=>{function g(a){var b=m[a];if(void 0!==b)return b.exports;var c=m[a]={id:a,loaded:!1,exports:{}};return G[a].call(c.exports,c,c.exports,g),c.loaded=!0,c.exports}var j,k,q,w,x,y,z,A,B,C,r,D,E,F,G={1858:(a,b,c)=>{(0,c(2722).s)(1)},2722:(a,b,c)=>{const d=c(3905).R;b.s=function(a){if(a||(a=1),!c.y.meta||!c.y.meta.url)throw console.error("__system_context__",c.y),Error("systemjs-webpack-interop was provided an unknown SystemJS context. Expected context.meta.url, but none was provided");c.p=d(c.y.meta.url,a)}},5356:(a,b,c)=>{c(1858)},3905:(a,b)=>{b.R=function(b,c){var d=document.createElement("a");d.href=b;for(var e="/"===d.pathname[0]?d.pathname:"/"+d.pathname,f=0,g=e.length;f!==c&&0<=g;)"/"===e[--g]&&f++;if(f!==c)throw Error("systemjs-webpack-interop: rootDirectoryLevel ("+c+") is greater than the number of directories ("+f+") in the URL path "+b);var h=e.slice(0,g+1);return d.protocol+"//"+d.host+h},Number.isInteger},6751:(b,d,f)=>{var g={app:()=>(c||((self.webpackChunk_openmrs_esm_fast_data_entry_app=self.webpackChunk_openmrs_esm_fast_data_entry_app||[]).push([[299],{9299:(b,c,d)=>{function e(){var a={featureName:"fast-data-entry",moduleName:"@openmrs/esm-fast-data-entry"};return(0,f.defineConfigSchema)("@openmrs/esm-fast-data-entry",g),{pages:[{load:(0,f.getAsyncLifecycle)(function(){return Promise.all([d.e(735),d.e(365),d.e(69)]).then(d.bind(d,5273))},a),route:"forms"}],extensions:[{name:"forms-app-link",slot:"app-menu-slot",load:(0,f.getAsyncLifecycle)(function(){return Promise.all([d.e(365),d.e(415)]).then(d.bind(d,8457))},a),online:!0,offline:!0}]}}d.r(c),d.d(c,{backendDependencies:()=>h,importTranslation:()=>a,setupOpenMRS:()=>e,assets:()=>["24.js","69.js","294.js","296.js","382.js","415.js","openmrs-esm-fast-data-entry-app.js","574.js","595.js","735.js","777.js","860.js","906.js"]});var f=d(9075),g={casualGreeting:{_type:f.Type.Boolean,_default:!1,_description:"Whether to use a casual greeting (or a formal one)."},whoToGreet:{_type:f.Type.Array,_default:["World"],_description:"Who should be greeted. Names will be separated by a comma and space.",_elements:{_type:f.Type.String},_validators:[(0,f.validator)(function(a){return 0<a.length},"At least one person must be greeted.")]}},a=d(3979),h={fhir2:"^1.2.0","webservices.rest":"^2.2.0"}},3979:(b,c,d)=>{function e(b){if(!d.o(f,b))return Promise.resolve().then(()=>{var a=new Error("Cannot find module '"+b+"'");throw a.code="MODULE_NOT_FOUND",a});var c=f[b],e=c[0];return d.e(c[1]).then(()=>d(e))}var f={"./en.json":[3574,574]};e.keys=()=>Object.keys(f),e.id=3979,b.exports=e}}]),c=f.e(299).then(()=>()=>f(9299))),c)},e=(a,b)=>(f.R=b,b=f.o(g,a)?g[a]():Promise.resolve().then(()=>{throw new Error("Module \""+a+"\" does not exist in container.")}),f.R=void 0,b),h=(a,b)=>{if(f.S){var c=f.S["default"];if(c&&c!==a)throw new Error("Container initialization failed as it has already been initialized with a different share scope");return f.S["default"]=a,f.I("default",b)}};f.d(d,{get:()=>e,init:()=>h})}},m={};return g.m=G,g.c=m,g.y=b,g.n=a=>{var b=a&&a.__esModule?()=>a.default:()=>a;return g.d(b,{a:b}),b},g.d=(a,b)=>{for(var c in b)g.o(b,c)&&!g.o(a,c)&&Object.defineProperty(a,c,{enumerable:!0,get:b[c]})},g.f={},g.e=a=>Promise.all(Object.keys(g.f).reduce((b,c)=>(g.f[c](a,b),b),[])),g.u=a=>a+".js",g.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(a){if("object"==typeof window)return window}}(),g.o=(a,b)=>Object.prototype.hasOwnProperty.call(a,b),j={},k="@openmrs/esm-fast-data-entry-app:",g.l=(a,b,c)=>{if(j[a])j[a].push(b);else{var e,h;if(void 0!==c)for(var m,n=document.getElementsByTagName("script"),o=0;o<n.length;o++)if(m=n[o],m.getAttribute("src")==a||m.getAttribute("data-webpack")==k+c){e=m;break}e||(h=!0,(e=document.createElement("script")).charset="utf-8",e.timeout=120,g.nc&&e.setAttribute("nonce",g.nc),e.setAttribute("data-webpack",k+c),e.src=a),j[a]=[b];var q=(b,c)=>{e.onerror=e.onload=null,clearTimeout(p);var d=j[a];if(delete j[a],e.parentNode&&e.parentNode.removeChild(e),d&&d.forEach(a=>a(c)),b)return b(c)},p=setTimeout(q.bind(null,void 0,{type:"timeout",target:e}),12e4);e.onerror=q.bind(null,e.onerror),e.onload=q.bind(null,e.onload),h&&document.head.appendChild(e)}},g.r=a=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(a,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(a,"__esModule",{value:!0})},g.nmd=a=>(a.paths=[],a.children||(a.children=[]),a),(()=>{g.S={};var b={},c={};g.I=(d,e)=>{e||(e=[]);var f=c[d];if(f||(f=c[d]={}),!(0<=e.indexOf(f))){if(e.push(f),b[d])return b[d];g.o(g.S,d)||(g.S[d]={});var h=g.S[d],a=(a,b,c,d)=>{var e=h[a]=h[a]||{},f=e[b];f&&(f.loaded||(!d==!f.eager?!("@openmrs/esm-fast-data-entry-app">f.from):!d))||(e[b]={get:c,from:"@openmrs/esm-fast-data-entry-app",eager:!!d})},i=[];return"default"===d&&(a("@openmrs/esm-framework","3.3.2-pre.1193",()=>Promise.all([g.e(595),g.e(365)]).then(()=>()=>g(595))),a("carbon-components","10.31.0",()=>Promise.all([g.e(24),g.e(296)]).then(()=>()=>g(5024))),a("carbon-icons","7.0.7",()=>g.e(906).then(()=>()=>g(906))),a("react-i18next","11.16.9",()=>Promise.all([g.e(777),g.e(365)]).then(()=>()=>g(9777))),a("react-router-dom","5.3.1",()=>Promise.all([g.e(382),g.e(365),g.e(860)]).then(()=>()=>g(7382))),a("react","16.14.0",()=>g.e(294).then(()=>()=>g(7294)))),b[d]=i.length?Promise.all(i).then(()=>b[d]=1):1}}})(),g.p="",q=a=>{var b=a=>a.split(".").map(a=>+a==a?+a:a),c=/^([^-+]+)?(?:-([^+]+))?(?:\+(.+))?$/.exec(a),d=c[1]?b(c[1]):[];return c[2]&&(d.length++,d.push.apply(d,b(c[2]))),c[3]&&(d.push([]),d.push.apply(d,b(c[3]))),d},w=(b,c)=>{b=q(b),c=q(c);for(var d=0;;){if(d>=b.length)return d<c.length&&"u"!=(typeof c[d])[0];var f=b[d],g=(typeof f)[0];if(d>=c.length)return"u"==g;var a=c[d],h=(typeof a)[0];if(g!=h)return"o"==g&&"n"==h||"s"==h||"u"==g;if("o"!=g&&"u"!=g&&f!=a)return f<a;d++}},x=a=>{function b(){return g.pop().replace(/^\((.+)\)$/,"$1")}var c=a[0],d="";if(1===a.length)return"*";if(c+.5){d+=0==c?">=":-1==c?"<":1==c?"^":2==c?"~":0<c?"=":"!=";for(var e=1,f=1;f<a.length;f++)e--,d+="u"==(typeof(h=a[f]))[0]?"-":(0<e?".":"")+(e=2,h);return d}var g=[];for(f=1;f<a.length;f++){var h=a[f];g.push(0===h?"not("+b()+")":1===h?"("+b()+" || "+b()+")":2===h?g.pop()+" "+g.pop():x(h))}return b()},y=(b,e)=>{if(0 in b){e=q(e);var g=b[0],i=0>g;i&&(g=-g-1);for(var j=0,k=1,m=!0;;k++,j++){var n,o,v=k<b.length?(typeof b[k])[0]:"";if(j>=e.length||"o"==(o=(typeof(n=e[j]))[0]))return!m||("u"==v?k>g&&!i:""==v!=i);if("u"==o){if(!m||"u"!=v)return!1;}else if(!m)"s"!=v&&"n"!=v&&(m=!1,k--);else if(v==o){if(!(k<=g)){if(i?n>b[k]:n<b[k])return!1;n!=b[k]&&(m=!1)}else if(n!=b[k])return!1;}else if("s"!=v&&"n"!=v){if(i||k<=g)return!1;m=!1,k--}else{if(k<=g||o<v!=i)return!1;m=!1}}}var p=[],d=p.pop.bind(p);for(j=1;j<b.length;j++){var c=b[j];p.push(1==c?d()|d():2==c?d()&d():c?y(c,e):!d())}return!!d()},z=(a,b)=>{var c=a[b];return Object.keys(c).reduce((a,b)=>a&&(c[a].loaded||!w(a,b))?a:b,0)},A=(a,b,c,d)=>"Unsatisfied version "+c+" from "+(c&&a[b][c].from)+" of shared singleton module "+b+" (required "+x(d)+")",B=(a,b,c,d)=>{var e=z(a,c);return y(d,e)||"undefined"!=typeof console&&console.warn&&console.warn(A(a,c,e,d)),C(a[c][e])},C=a=>(a.loaded=1,a.get()),r=(b=>function(c,d,e,f){var h=g.I(c);return h&&h.then?h.then(b.bind(b,c,g.S[c],d,e,f)):b(0,g.S[c],d,e,f)})((a,b,c,d,e)=>b&&g.o(b,c)?B(b,0,c,d):e()),D={},E={9075:()=>r("default","@openmrs/esm-framework",[1,3,14,0,,"pre"],()=>Promise.all([g.e(595),g.e(365)]).then(()=>()=>g(595))),5365:()=>r("default","react",[1,16],()=>g.e(294).then(()=>()=>g(7294))),1990:()=>r("default","carbon-components",[1,10],()=>g.e(24).then(()=>()=>g(5024))),9246:()=>r("default","react-router-dom",[1,5],()=>g.e(382).then(()=>()=>g(7382))),3397:()=>r("default","react-i18next",[1,11],()=>g.e(777).then(()=>()=>g(9777)))},F={69:[1990,9246],299:[9075],365:[5365],415:[3397]},g.f.consumes=(a,b)=>{g.o(F,a)&&F[a].forEach(a=>{if(g.o(D,a))return b.push(D[a]);var c=b=>{D[a]=0,g.m[a]=c=>{delete g.c[a],c.exports=b()}},d=b=>{delete D[a],g.m[a]=()=>{throw delete g.c[a],b}};try{var e=E[a]();e.then?b.push(D[a]=e.then(c).catch(d)):c(e)}catch(a){d(a)}})},(()=>{var b={447:0};g.f.j=(c,d)=>{var e=g.o(b,c)?b[c]:void 0;if(0!==e)if(e)d.push(e[2]);else if(365!=c){var f=new Promise((a,d)=>e=b[c]=[a,d]);d.push(e[2]=f);var h=g.p+g.u(c),j=new Error;g.l(h,d=>{if(g.o(b,c)&&(0!==(e=b[c])&&(b[c]=void 0),e)){var f=d&&("load"===d.type?"missing":d.type),h=d&&d.target&&d.target.src;j.message="Loading chunk "+c+" failed.\n("+f+": "+h+")",j.name="ChunkLoadError",j.type=f,j.request=h,e[1](j)}},"chunk-"+c,c)}else b[c]=0};var a=(c,d)=>{var e,f,[h,a,i]=d,j=0;if(h.some(a=>0!==b[a])){for(e in a)g.o(a,e)&&(g.m[e]=a[e]);i&&i(g)}for(c&&c(d);j<h.length;j++)f=h[j],g.o(b,f)&&b[f]&&b[f][0](),b[f]=0},c=self.webpackChunk_openmrs_esm_fast_data_entry_app=self.webpackChunk_openmrs_esm_fast_data_entry_app||[];c.forEach(a.bind(null,0)),c.push=a.bind(null,c.push.bind(c))})(),g(5356),g(6751)})())}}});
+var _openmrs_esm_fast_data_entry_app;(()=>{function b(a){var c=h[a];if(void 0!==c)return c.exports;var d=h[a]={id:a,loaded:!1,exports:{}};return G[a].call(d.exports,d,d.exports,b),d.loaded=!0,d.exports}var j,k,q,v,w,x,y,z,A,B,C,D,E,F,G={7140:(b,c,d)=>{var f={"./start":()=>d.e(132).then(()=>()=>d(8132))},e=(a,b)=>(d.R=b,b=d.o(f,a)?f[a]():Promise.resolve().then(()=>{throw new Error("Module \""+a+"\" does not exist in container.")}),d.R=void 0,b),a=(b,c)=>{if(d.S){var e=d.S["default"];if(e&&e!==b)throw new Error("Container initialization failed as it has already been initialized with a different share scope");return d.S["default"]=b,d.I("default",c)}};d.d(c,{get:()=>e,init:()=>a})}},h={};b.m=G,b.c=h,b.n=a=>{var c=a&&a.__esModule?()=>a.default:()=>a;return b.d(c,{a:c}),c},b.d=(a,c)=>{for(var d in c)b.o(c,d)&&!b.o(a,d)&&Object.defineProperty(a,d,{enumerable:!0,get:c[d]})},b.f={},b.e=a=>Promise.all(Object.keys(b.f).reduce((c,d)=>(b.f[d](a,c),c),[])),b.u=a=>a+".js",b.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(a){if("object"==typeof window)return window}}(),b.o=(a,b)=>Object.prototype.hasOwnProperty.call(a,b),j={},k="@openmrs/esm-fast-data-entry-app:",b.l=(c,e,g)=>{if(j[c])j[c].push(e);else{var h,a;if(void 0!==g)for(var m,n=document.getElementsByTagName("script"),o=0;o<n.length;o++)if(m=n[o],m.getAttribute("src")==c||m.getAttribute("data-webpack")==k+g){h=m;break}h||(a=!0,(h=document.createElement("script")).charset="utf-8",h.timeout=120,b.nc&&h.setAttribute("nonce",b.nc),h.setAttribute("data-webpack",k+g),h.src=c),j[c]=[e];var q=(b,f)=>{h.onerror=h.onload=null,clearTimeout(d);var e=j[c];if(delete j[c],h.parentNode&&h.parentNode.removeChild(h),e&&e.forEach(a=>a(f)),b)return b(f)},d=setTimeout(q.bind(null,void 0,{type:"timeout",target:h}),12e4);h.onerror=q.bind(null,h.onerror),h.onload=q.bind(null,h.onload),a&&document.head.appendChild(h)}},b.r=a=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(a,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(a,"__esModule",{value:!0})},b.nmd=a=>(a.paths=[],a.children||(a.children=[]),a),(()=>{b.S={};var c={},d={};b.I=(e,f)=>{f||(f=[]);var g=d[e];if(g||(g=d[e]={}),!(0<=f.indexOf(g))){if(f.push(g),c[e])return c[e];b.o(b.S,e)||(b.S[e]={});var h=b.S[e],i=(b,c,d,e)=>{var f=h[b]=h[b]||{},a=f[c];a&&(a.loaded||(!e==!a.eager?!("@openmrs/esm-fast-data-entry-app">a.from):!e))||(f[c]={get:d,from:"@openmrs/esm-fast-data-entry-app",eager:!!e})},j=[];return"default"===e&&(i("@carbon/react","1.11.0",()=>Promise.all([b.e(820),b.e(327),b.e(569),b.e(672),b.e(183)]).then(()=>()=>b(8569))),i("@openmrs/esm-framework","4.0.2-pre.275",()=>Promise.all([b.e(595),b.e(672)]).then(()=>()=>b(595))),i("react-dom","18.2.0",()=>Promise.all([b.e(935),b.e(672)]).then(()=>()=>b(3935))),i("react-i18next","11.18.5",()=>Promise.all([b.e(247),b.e(672)]).then(()=>()=>b(8247))),i("react-router-dom","6.3.0",()=>Promise.all([b.e(68),b.e(672)]).then(()=>()=>b(6068))),i("react","18.2.0",()=>b.e(294).then(()=>()=>b(7294)))),c[e]=j.length?Promise.all(j).then(()=>c[e]=1):1}}})(),(()=>{var a;b.g.importScripts&&(a=b.g.location+"");var c=b.g.document;if(!a&&c&&(c.currentScript&&(a=c.currentScript.src),!a)){var d=c.getElementsByTagName("script");d.length&&(a=d[d.length-1].src)}if(!a)throw new Error("Automatic publicPath is not supported in this browser");a=a.replace(/#.*$/,"").replace(/\?.*$/,"").replace(/\/[^\/]+$/,"/"),b.p=a})(),q=a=>{var b=a=>a.split(".").map(a=>+a==a?+a:a),c=/^([^-+]+)?(?:-([^+]+))?(?:\+(.+))?$/.exec(a),d=c[1]?b(c[1]):[];return c[2]&&(d.length++,d.push.apply(d,b(c[2]))),c[3]&&(d.push([]),d.push.apply(d,b(c[3]))),d},v=(b,c)=>{b=q(b),c=q(c);for(var d=0;;){if(d>=b.length)return d<c.length&&"u"!=(typeof c[d])[0];var f=b[d],a=(typeof f)[0];if(d>=c.length)return"u"==a;var g=c[d],h=(typeof g)[0];if(a!=h)return"o"==a&&"n"==h||"s"==h||"u"==a;if("o"!=a&&"u"!=a&&f!=g)return f<g;d++}},w=a=>{function b(){return g.pop().replace(/^\((.+)\)$/,"$1")}var c=a[0],d="";if(1===a.length)return"*";if(c+.5){d+=0==c?">=":-1==c?"<":1==c?"^":2==c?"~":0<c?"=":"!=";for(var e=1,f=1;f<a.length;f++)e--,d+="u"==(typeof(h=a[f]))[0]?"-":(0<e?".":"")+(e=2,h);return d}var g=[];for(f=1;f<a.length;f++){var h=a[f];g.push(0===h?"not("+b()+")":1===h?"("+b()+" || "+b()+")":2===h?g.pop()+" "+g.pop():w(h))}return b()},x=(b,e)=>{if(0 in b){e=q(e);var g=b[0],j=0>g;j&&(g=-g-1);for(var a=0,k=1,m=!0;;k++,a++){var o,t,v=k<b.length?(typeof b[k])[0]:"";if(a>=e.length||"o"==(t=(typeof(o=e[a]))[0]))return!m||("u"==v?k>g&&!j:""==v!=j);if("u"==t){if(!m||"u"!=v)return!1;}else if(!m)"s"!=v&&"n"!=v&&(m=!1,k--);else if(v==t){if(!(k<=g)){if(j?o>b[k]:o<b[k])return!1;o!=b[k]&&(m=!1)}else if(o!=b[k])return!1;}else if("s"!=v&&"n"!=v){if(j||k<=g)return!1;m=!1,k--}else{if(k<=g||t<v!=j)return!1;m=!1}}}var d=[],p=d.pop.bind(d);for(a=1;a<b.length;a++){var c=b[a];d.push(1==c?p()|p():2==c?p()&p():c?x(c,e):!p())}return!!p()},y=(a,b)=>{var c=a[b];return Object.keys(c).reduce((a,b)=>a&&(c[a].loaded||!v(a,b))?a:b,0)},z=(a,b,c,d)=>"Unsatisfied version "+c+" from "+(c&&a[b][c].from)+" of shared singleton module "+b+" (required "+w(d)+")",A=(b,c,d,e)=>{var f=y(b,d);return x(e,f)||"undefined"!=typeof console&&console.warn&&console.warn(z(b,d,f,e)),B(b[d][f])},B=a=>(a.loaded=1,a.get()),C=(c=>function(d,e,f,g){var a=b.I(d);return a&&a.then?a.then(c.bind(c,d,b.S[d],e,f,g)):c(0,b.S[d],e,f,g)})((c,d,e,f,g)=>d&&b.o(d,e)?A(d,0,e,f):g()),D={},E={1672:()=>C("default","react",[1,18],()=>b.e(294).then(()=>()=>b(7294))),5183:()=>C("default","react-dom",[1,18],()=>b.e(935).then(()=>()=>b(3935))),1132:()=>C("default","@openmrs/esm-framework",[0],()=>Promise.all([b.e(595),b.e(672)]).then(()=>()=>b(595))),1338:()=>C("default","react-router-dom",[1,6],()=>b.e(68).then(()=>()=>b(6068))),3397:()=>C("default","react-i18next",[1,11],()=>b.e(247).then(()=>()=>b(8247))),4422:()=>C("default","@carbon/react",[1,1,9,0],()=>Promise.all([b.e(820),b.e(327),b.e(569),b.e(183)]).then(()=>()=>b(8569)))},F={132:[1132],183:[5183],397:[3397],672:[1672],804:[1338],877:[4422]},b.f.consumes=(a,c)=>{b.o(F,a)&&F[a].forEach(d=>{if(b.o(D,d))return c.push(D[d]);var e=a=>{D[d]=0,b.m[d]=c=>{delete b.c[d],c.exports=a()}},f=a=>{delete D[d],b.m[d]=()=>{throw delete b.c[d],a}};try{var g=E[d]();g.then?c.push(D[d]=g.then(e).catch(f)):e(g)}catch(a){f(a)}})},(()=>{var c={447:0};b.f.j=(d,e)=>{var f=b.o(c,d)?c[d]:void 0;if(0!==f)if(f)e.push(f[2]);else if(/^(183|397|672)$/.test(d))c[d]=0;else{var g=new Promise((b,e)=>f=c[d]=[b,e]);e.push(f[2]=g);var a=b.p+b.u(d),h=new Error;b.l(a,e=>{if(b.o(c,d)&&(0!==(f=c[d])&&(c[d]=void 0),f)){var g=e&&("load"===e.type?"missing":e.type),a=e&&e.target&&e.target.src;h.message="Loading chunk "+d+" failed.\n("+g+": "+a+")",h.name="ChunkLoadError",h.type=g,h.request=a,f[1](h)}},"chunk-"+d,d)}};var a=(d,e)=>{var f,g,[h,j,i]=e,k=0;if(h.some(a=>0!==c[a])){for(f in j)b.o(j,f)&&(b.m[f]=j[f]);i&&i(b)}for(d&&d(e);k<h.length;k++)g=h[k],b.o(c,g)&&c[g]&&c[g][0](),c[g]=0},d=self.webpackChunk_openmrs_esm_fast_data_entry_app=self.webpackChunk_openmrs_esm_fast_data_entry_app||[];d.forEach(a.bind(null,0)),d.push=a.bind(null,d.push.bind(d))})(),b.nc=void 0;var m=b(7140);_openmrs_esm_fast_data_entry_app=m})();

package/docs/configuring-form-categories.md

@@ -0,0 +1,77 @@
+# Configuring Form Categories for Fast Data Entry App
+
+Configuration of which Form Categories to show, and which forms exist within each category is possible via configuration of Fast Data Entry App [config-schema](../src/config-schema.ts). For example, the configuration would setup one category "ICRC Forms" which contains one form, DASS-21. Note that formUUID must match the form UUID on the backend instance, and name is only for human readability and has no actual function.
+
+```json
+{
+  "@openmrs/esm-fast-data-entry-app": {
+    "formCategories": [
+      {
+        "name": "ICRC Forms",
+        "forms": [
+          {
+            "formUUID": "373086b0-0a65-3763-ab83-21b8867bbc6f",
+            "name": "DASS-21"
+          }
+        ]
+      }
+    ],
+    "formCategoriesToShow": [
+      "ICRC Forms"
+    ]
+  }
+}
+```
+
+This config results in the following UI:
+
+![Configure ICRC Forms](config-icrc-forms.png)
+
+Note that All Forms is always present and contains all forms the system can find.
+
+Let's see another example. The following config will load up one more form category called "Other Forms" to show, but both entries in that form category are not able to be found in the system, so no forms will render when we navigate to the "Other Forms". Also note that "Third Category of Forms" is declared, but since it's not included in the formCategoriesToShow array it is not displayed on the UI.
+
+```json
+{
+  "@openmrs/esm-fast-data-entry-app": {
+    "formCategories": [{
+        "name": "ICRC Forms",
+        "forms": [{
+          "formUUID": "373086b0-0a65-3763-ab83-21b8867bbc6f",
+          "name": "DASS-21"
+        }]
+      },
+      {
+        "name": "Other Forms",
+        "forms": [{
+            "formUUID": "00000000-0a65-3763-ab83-21b",
+            "name": "No Matching UUID"
+          },
+          {
+            "formUUID": "This isn't a UUID!",
+            "name": "Invalid UUID"
+          }
+        ]
+      },
+      {
+        "name": "Third Category of Forms",
+        "forms": [{
+          "formUUID": "ce7a6da7-444a-3038-bfc2-334ff84b86c0",
+          "name": "CRIES-8"
+        }]
+      }
+    ],
+    "formCategoriesToShow": [
+      "ICRC Forms",
+      "Other Forms"
+    ]
+  }
+}
+```
+
+This will render the following UI
+
+![Configure Other Forms](config-other-forms.png)
+
+
+For more information on using the OpenMRS configuration system see [this page](https://o3-dev.docs.openmrs.org/#/main/config)

package/jest.config.json

@@ -1,18 +1,20 @@
-{
-  "transform": {
-    "^.+\\.tsx?$": "babel-jest"
-  },
-  "transformIgnorePatterns": [
-    "/node_modules/(?!@openmrs)"
-  ],
-  "moduleNameMapper": {
-    "^@carbon/icons-react/es/(.*)$": "@carbon/icons-react/lib/$1",
-    "^carbon-components-react/es/(.*)$": "carbon-components-react/lib/$1",
-    "@openmrs/esm-framework": "@openmrs/esm-framework/mock",
-    "\\.(s?css)$": "identity-obj-proxy"
-  },
-  "setupFilesAfterEnv": [
-    "<rootDir>/src/setup-tests.ts"
-  ],
-  "testEnvironment": "jsdom"
-}
+
+{
+  "transform": {
+    "^.+\\.tsx?$": "@swc/jest"
+  },
+  "transformIgnorePatterns": ["/node_modules/(?!@openmrs)"],
+  "moduleNameMapper": {
+    "\\.(s?css)$": "identity-obj-proxy",
+    "@openmrs/esm-framework": "@openmrs/esm-framework/mock",
+    "^lodash-es/(.*)$": "lodash/$1",
+    "^uuid$": "<rootDir>/node_modules/uuid/dist/index.js"
+  },
+  "setupFilesAfterEnv": [
+    "<rootDir>/src/setup-tests.ts"
+  ],
+  "testEnvironment": "jsdom",
+  "testEnvironmentOptions": {
+    "url": "http://localhost/"
+  }
+}

package/package.json

@@ -1,106 +1,97 @@
-{
-  "name": "@openmrs/esm-fast-data-entry-app",
-  "version": "1.0.0-pre.9",
-  "license": "MPL-2.0",
-  "description": "An OpenMRS 3.x microfrontend",
-  "browser": "dist/openmrs-esm-fast-data-entry-app.js",
-  "main": "src/index.ts",
-  "source": true,
-  "scripts": {
-    "start": "openmrs develop",
-    "serve": "webpack serve --mode=development",
-    "build": "webpack --mode production",
-    "analyze": "webpack --mode=production --env.analyze=true",
-    "lint": "eslint src --ext js,jsx,ts,tsx",
-    "prettier": "prettier --write \"src/**/*.{ts,tsx}\"",
-    "typescript": "tsc",
-    "test": "jest --config jest.config.json",
-    "verify": "concurrently 'yarn:lint' 'yarn:test' 'yarn:typescript'",
-    "coverage": "yarn test -- --coverage",
-    "prepare": "husky install"
-  },
-  "husky": {
-    "hooks": {
-      "pre-commit": "pretty-quick --staged && yarn verify"
-    }
-  },
-  "browserslist": [
-    "extends browserslist-config-openmrs"
-  ],
-  "keywords": [
-    "openmrs",
-    "microfrontends"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/openmrs/openmrs-esm-fast-data-entry-app.git"
-  },
-  "resolutions": {
-    "@types/react": "17.0.2",
-    "@types/react-dom": "17.0.2"
-  },
-  "homepage": "https://github.com/openmrs/openmrs-esm-fast-data-entry-app#readme",
-  "publishConfig": {
-    "access": "public"
-  },
-  "bugs": {
-    "url": "https://github.com/openmrs/openmrs-esm-fast-data-entry-app/issues"
-  },
-  "dependencies": {
-    "@carbon/icons-react": "^10.18.0",
-    "carbon-components-react": "^7.25.0",
-    "lodash-es": "^4.17.15"
-  },
-  "peerDependencies": {
-    "@openmrs/esm-framework": "^3.14.0-pre",
-    "carbon-components": "10.x",
-    "carbon-icons": "7.x",
-    "dayjs": "1.x",
-    "react": "16.x",
-    "react-i18next": "11.x",
-    "react-router-dom": "5.x",
-    "rxjs": "6.x"
-  },
-  "devDependencies": {
-    "@babel/core": "^7.14.3",
-    "@babel/plugin-proposal-class-properties": "^7.13.0",
-    "@babel/preset-env": "^7.14.4",
-    "@babel/preset-react": "^7.13.13",
-    "@babel/preset-typescript": "^7.13.0",
-    "@babel/runtime": "^7.14.0",
-    "@openmrs/esm-framework": "next",
-    "@testing-library/dom": "^7.31.2",
-    "@testing-library/jest-dom": "^5.13.0",
-    "@testing-library/react": "^11.2.7",
-    "@testing-library/user-event": "^13.1.9",
-    "@types/carbon-components-react": "^7.34.0",
-    "@types/carbon__icons-react": "^10.31.0",
-    "@types/jest": "^26.0.23",
-    "@types/react-dom": "^16.9.14",
-    "@types/react-router": "^5.1.14",
-    "@types/react-router-dom": "^5.1.7",
-    "@types/webpack-env": "^1.16.0",
-    "@typescript-eslint/parser": "^5.14.0",
-    "babel-eslint": "^10.1.0",
-    "babel-jest": "^27.0.2",
-    "babel-preset-minify": "^0.5.1",
-    "concurrently": "^6.2.0",
-    "eslint": "^7.27.0",
-    "eslint-config-prettier": "^8.3.0",
-    "eslint-config-ts-react-important-stuff": "^3.0.0",
-    "eslint-plugin-prettier": "^3.4.0",
-    "husky": "^6.0.0",
-    "identity-obj-proxy": "^3.0.0",
-    "jest": "^27.0.4",
-    "jest-cli": "^27.0.4",
-    "openmrs": "next",
-    "prettier": "^2.3.0",
-    "pretty-quick": "^3.1.0",
-    "react": "^16.13.1",
-    "react-dom": "^16.14.0",
-    "react-i18next": "^11.16.9",
-    "react-router-dom": "^5.2.0",
-    "rxjs": "^6.5.4",
-    "typescript": "^4.3.2"
-  }
-}
+{
+  "name": "@openmrs/esm-fast-data-entry-app",
+  "version": "1.0.1-pre.8",
+  "license": "MPL-2.0",
+  "description": "An OpenMRS 3.x microfrontend",
+  "browser": "dist/openmrs-esm-fast-data-entry-app.js",
+  "main": "src/index.ts",
+  "source": true,
+  "scripts": {
+    "start": "openmrs develop",
+    "serve": "webpack serve --mode=development",
+    "build": "webpack --mode production",
+    "analyze": "webpack --mode=production --env.analyze=true",
+    "lint": "eslint \"src/**/*.ts\" \"src/**/*.tsx\" --fix --max-warnings=0 -c .eslintrc.js",
+    "prettier": "prettier --write \"src/**/*.{ts,tsx}\"",
+    "typescript": "tsc",
+    "test": "jest --config jest.config.json --passWithNoTests",
+    "verify": "concurrently 'yarn:lint' 'yarn:test' 'yarn:typescript'",
+    "coverage": "yarn test -- --coverage ",
+    "prepare": "husky install"
+  },
+  "husky": {
+    "hooks": {
+      "pre-commit": "pretty-quick --staged && yarn verify"
+    }
+  },
+  "browserslist": [
+    "extends browserslist-config-openmrs"
+  ],
+  "keywords": [
+    "openmrs",
+    "microfrontends"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/openmrs/openmrs-esm-fast-data-entry-app.git"
+  },
+  "homepage": "https://github.com/openmrs/openmrs-esm-fast-data-entry-app#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bugs": {
+    "url": "https://github.com/openmrs/openmrs-esm-fast-data-entry-app/issues"
+  },
+  "peerDependencies": {
+    "@carbon/react": "^1.9.0",
+    "@openmrs/esm-framework": "*",
+    "react": "18.x",
+    "react-dom": "18.x",
+    "react-i18next": "11.x",
+    "react-router-dom": "6.x"
+  },
+  "devDependencies": {
+    "@carbon/react": "^1.9.0",
+    "@openmrs/esm-framework": "next",
+    "@swc/core": "^1.2.245",
+    "@swc/jest": "^0.2.22",
+    "@testing-library/dom": "^7.20.0",
+    "@testing-library/jest-dom": "^5.16.5",
+    "@testing-library/react": "^13.3.0",
+    "@testing-library/user-event": "^14.4.3",
+    "@types/jest": "^28.1.7",
+    "@types/react-dom": "^18.0.6",
+    "@types/react-router-dom": "^5.3.3",
+    "@types/testing-library__jest-dom": "^5.14.5",
+    "@types/webpack-env": "^1.16.0",
+    "@typescript-eslint/parser": "^5.14.0",
+    "concurrently": "^6.2.0",
+    "eslint": "^8.20.0",
+    "eslint-config-prettier": "^8.3.0",
+    "eslint-config-react-app": "^7.0.1",
+    "eslint-config-ts-react-important-stuff": "^3.0.0",
+    "eslint-plugin-prettier": "^4.2.1",
+    "husky": "^8.0.1",
+    "identity-obj-proxy": "^3.0.0",
+    "jest": "^28.1.3",
+    "jest-cli": "^28.1.3",
+    "jest-environment-jsdom": "^28.1.3",
+    "openmrs": "next",
+    "prettier": "^2.3.0",
+    "pretty-quick": "^3.1.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "react-i18next": "^11.18.4",
+    "react-router-dom": "^6.3.0",
+    "semver": "^7.3.7",
+    "swc-loader": "^0.2.3",
+    "swr": "^1.3.0",
+    "typescript": "^4.7.3",
+    "webpack": "^5.73.0"
+  },
+  "packageManager": "yarn@3.2.2",
+  "dependencies": {
+    "react-hook-form": "^7.34.2"
+  },
+  "stableVersion": "1.0.0"
+}

package/src/FormBootstrap.tsx

@@ -0,0 +1,151 @@
+import React, { useEffect } from "react";
+import { detach, ExtensionSlot } from "@openmrs/esm-framework";
+import useGetPatient from "./hooks/useGetPatient";
+
+export interface Order {
+  uuid: string;
+  dateActivated: string;
+  dose: number;
+  doseUnits: {
+    uuid: string;
+    display: string;
+  };
+  orderNumber: number;
+  display: string;
+  drug: {
+    uuid: string;
+    name: string;
+    strength: string;
+  };
+  duration: number;
+  durationUnits: {
+    uuid: string;
+    display: string;
+  };
+  frequency: {
+    uuid: string;
+    display: string;
+  };
+  numRefills: number;
+  orderer: {
+    uuid: string;
+    person: {
+      uuid: string;
+      display: string;
+    };
+  };
+  orderType: {
+    uuid: string;
+    display: string;
+  };
+  route: {
+    uuid: string;
+    display: string;
+  };
+  auditInfo: {
+    dateVoided: string;
+  };
+}
+
+export interface Observation {
+  uuid: string;
+  concept: {
+    uuid: string;
+    display: string;
+    conceptClass: {
+      uuid: string;
+      display: string;
+    };
+  };
+  display: string;
+  groupMembers: null | Array<{
+    uuid: string;
+    concept: {
+      uuid: string;
+      display: string;
+    };
+    value: {
+      uuid: string;
+      display: string;
+    };
+  }>;
+  value: unknown;
+  obsDatetime: string;
+}
+
+export interface Encounter {
+  uuid: string;
+  encounterDatetime: string;
+  encounterProviders: Array<{
+    uuid: string;
+    display: string;
+    encounterRole: {
+      uuid: string;
+      display: string;
+    };
+    provider: {
+      uuid: string;
+      person: {
+        uuid: string;
+        display: string;
+      };
+    };
+  }>;
+  encounterType: {
+    uuid: string;
+    display: string;
+  };
+  obs: Array<Observation>;
+  orders: Array<Order>;
+}
+interface FormParams {
+  formUuid: string;
+  patientUuid: string;
+  visitUuid?: string;
+  visitTypeUuid?: string;
+  encounterUuid?: string;
+  showDiscardSubmitButtons?: boolean;
+  handlePostResponse?: (Encounter) => void;
+  handleEncounterCreate?: (Object) => void;
+}
+
+const FormBootstrap = ({
+  formUuid,
+  patientUuid,
+  visitUuid,
+  visitTypeUuid,
+  encounterUuid,
+  handlePostResponse,
+  handleEncounterCreate,
+}: FormParams) => {
+  const patient = useGetPatient(patientUuid);
+
+  useEffect(() => {
+    return () => detach("form-widget-slot", "form-widget-slot");
+  });
+
+  return (
+    <div>
+      {formUuid && patientUuid && patient && (
+        <ExtensionSlot
+          extensionSlotName="form-widget-slot"
+          state={{
+            view: "form",
+            formUuid,
+            visitUuid: visitUuid ?? "",
+            visitTypeUuid: visitTypeUuid ?? "",
+            patientUuid,
+            patient,
+            encounterUuid: encounterUuid ?? "",
+            closeWorkspace: () => undefined,
+            handlePostResponse,
+            handleEncounterCreate,
+            showDiscardSubmitButtons: false,
+          }}
+        />
+      )}
+    </div>
+  );
+};
+
+export default FormBootstrap;

package/src/Root.tsx

@@ -1,13 +1,24 @@
 import React from "react";
-import { BrowserRouter, Route } from "react-router-dom";
+import { BrowserRouter, Route, Routes } from "react-router-dom";
 import { appPath } from "./constant";
-import FormsRoot from "./forms/FormsRoot";
+const FormsPage = React.lazy(() => import("./forms-page"));
+const FormEntryWorkflow = React.lazy(() => import("./form-entry-workflow"));
+const GroupFormEntryWorkflow = React.lazy(
+  () => import("./group-form-entry-workflow")
+);
 
 const Root = () => {
   return (
     <main>
       <BrowserRouter basename={appPath}>
-        <Route path="/:tab?" component={FormsRoot} />
+        <Routes>
+          <Route path="/" element={<FormsPage />} />
+          <Route path="/form/:formUuid" element={<FormEntryWorkflow />} />
+          <Route
+            path="/groupform/:formUuid"
+            element={<GroupFormEntryWorkflow />}
+          />
+        </Routes>
       </BrowserRouter>
     </main>
   );