@openmrs/esm-context 3.1.3 → 5.5.1-pre.1752

package/.turbo/turbo-build.log

@@ -0,0 +1,8 @@
+@openmrs/esm-context:build: cache hit, replaying output ca9a34bb0e2a39dc
+@openmrs/esm-context:build: asset openmrs-esm-context.js 2.24 KiB [emitted] [minimized] (name: main) 1 related asset
+@openmrs/esm-context:build: runtime modules 670 bytes 3 modules
+@openmrs/esm-context:build: orphan modules 4.84 KiB [orphan] 2 modules
+@openmrs/esm-context:build: built modules 4.91 KiB [built]
+@openmrs/esm-context:build:   ./src/index.ts + 2 modules 4.87 KiB [built] [code generated]
+@openmrs/esm-context:build:   external "@openmrs/esm-state" 42 bytes [built] [code generated]
+@openmrs/esm-context:build: webpack 5.88.0 compiled successfully in 8633 ms

package/README.md

@@ -1,42 +1,3 @@
 # openmrs-esm-context
 
-## What is this?
-
-openmrs-esm-context is an
-[in-browser javascript module](https://github.com/openmrs/openmrs-rfc-frontend/blob/master/text/0002-modules.md)
-that provides React [Context](https://reactjs.org/docs/context.html)
-that can be shared between modules, as well as the OpenMRS React Root Decorator.
-
-## Usage
-
-```js
-import openmrsRootDecorator from "@openmrs/esm-context";
-
-// Exported only for testing the component without the decorator being there.
-// You should use the default export for everything but tests.
-export function MyRoot(props) {
-  return <div>My component</div>;
-}
-
-export default openmrsRootDecorator({
-  // The featureName is shown to users! Make it human-friendly.
-  featureName: "A user-facing thing",
-  // moduleName is the name of your in-browser module, as it appears in the import map
-  moduleName: "@openmrs/esm-login-app",
-})(MyRoot);
-```
-
-## API
-
-`@openmrs/react-root-decorator` exports a function as the default export. That function must
-be called with an `opts` object with the following properties:
-
-- `featureName` (required): A string describing the feature. Example is `patient search`. This string is shown to users.
-- `moduleName` (required): The string name of your in-browser module, as it appears in the import map. Example: `"@openmrs/esm-login-app"`
-- `strictMode` (optional): A boolean that turns on [React strict mode](https://reactjs.org/docs/strict-mode.html).
-  Defaults to `true`.
-- `throwErrorsToConsole` (optional): A boolean that indicates whether React errors should be thrown to the window via
-  `setTimeout(() => {throw err})`. This is so that an automatic error logging library will be able to pick up the errors.
-  Defaults to `true`.
-
-The decorator returns a function that should then be called with your root react component.
+openmrs-esm-context provides the AppContext that is useful for sharing contextual state across the application.

package/dist/openmrs-esm-context.js

@@ -1,2 +1,2 @@
-System.register(["react","i18next","react-i18next"],(function(e){var t,n,r;return{setters:[function(e){t=e},function(e){n=e},function(e){r=e}],execute:function(){e(function(e){var t={};function n(r){if(t[r])return t[r].exports;var o=t[r]={i:r,l:!1,exports:{}};return e[r].call(o.exports,o,o.exports,n),o.l=!0,o.exports}return n.m=e,n.c=t,n.d=function(e,t,r){n.o(e,t)||Object.defineProperty(e,t,{enumerable:!0,get:r})},n.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},n.t=function(e,t){if(1&t&&(e=n(e)),8&t)return e;if(4&t&&"object"==typeof e&&e&&e.__esModule)return e;var r=Object.create(null);if(n.r(r),Object.defineProperty(r,"default",{enumerable:!0,value:e}),2&t&&"string"!=typeof e)for(var o in e)n.d(r,o,function(t){return e[t]}.bind(null,o));return r},n.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return n.d(t,"a",t),t},n.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},n.p="",n(n.s=3)}([function(e,n){e.exports=t},function(e,t){e.exports=n},function(e,t){e.exports=r},function(e,t,n){e.exports=n(4)},function(e,t,n){"use strict";n.r(t),n.d(t,"ExtensionContext",(function(){return a})),n.d(t,"ModuleNameContext",(function(){return c})),n.d(t,"openmrsRootDecorator",(function(){return m}));var r=n(0),o=n.n(r);const a=o.a.createContext({actualExtensionSlotName:"",attachedExtensionSlotName:"",extensionId:"",extensionModuleName:""}),c=o.a.createContext(null);var u=n(2),s=n(1),i=n.n(s);function l(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}const f=i.a.default||i.a,d={strictMode:!0,throwErrorsToConsole:!0,disableTranslations:!1};function m(e){if("object"!=typeof e||"string"!=typeof e.featureName||"string"!=typeof e.moduleName)throw new Error("openmrs-react-root-decorator should be called with an opts object that has 1. a featureName string that will be displayed to users, and 2. a moduleName string. The moduleName string will be used to look up configuration. e.g. openmrsRootDecorator({featureName: 'nice feature', moduleName: '@openmrs/esm-nice-feature' })");const t=Object.assign({},d,e);return function(e){var n,r;return r=n=class extends o.a.Component{constructor(...e){super(...e),l(this,"state",{caughtError:null,caughtErrorInfo:null})}render(){if(this.state.caughtError)return null;{const n=o.a.createElement(c.Provider,{value:t.moduleName},o.a.createElement(o.a.Suspense,{fallback:null},t.disableTranslations?o.a.createElement(e,this.props):o.a.createElement(p,{ns:t.moduleName,forceUpdate:()=>this.forceUpdate()},o.a.createElement(u.I18nextProvider,{i18n:f,defaultNS:t.moduleName},o.a.createElement(e,this.props)))));return t.strictMode||!o.a.StrictMode?n:o.a.createElement(o.a.StrictMode,null,n)}}componentDidCatch(e,n){n&&n.componentStack&&(e.extra=Object.assign(e.extra||{},{componentStack:n.componentStack})),t.throwErrorsToConsole&&setTimeout(()=>{throw e}),this.setState({caughtError:e,caughtErrorInfo:n})}},l(n,"displayName",`OpenmrsReactRoot(${t.featureName})`),r}}function p(e){o.a.useEffect(()=>(f.on("languageChanged",e.forceUpdate),()=>f.off("languageChanged",e.forceUpdate)),[e.forceUpdate]);const t=o.a.useRef(null);if(t.current)throw t.current;if(!f.hasLoadedNamespace(e.ns)){const n=setTimeout(()=>{console.warn(`openmrs-react-root-decorator: the React suspense promise for i18next.loadNamespaces(['${e.ns}']) did not resolve nor reject after three seconds. This could mean you have multiple versions of i18next and haven't made i18next a webpack external in all projects.`)},3e3);throw f.loadNamespaces([e.ns]).then(()=>{clearTimeout(n)}).catch(e=>{clearTimeout(n),t.current=e})}return e.children}}]))}}}));
+System.register(["@openmrs/esm-state"],(function(e,t){var r={};return{setters:[function(e){r.registerGlobalStore=e.registerGlobalStore}],execute:function(){e((()=>{"use strict";var e={685:e=>{e.exports=r}},t={};function n(r){var o=t[r];if(void 0!==o)return o.exports;var i=t[r]={exports:{}};return e[r](i,i.exports,n),i.exports}n.d=(e,t)=>{for(var r in t)n.o(t,r)&&!n.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:t[r]})},n.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),n.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var o={};return(()=>{n.r(o),n.d(o,{contextStore:()=>i,getContext:()=>a,registerContext:()=>c,subscribeToContext:()=>l,unregisterContext:()=>u,updateContext:()=>b});const e=e=>{let t;const r=new Set,n=(e,n)=>{const o="function"==typeof e?e(t):e;if(!Object.is(o,t)){const e=t;t=(null!=n?n:"object"!=typeof o)?o:Object.assign({},t,o),r.forEach((r=>r(t,e)))}},o=()=>t,i={setState:n,getState:o,subscribe:e=>(r.add(e),()=>r.delete(e)),destroy:()=>{console.warn("[DEPRECATED] The `destroy` method will be unsupported in a future version. Instead use unsubscribe function returned by subscribe. Everything will be garbage-collected if store is garbage-collected."),r.clear()}};return t=e(n,o,i),i};var t,r=n(685),i=(t?e(t):e)((function(){return{}}));(0,r.registerGlobalStore)("openmrs-app-context",i);var s=Object();function c(e){var t=arguments.length>1&&void 0!==arguments[1]?arguments[1]:s;i.setState((function(r){if(e in r)throw new Error("Attempted to re-register namespace ".concat(e," in the app context. Each namespace must be unregistered before the name can be registered again."));return r[e]=t===s?{}:t,r}))}function u(e){i.setState((function(t){return e in t&&delete t[e],t}))}function a(e){var t=arguments.length>1&&void 0!==arguments[1]?arguments[1]:function(e){return e},r=i.getState();return e in r?Object.freeze(Object.assign({},t?t(r[e]):r[e])):null}function b(e,t){i.setState((function(r){return e in r||(r[e]={}),r[e]=t(r[e]),r}))}function l(e,t){var r=a(e);return i.subscribe((function(n){var o=e in n?n[e]:null;o!==r&&(r=o,t(Object.freeze(Object.assign({},o))))}))}})(),o})())}}}));
 //# sourceMappingURL=openmrs-esm-context.js.map

package/dist/openmrs-esm-context.js.map

@@ -1 +1 @@
-{"version":3,"sources":["webpack:///webpack/bootstrap","webpack:///external \"react\"","webpack:///external \"i18next\"","webpack:///external \"react-i18next\"","webpack:///./src/context.ts","webpack:///./src/react-root-decorator.tsx"],"names":["installedModules","__webpack_require__","moduleId","exports","module","i","l","modules","call","m","c","d","name","getter","o","Object","defineProperty","enumerable","get","r","Symbol","toStringTag","value","t","mode","__esModule","ns","create","key","bind","n","object","property","prototype","hasOwnProperty","p","s","__WEBPACK_EXTERNAL_MODULE__0__","__WEBPACK_EXTERNAL_MODULE__1__","__WEBPACK_EXTERNAL_MODULE__2__","ExtensionContext","React","createContext","actualExtensionSlotName","attachedExtensionSlotName","extensionId","extensionModuleName","ModuleNameContext","i18n","_i18n","default","defaultOpts","strictMode","throwErrorsToConsole","disableTranslations","openmrsRootDecorator","userOpts","featureName","moduleName","Error","opts","assign","Comp","Component","caughtError","caughtErrorInfo","render","this","state","rootComponent","Provider","Suspense","fallback","props","I18nextLoadNamespace","forceUpdate","defaultNS","StrictMode","componentDidCatch","err","info","componentStack","extra","setTimeout","setState","useEffect","on","off","loadNamespaceErrRef","useRef","current","hasLoadedNamespace","timeoutId","console","warn","loadNamespaces","then","clearTimeout","catch","children"],"mappings":"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","file":"openmrs-esm-context.js","sourcesContent":[" \t// The module cache\n \tvar installedModules = {};\n\n \t// The require function\n \tfunction __webpack_require__(moduleId) {\n\n \t\t// Check if module is in cache\n \t\tif(installedModules[moduleId]) {\n \t\t\treturn installedModules[moduleId].exports;\n \t\t}\n \t\t// Create a new module (and put it into the cache)\n \t\tvar module = installedModules[moduleId] = {\n \t\t\ti: moduleId,\n \t\t\tl: false,\n \t\t\texports: {}\n \t\t};\n\n \t\t// Execute the module function\n \t\tmodules[moduleId].call(module.exports, module, module.exports, __webpack_require__);\n\n \t\t// Flag the module as loaded\n \t\tmodule.l = true;\n\n \t\t// Return the exports of the module\n \t\treturn module.exports;\n \t}\n\n\n \t// expose the modules object (__webpack_modules__)\n \t__webpack_require__.m = modules;\n\n \t// expose the module cache\n \t__webpack_require__.c = installedModules;\n\n \t// define getter function for harmony exports\n \t__webpack_require__.d = function(exports, name, getter) {\n \t\tif(!__webpack_require__.o(exports, name)) {\n \t\t\tObject.defineProperty(exports, name, { enumerable: true, get: getter });\n \t\t}\n \t};\n\n \t// define __esModule on exports\n \t__webpack_require__.r = function(exports) {\n \t\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n \t\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n \t\t}\n \t\tObject.defineProperty(exports, '__esModule', { value: true });\n \t};\n\n \t// create a fake namespace object\n \t// mode & 1: value is a module id, require it\n \t// mode & 2: merge all properties of value into the ns\n \t// mode & 4: return value when already ns object\n \t// mode & 8|1: behave like require\n \t__webpack_require__.t = function(value, mode) {\n \t\tif(mode & 1) value = __webpack_require__(value);\n \t\tif(mode & 8) return value;\n \t\tif((mode & 4) && typeof value === 'object' && value && value.__esModule) return value;\n \t\tvar ns = Object.create(null);\n \t\t__webpack_require__.r(ns);\n \t\tObject.defineProperty(ns, 'default', { enumerable: true, value: value });\n \t\tif(mode & 2 && typeof value != 'string') for(var key in value) __webpack_require__.d(ns, key, function(key) { return value[key]; }.bind(null, key));\n \t\treturn ns;\n \t};\n\n \t// getDefaultExport function for compatibility with non-harmony modules\n \t__webpack_require__.n = function(module) {\n \t\tvar getter = module && module.__esModule ?\n \t\t\tfunction getDefault() { return module['default']; } :\n \t\t\tfunction getModuleExports() { return module; };\n \t\t__webpack_require__.d(getter, 'a', getter);\n \t\treturn getter;\n \t};\n\n \t// Object.prototype.hasOwnProperty.call\n \t__webpack_require__.o = function(object, property) { return Object.prototype.hasOwnProperty.call(object, property); };\n\n \t// __webpack_public_path__\n \t__webpack_require__.p = \"\";\n\n\n \t// Load entry module and return exports\n \treturn __webpack_require__(__webpack_require__.s = 3);\n","module.exports = __WEBPACK_EXTERNAL_MODULE__0__;","module.exports = __WEBPACK_EXTERNAL_MODULE__1__;","module.exports = __WEBPACK_EXTERNAL_MODULE__2__;","import React from \"react\";\n\nexport interface ExtensionContextData {\n  actualExtensionSlotName: string;\n  attachedExtensionSlotName: string;\n  extensionId: string;\n  extensionModuleName: string;\n}\n\nexport const ExtensionContext = React.createContext<ExtensionContextData>({\n  actualExtensionSlotName: \"\",\n  attachedExtensionSlotName: \"\",\n  extensionId: \"\",\n  extensionModuleName: \"\",\n});\n\nexport const ModuleNameContext = React.createContext<string | null>(null);\n","import React from \"react\";\nimport { I18nextProvider } from \"react-i18next\";\nimport _i18n from \"i18next\";\nimport { ModuleNameContext } from \"./context\";\n\nconst i18n = (_i18n as any).default || _i18n;\n\nconst defaultOpts = {\n  strictMode: true,\n  throwErrorsToConsole: true,\n  disableTranslations: false,\n};\n\nexport function openmrsRootDecorator(userOpts) {\n  if (\n    typeof userOpts !== \"object\" ||\n    typeof userOpts.featureName !== \"string\" ||\n    typeof userOpts.moduleName !== \"string\"\n  ) {\n    throw new Error(\n      \"openmrs-react-root-decorator should be called with an opts object that has \" +\n        \"1. a featureName string that will be displayed to users, and 2. a moduleName string. \" +\n        \"The moduleName string will be used to look up configuration. \" +\n        \"e.g. openmrsRootDecorator({featureName: 'nice feature', moduleName: '@openmrs/esm-nice-feature' })\"\n    );\n  }\n\n  const opts = Object.assign({}, defaultOpts, userOpts);\n\n  return function decorateComponent(Comp) {\n    return class OpenmrsReactRoot extends React.Component {\n      static displayName = `OpenmrsReactRoot(${opts.featureName})`;\n      state = {\n        caughtError: null,\n        caughtErrorInfo: null,\n      };\n      render() {\n        if (this.state.caughtError) {\n          // TO-DO have a UX designed for when a catastrophic error occurs\n          return null;\n        } else {\n          const rootComponent = (\n            <ModuleNameContext.Provider value={opts.moduleName}>\n              <React.Suspense fallback={null}>\n                {opts.disableTranslations ? (\n                  <Comp {...this.props} />\n                ) : (\n                  <I18nextLoadNamespace\n                    ns={opts.moduleName}\n                    forceUpdate={() => this.forceUpdate()}\n                  >\n                    <I18nextProvider i18n={i18n} defaultNS={opts.moduleName}>\n                      <Comp {...this.props} />\n                    </I18nextProvider>\n                  </I18nextLoadNamespace>\n                )}\n              </React.Suspense>\n            </ModuleNameContext.Provider>\n          );\n          if (opts.strictMode || !React.StrictMode) {\n            return rootComponent;\n          } else {\n            return <React.StrictMode>{rootComponent}</React.StrictMode>;\n          }\n        }\n      }\n      componentDidCatch(err, info) {\n        if (info && info.componentStack) {\n          err.extra = Object.assign(err.extra || {}, {\n            componentStack: info.componentStack,\n          });\n        }\n\n        if (opts.throwErrorsToConsole) {\n          setTimeout(() => {\n            throw err;\n          });\n        }\n\n        this.setState({\n          caughtError: err,\n          caughtErrorInfo: info,\n        });\n      }\n    };\n  };\n}\n\nfunction I18nextLoadNamespace(props) {\n  React.useEffect(() => {\n    i18n.on(\"languageChanged\", props.forceUpdate);\n    return () => i18n.off(\"languageChanged\", props.forceUpdate);\n  }, [props.forceUpdate]);\n\n  const loadNamespaceErrRef = React.useRef(null);\n\n  if (loadNamespaceErrRef.current) {\n    throw loadNamespaceErrRef.current;\n  }\n\n  if (!i18n.hasLoadedNamespace(props.ns)) {\n    const timeoutId = setTimeout(() => {\n      console.warn(\n        `openmrs-react-root-decorator: the React suspense promise for i18next.loadNamespaces(['${props.ns}']) did not resolve nor reject after three seconds. This could mean you have multiple versions of i18next and haven't made i18next a webpack external in all projects.`\n      );\n    }, 3000);\n\n    throw i18n\n      .loadNamespaces([props.ns])\n      .then(() => {\n        clearTimeout(timeoutId);\n      })\n      .catch((err) => {\n        clearTimeout(timeoutId);\n        loadNamespaceErrRef.current = err;\n      });\n  }\n\n  return props.children;\n}\n"],"sourceRoot":""}
+{"version":3,"file":"openmrs-esm-context.js","mappings":"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","sources":["webpack://@openmrs/esm-context/external system \"@openmrs/esm-state\"","webpack://@openmrs/esm-context/webpack/bootstrap","webpack://@openmrs/esm-context/webpack/runtime/define property getters","webpack://@openmrs/esm-context/webpack/runtime/hasOwnProperty shorthand","webpack://@openmrs/esm-context/webpack/runtime/make namespace object","webpack://@openmrs/esm-context/../../../node_modules/zustand/esm/vanilla.mjs","webpack://@openmrs/esm-context/./src/context.ts"],"sourcesContent":["module.exports = __WEBPACK_EXTERNAL_MODULE__685__;","// The module cache\nvar __webpack_module_cache__ = {};\n\n// The require function\nfunction __webpack_require__(moduleId) {\n\t// Check if module is in cache\n\tvar cachedModule = __webpack_module_cache__[moduleId];\n\tif (cachedModule !== undefined) {\n\t\treturn cachedModule.exports;\n\t}\n\t// Create a new module (and put it into the cache)\n\tvar module = __webpack_module_cache__[moduleId] = {\n\t\t// no module.id needed\n\t\t// no module.loaded needed\n\t\texports: {}\n\t};\n\n\t// Execute the module function\n\t__webpack_modules__[moduleId](module, module.exports, __webpack_require__);\n\n\t// Return the exports of the module\n\treturn module.exports;\n}\n\n","// define getter functions for harmony exports\n__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n\t\tif(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n\t\t\tObject.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n\t\t}\n\t}\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","const createStoreImpl = (createState) => {\n  let state;\n  const listeners = /* @__PURE__ */ new Set();\n  const setState = (partial, replace) => {\n    const nextState = typeof partial === \"function\" ? partial(state) : partial;\n    if (!Object.is(nextState, state)) {\n      const previousState = state;\n      state = (replace != null ? replace : typeof nextState !== \"object\") ? nextState : Object.assign({}, state, nextState);\n      listeners.forEach((listener) => listener(state, previousState));\n    }\n  };\n  const getState = () => state;\n  const subscribe = (listener) => {\n    listeners.add(listener);\n    return () => listeners.delete(listener);\n  };\n  const destroy = () => {\n    if ((import.meta.env && import.meta.env.MODE) !== \"production\") {\n      console.warn(\n        \"[DEPRECATED] The `destroy` method will be unsupported in a future version. Instead use unsubscribe function returned by subscribe. Everything will be garbage-collected if store is garbage-collected.\"\n      );\n    }\n    listeners.clear();\n  };\n  const api = { setState, getState, subscribe, destroy };\n  state = createState(setState, getState, api);\n  return api;\n};\nconst createStore = (createState) => createState ? createStoreImpl(createState) : createStoreImpl;\nvar vanilla = (createState) => {\n  if ((import.meta.env && import.meta.env.MODE) !== \"production\") {\n    console.warn(\n      \"[DEPRECATED] Default export is deprecated. Instead use import { createStore } from 'zustand/vanilla'.\"\n    );\n  }\n  return createStore(createState);\n};\n\nexport { createStore, vanilla as default };\n","/** @module @category Context */\n'use strict';\n\nimport { createStore } from 'zustand/vanilla';\nimport { registerGlobalStore } from '@openmrs/esm-state';\n\ninterface OpenmrsAppContext {\n  [namespace: string]: unknown;\n}\n\n/**\n * @internal\n *\n * The application context store, using immer to potentially simplify updates\n */\nexport const contextStore = createStore<OpenmrsAppContext>()(() => ({}));\n\nregisterGlobalStore<OpenmrsAppContext>('openmrs-app-context', contextStore);\n\nconst nothing = Object();\n\n/**\n * Used by callers to register a new namespace in the application context. Attempting to register\n * an already-registered namespace will display a warning and make no modifications to the state.\n *\n * @param namespace the namespace to register\n * @param initialValue the initial value of the namespace\n */\nexport function registerContext<T extends {} = {}>(namespace: string, initialValue: T = nothing) {\n  contextStore.setState((state) => {\n    if (namespace in state) {\n      throw new Error(\n        `Attempted to re-register namespace ${namespace} in the app context. Each namespace must be unregistered before the name can be registered again.`,\n      );\n    }\n\n    state[namespace] = initialValue === nothing ? {} : initialValue;\n    return state;\n  });\n}\n\n/**\n * Used by caller to unregister a namespace in the application context. Unregistering a namespace\n * will remove the namespace and all associated data.\n */\nexport function unregisterContext(namespace: string) {\n  contextStore.setState((state) => {\n    if (namespace in state) {\n      delete state[namespace];\n    }\n    return state;\n  });\n}\n\nexport function getContext<T extends {} = {}>(namespace: string): Readonly<T> | null;\n/**\n * Returns an _immutable_ version of the state of the namespace as it is currently\n *\n * @typeParam T The type of the value stored in the namespace\n * @typeParam U The return type of this hook which is mostly relevant when using a selector\n * @param namespace The namespace to load properties from\n * @param selector An optional function which extracts the relevant part of the state\n */\nexport function getContext<T extends {} = {}, U extends {} = T>(\n  namespace: string,\n  selector: (state: Readonly<T>) => U = (state) => state as unknown as U,\n): Readonly<U> | null {\n  const state = contextStore.getState();\n  if (namespace in state) {\n    return Object.freeze(Object.assign({}, (selector ? selector(state[namespace] as T) : state[namespace]) as U));\n  }\n\n  return null;\n}\n\n/**\n * Updates a namespace in the global context. If the namespace does not exist, it is registered.\n */\nexport function updateContext<T extends {} = {}>(namespace: string, update: (state: T) => T) {\n  contextStore.setState((state) => {\n    if (!(namespace in state)) {\n      state[namespace] = {};\n    }\n\n    state[namespace] = update(state[namespace] as T);\n    return state;\n  });\n}\n\nexport type ContextCallback<T extends {} = {}> = (state: Readonly<T> | null | undefined) => void;\n\n/**\n * Subscribes to updates of a given namespace. Note that the returned object is immutable.\n *\n * @param namespace the namespace to subscribe to\n * @param callback a function invoked with the current context whenever\n * @returns A function to unsubscribe from the context\n */\nexport function subscribeToContext<T extends {} = {}>(namespace: string, callback: ContextCallback<T>) {\n  let previous = getContext<T>(namespace);\n\n  return contextStore.subscribe((state) => {\n    let current: Readonly<T> | null | undefined = namespace in state ? (state[namespace] as T) : null;\n\n    if (current !== previous) {\n      previous = current;\n      callback(Object.freeze(Object.assign({}, current)));\n    }\n  });\n}\n"],"names":["module","exports","__WEBPACK_EXTERNAL_MODULE__685__","__webpack_module_cache__","__webpack_require__","moduleId","cachedModule","undefined","__webpack_modules__","d","definition","key","o","Object","defineProperty","enumerable","get","obj","prop","prototype","hasOwnProperty","call","r","Symbol","toStringTag","value","createStoreImpl","createState","state","listeners","Set","setState","partial","replace","nextState","is","previousState","assign","forEach","listener","getState","api","subscribe","add","delete","destroy","console","warn","clear","contextStore","registerGlobalStore","nothing","registerContext","namespace","initialValue","Error","unregisterContext","getContext","selector","freeze","updateContext","update","subscribeToContext","callback","previous","current"],"sourceRoot":""}

package/jest.config.js

@@ -0,0 +1,9 @@
+module.exports = {
+  transform: {
+    '^.+\\.tsx?$': ['@swc/jest'],
+  },
+  testEnvironment: 'jsdom',
+  testEnvironmentOptions: {
+    url: 'http://localhost/',
+  },
+};

package/mock.ts

@@ -0,0 +1,24 @@
+const appContext = {};
+
+const nothing = Object();
+
+export function registerContext<T extends {} = {}>(namespace: string, initialValue: T = nothing) {
+  appContext[namespace] = initialValue ?? {};
+}
+
+export function getContext<T extends {} = {}, U extends {} = T>(
+  namespace: string,
+  selector: (state: Readonly<T>) => U = (state) => state as unknown as U,
+): Readonly<U> | null {
+  const value = appContext[namespace];
+
+  if (!value) {
+    return null;
+  }
+
+  return Object.freeze(Object.assign({}, selector ? selector(value) : value));
+}
+
+export function updateContext<T extends {} = {}>(namespace: string, update: (state: T) => T) {
+  appContext[namespace] = update(appContext[namespace] ?? {});
+}

package/package.json

@@ -1,14 +1,18 @@
 {
   "name": "@openmrs/esm-context",
-  "version": "3.1.3",
+  "version": "5.5.1-pre.1752",
   "license": "MPL-2.0",
-  "description": "Provides core React Context and the React Root Decorator",
+  "description": "Utilities for managing the current execution context",
   "browser": "dist/openmrs-esm-context.js",
   "main": "src/index.ts",
   "source": true,
+  "sideEffects": false,
   "scripts": {
-    "test": "jest --passWithNoTests",
+    "test": "cross-env TZ=UTC jest --config jest.config.js --verbose false --passWithNoTests --color",
+    "test:watch": "cross-env TZ=UTC jest --watch --config jest.config.js --color",
     "build": "webpack --mode=production",
+    "build:development": "webpack --mode development",
+    "analyze": "webpack --mode=production --env analyze=true",
     "typescript": "tsc",
     "lint": "eslint src --ext ts,tsx"
   },
@@ -31,23 +35,19 @@
     "url": "https://github.com/openmrs/openmrs-esm-core/issues"
   },
   "homepage": "https://github.com/openmrs/openmrs-esm-core#readme",
-  "dependencies": {
-    "systemjs-webpack-interop": "^2.1.2"
+  "publishConfig": {
+    "access": "public"
   },
   "peerDependencies": {
-    "@openmrs/esm-styleguide": "3.x",
-    "i18next": "19.x",
-    "react": "16.x",
-    "react-i18next": "11.x"
+    "@openmrs/esm-globals": "5.x",
+    "@openmrs/esm-state": "5.x"
   },
   "devDependencies": {
-    "@openmrs/esm-styleguide": "^3.1.3",
-    "i18next": "^19.6.0",
-    "react": "^16.13.1",
-    "react-i18next": "^11.7.0"
+    "@openmrs/esm-globals": "5.5.1-pre.1752",
+    "@openmrs/esm-state": "5.5.1-pre.1752"
   },
-  "publishConfig": {
-    "access": "public"
+  "dependencies": {
+    "immer": "^10.0.4"
   },
-  "gitHead": "555d8b6d3e456d5e48fc9b77a15e060884f07ce0"
-}
+  "stableVersion": "5.5.0"
+}

package/src/context.ts

@@ -1,17 +1,110 @@
-import React from "react";
+/** @module @category Context */
+'use strict';
 
-export interface ExtensionContextData {
-  actualExtensionSlotName: string;
-  attachedExtensionSlotName: string;
-  extensionId: string;
-  extensionModuleName: string;
+import { createStore } from 'zustand/vanilla';
+import { registerGlobalStore } from '@openmrs/esm-state';
+
+interface OpenmrsAppContext {
+  [namespace: string]: unknown;
+}
+
+/**
+ * @internal
+ *
+ * The application context store, using immer to potentially simplify updates
+ */
+export const contextStore = createStore<OpenmrsAppContext>()(() => ({}));
+
+registerGlobalStore<OpenmrsAppContext>('openmrs-app-context', contextStore);
+
+const nothing = Object();
+
+/**
+ * Used by callers to register a new namespace in the application context. Attempting to register
+ * an already-registered namespace will display a warning and make no modifications to the state.
+ *
+ * @param namespace the namespace to register
+ * @param initialValue the initial value of the namespace
+ */
+export function registerContext<T extends {} = {}>(namespace: string, initialValue: T = nothing) {
+  contextStore.setState((state) => {
+    if (namespace in state) {
+      throw new Error(
+        `Attempted to re-register namespace ${namespace} in the app context. Each namespace must be unregistered before the name can be registered again.`,
+      );
+    }
+
+    state[namespace] = initialValue === nothing ? {} : initialValue;
+    return state;
+  });
+}
+
+/**
+ * Used by caller to unregister a namespace in the application context. Unregistering a namespace
+ * will remove the namespace and all associated data.
+ */
+export function unregisterContext(namespace: string) {
+  contextStore.setState((state) => {
+    if (namespace in state) {
+      delete state[namespace];
+    }
+    return state;
+  });
 }
 
-export const ExtensionContext = React.createContext<ExtensionContextData>({
-  actualExtensionSlotName: "",
-  attachedExtensionSlotName: "",
-  extensionId: "",
-  extensionModuleName: "",
-});
+export function getContext<T extends {} = {}>(namespace: string): Readonly<T> | null;
+/**
+ * Returns an _immutable_ version of the state of the namespace as it is currently
+ *
+ * @typeParam T The type of the value stored in the namespace
+ * @typeParam U The return type of this hook which is mostly relevant when using a selector
+ * @param namespace The namespace to load properties from
+ * @param selector An optional function which extracts the relevant part of the state
+ */
+export function getContext<T extends {} = {}, U extends {} = T>(
+  namespace: string,
+  selector: (state: Readonly<T>) => U = (state) => state as unknown as U,
+): Readonly<U> | null {
+  const state = contextStore.getState();
+  if (namespace in state) {
+    return Object.freeze(Object.assign({}, (selector ? selector(state[namespace] as T) : state[namespace]) as U));
+  }
 
-export const ModuleNameContext = React.createContext<string | null>(null);
+  return null;
+}
+
+/**
+ * Updates a namespace in the global context. If the namespace does not exist, it is registered.
+ */
+export function updateContext<T extends {} = {}>(namespace: string, update: (state: T) => T) {
+  contextStore.setState((state) => {
+    if (!(namespace in state)) {
+      state[namespace] = {};
+    }
+
+    state[namespace] = update(state[namespace] as T);
+    return state;
+  });
+}
+
+export type ContextCallback<T extends {} = {}> = (state: Readonly<T> | null | undefined) => void;
+
+/**
+ * Subscribes to updates of a given namespace. Note that the returned object is immutable.
+ *
+ * @param namespace the namespace to subscribe to
+ * @param callback a function invoked with the current context whenever
+ * @returns A function to unsubscribe from the context
+ */
+export function subscribeToContext<T extends {} = {}>(namespace: string, callback: ContextCallback<T>) {
+  let previous = getContext<T>(namespace);
+
+  return contextStore.subscribe((state) => {
+    let current: Readonly<T> | null | undefined = namespace in state ? (state[namespace] as T) : null;
+
+    if (current !== previous) {
+      previous = current;
+      callback(Object.freeze(Object.assign({}, current)));
+    }
+  });
+}

package/src/index.ts

@@ -1,2 +1 @@
-export * from "./context";
-export * from "./react-root-decorator";
+export * from './context';

package/src/public.ts

@@ -0,0 +1 @@
+export * from './context';

package/tsconfig.json

@@ -2,6 +2,7 @@
   "compilerOptions": {
     "esModuleInterop": true,
     "module": "esnext",
+    "target": "es2015",
     "allowSyntheticDefaultImports": true,
     "jsx": "react",
     "strictNullChecks": true,
@@ -16,7 +17,8 @@
       "es2015",
       "es2015.promise",
       "es2016.array.include",
-      "es2018"
+      "es2018",
+      "esnext"
     ]
   },
   "include": ["src/**/*"]

package/webpack.config.js

@@ -1,41 +1,42 @@
-const { resolve } = require("path");
-const CleanWebpackPlugin = require("clean-webpack-plugin").CleanWebpackPlugin;
-const ForkTsCheckerWebpackPlugin = require("fork-ts-checker-webpack-plugin");
+const ForkTsCheckerWebpackPlugin = require('fork-ts-checker-webpack-plugin');
+const { resolve, basename } = require('path');
+const { CleanWebpackPlugin } = require('clean-webpack-plugin');
+const { BundleAnalyzerPlugin } = require('webpack-bundle-analyzer');
 
-const { peerDependencies } = require('./package.json');
+const { browser, peerDependencies } = require('./package.json');
 
-module.exports = {
-  entry: [resolve(__dirname, "src/index.ts")],
+module.exports = (env) => ({
+  entry: [resolve(__dirname, 'src/index.ts')],
   output: {
-    filename: "openmrs-esm-context.js",
-    path: resolve(__dirname, "dist"),
-    libraryTarget: "system",
+    filename: basename(browser),
+    path: resolve(__dirname, 'dist'),
+    library: { type: 'system' },
   },
-  devtool: "sourcemap",
+  devtool: 'source-map',
   module: {
     rules: [
-      {
-        parser: {
-          system: false,
-        },
-      },
       {
         test: /\.m?(js|ts|tsx)$/,
         exclude: /node_modules/,
-        use: "babel-loader",
+        use: 'swc-loader',
       },
     ],
   },
+  externals: Object.keys(peerDependencies || {}),
   resolve: {
-    extensions: [".ts", ".js", ".tsx", ".jsx"],
-    modules: ["node_modules", resolve(__dirname, "node_modules")],
+    extensions: ['.ts', '.js', '.tsx', '.jsx'],
   },
-  plugins: [new CleanWebpackPlugin(), new ForkTsCheckerWebpackPlugin()],
-  externals: Object.keys(peerDependencies),
+  plugins: [
+    new CleanWebpackPlugin(),
+    new ForkTsCheckerWebpackPlugin(),
+    new BundleAnalyzerPlugin({
+      analyzerMode: env && env.analyze ? 'static' : 'disabled',
+    }),
+  ],
   devServer: {
     disableHostCheck: true,
     headers: {
-      "Access-Control-Allow-Origin": "*",
+      'Access-Control-Allow-Origin': '*',
     },
   },
-};
+});

package/.babelrc

@@ -1,8 +0,0 @@
-{
-  "presets": [
-    "@babel/preset-env",
-    "@babel/preset-typescript",
-    "@babel/preset-react"
-  ],
-  "plugins": ["@babel/plugin-proposal-class-properties"]
-}

package/LICENSE

@@ -1,401 +0,0 @@
-Mozilla Public License, version 2.0
-
-1. Definitions
-
-1.1. "Contributor"
-
-     means each individual or legal entity that creates, contributes to the
-     creation of, or owns Covered Software.
-
-1.2. "Contributor Version"
-
-     means the combination of the Contributions of others (if any) used by a
-     Contributor and that particular Contributor's Contribution.
-
-1.3. "Contribution"
-
-     means Covered Software of a particular Contributor.
-
-1.4. "Covered Software"
-
-     means Source Code Form to which the initial Contributor has attached the
-     notice in Exhibit A, the Executable Form of such Source Code Form, and
-     Modifications of such Source Code Form, in each case including portions
-     thereof.
-
-1.5. "Incompatible With Secondary Licenses"
-     means
-
-     a. that the initial Contributor has attached the notice described in
-        Exhibit B to the Covered Software; or
-
-     b. that the Covered Software was made available under the terms of
-        version 1.1 or earlier of the License, but not also under the terms of
-        a Secondary License.
-
-1.6. "Executable Form"
-
-     means any form of the work other than Source Code Form.
-
-1.7. "Larger Work"
-
-     means a work that combines Covered Software with other material, in a
-     separate file or files, that is not Covered Software.
-
-1.8. "License"
-
-     means this document.
-
-1.9. "Licensable"
-
-     means having the right to grant, to the maximum extent possible, whether
-     at the time of the initial grant or subsequently, any and all of the
-     rights conveyed by this License.
-
-1.10. "Modifications"
-
-     means any of the following:
-
-     a. any file in Source Code Form that results from an addition to,
-        deletion from, or modification of the contents of Covered Software; or
-
-     b. any new file in Source Code Form that contains any Covered Software.
-
-1.11. "Patent Claims" of a Contributor
-
-      means any patent claim(s), including without limitation, method,
-      process, and apparatus claims, in any patent Licensable by such
-      Contributor that would be infringed, but for the grant of the License,
-      by the making, using, selling, offering for sale, having made, import,
-      or transfer of either its Contributions or its Contributor Version.
-
-1.12. "Secondary License"
-
-      means either the GNU General Public License, Version 2.0, the GNU Lesser
-      General Public License, Version 2.1, the GNU Affero General Public
-      License, Version 3.0, or any later versions of those licenses.
-
-1.13. "Source Code Form"
-
-      means the form of the work preferred for making modifications.
-
-1.14. "You" (or "Your")
-
-      means an individual or a legal entity exercising rights under this
-      License. For legal entities, "You" includes any entity that controls, is
-      controlled by, or is under common control with You. For purposes of this
-      definition, "control" means (a) the power, direct or indirect, to cause
-      the direction or management of such entity, whether by contract or
-      otherwise, or (b) ownership of more than fifty percent (50%) of the
-      outstanding shares or beneficial ownership of such entity.
-
-
-2. License Grants and Conditions
-
-2.1. Grants
-
-     Each Contributor hereby grants You a world-wide, royalty-free,
-     non-exclusive license:
-
-     a. under intellectual property rights (other than patent or trademark)
-        Licensable by such Contributor to use, reproduce, make available,
-        modify, display, perform, distribute, and otherwise exploit its
-        Contributions, either on an unmodified basis, with Modifications, or
-        as part of a Larger Work; and
-
-     b. under Patent Claims of such Contributor to make, use, sell, offer for
-        sale, have made, import, and otherwise transfer either its
-        Contributions or its Contributor Version.
-
-2.2. Effective Date
-
-     The licenses granted in Section 2.1 with respect to any Contribution
-     become effective for each Contribution on the date the Contributor first
-     distributes such Contribution.
-
-2.3. Limitations on Grant Scope
-
-     The licenses granted in this Section 2 are the only rights granted under
-     this License. No additional rights or licenses will be implied from the
-     distribution or licensing of Covered Software under this License.
-     Notwithstanding Section 2.1(b) above, no patent license is granted by a
-     Contributor:
-
-     a. for any code that a Contributor has removed from Covered Software; or
-
-     b. for infringements caused by: (i) Your and any other third party's
-        modifications of Covered Software, or (ii) the combination of its
-        Contributions with other software (except as part of its Contributor
-        Version); or
-
-     c. under Patent Claims infringed by Covered Software in the absence of
-        its Contributions.
-
-     This License does not grant any rights in the trademarks, service marks,
-     or logos of any Contributor (except as may be necessary to comply with
-     the notice requirements in Section 3.4).
-
-2.4. Subsequent Licenses
-
-     No Contributor makes additional grants as a result of Your choice to
-     distribute the Covered Software under a subsequent version of this
-     License (see Section 10.2) or under the terms of a Secondary License (if
-     permitted under the terms of Section 3.3).
-
-2.5. Representation
-
-     Each Contributor represents that the Contributor believes its
-     Contributions are its original creation(s) or it has sufficient rights to
-     grant the rights to its Contributions conveyed by this License.
-
-2.6. Fair Use
-
-     This License is not intended to limit any rights You have under
-     applicable copyright doctrines of fair use, fair dealing, or other
-     equivalents.
-
-2.7. Conditions
-
-     Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted in
-     Section 2.1.
-
-
-3. Responsibilities
-
-3.1. Distribution of Source Form
-
-     All distribution of Covered Software in Source Code Form, including any
-     Modifications that You create or to which You contribute, must be under
-     the terms of this License. You must inform recipients that the Source
-     Code Form of the Covered Software is governed by the terms of this
-     License, and how they can obtain a copy of this License. You may not
-     attempt to alter or restrict the recipients' rights in the Source Code
-     Form.
-
-3.2. Distribution of Executable Form
-
-     If You distribute Covered Software in Executable Form then:
-
-     a. such Covered Software must also be made available in Source Code Form,
-        as described in Section 3.1, and You must inform recipients of the
-        Executable Form how they can obtain a copy of such Source Code Form by
-        reasonable means in a timely manner, at a charge no more than the cost
-        of distribution to the recipient; and
-
-     b. You may distribute such Executable Form under the terms of this
-        License, or sublicense it under different terms, provided that the
-        license for the Executable Form does not attempt to limit or alter the
-        recipients' rights in the Source Code Form under this License.
-
-3.3. Distribution of a Larger Work
-
-     You may create and distribute a Larger Work under terms of Your choice,
-     provided that You also comply with the requirements of this License for
-     the Covered Software. If the Larger Work is a combination of Covered
-     Software with a work governed by one or more Secondary Licenses, and the
-     Covered Software is not Incompatible With Secondary Licenses, this
-     License permits You to additionally distribute such Covered Software
-     under the terms of such Secondary License(s), so that the recipient of
-     the Larger Work may, at their option, further distribute the Covered
-     Software under the terms of either this License or such Secondary
-     License(s).
-
-3.4. Notices
-
-     You may not remove or alter the substance of any license notices
-     (including copyright notices, patent notices, disclaimers of warranty, or
-     limitations of liability) contained within the Source Code Form of the
-     Covered Software, except that You may alter any license notices to the
-     extent required to remedy known factual inaccuracies.
-
-3.5. Application of Additional Terms
-
-     You may choose to offer, and to charge a fee for, warranty, support,
-     indemnity or liability obligations to one or more recipients of Covered
-     Software. However, You may do so only on Your own behalf, and not on
-     behalf of any Contributor. You must make it absolutely clear that any
-     such warranty, support, indemnity, or liability obligation is offered by
-     You alone, and You hereby agree to indemnify every Contributor for any
-     liability incurred by such Contributor as a result of warranty, support,
-     indemnity or liability terms You offer. You may include additional
-     disclaimers of warranty and limitations of liability specific to any
-     jurisdiction.
-
-4. Inability to Comply Due to Statute or Regulation
-
-   If it is impossible for You to comply with any of the terms of this License
-   with respect to some or all of the Covered Software due to statute,
-   judicial order, or regulation then You must: (a) comply with the terms of
-   this License to the maximum extent possible; and (b) describe the
-   limitations and the code they affect. Such description must be placed in a
-   text file included with all distributions of the Covered Software under
-   this License. Except to the extent prohibited by statute or regulation,
-   such description must be sufficiently detailed for a recipient of ordinary
-   skill to be able to understand it.
-
-5. Termination
-
-5.1. The rights granted under this License will terminate automatically if You
-     fail to comply with any of its terms. However, if You become compliant,
-     then the rights granted under this License from a particular Contributor
-     are reinstated (a) provisionally, unless and until such Contributor
-     explicitly and finally terminates Your grants, and (b) on an ongoing
-     basis, if such Contributor fails to notify You of the non-compliance by
-     some reasonable means prior to 60 days after You have come back into
-     compliance. Moreover, Your grants from a particular Contributor are
-     reinstated on an ongoing basis if such Contributor notifies You of the
-     non-compliance by some reasonable means, this is the first time You have
-     received notice of non-compliance with this License from such
-     Contributor, and You become compliant prior to 30 days after Your receipt
-     of the notice.
-
-5.2. If You initiate litigation against any entity by asserting a patent
-     infringement claim (excluding declaratory judgment actions,
-     counter-claims, and cross-claims) alleging that a Contributor Version
-     directly or indirectly infringes any patent, then the rights granted to
-     You by any and all Contributors for the Covered Software under Section
-     2.1 of this License shall terminate.
-
-5.3. In the event of termination under Sections 5.1 or 5.2 above, all end user
-     license agreements (excluding distributors and resellers) which have been
-     validly granted by You or Your distributors under this License prior to
-     termination shall survive termination.
-
-6. Disclaimer of Warranty
-
-   Covered Software is provided under this License on an "as is" basis,
-   without warranty of any kind, either expressed, implied, or statutory,
-   including, without limitation, warranties that the Covered Software is free
-   of defects, merchantable, fit for a particular purpose or non-infringing.
-   The entire risk as to the quality and performance of the Covered Software
-   is with You. Should any Covered Software prove defective in any respect,
-   You (not any Contributor) assume the cost of any necessary servicing,
-   repair, or correction. This disclaimer of warranty constitutes an essential
-   part of this License. No use of  any Covered Software is authorized under
-   this License except under this disclaimer.
-
-7. Limitation of Liability
-
-   Under no circumstances and under no legal theory, whether tort (including
-   negligence), contract, or otherwise, shall any Contributor, or anyone who
-   distributes Covered Software as permitted above, be liable to You for any
-   direct, indirect, special, incidental, or consequential damages of any
-   character including, without limitation, damages for lost profits, loss of
-   goodwill, work stoppage, computer failure or malfunction, or any and all
-   other commercial damages or losses, even if such party shall have been
-   informed of the possibility of such damages. This limitation of liability
-   shall not apply to liability for death or personal injury resulting from
-   such party's negligence to the extent applicable law prohibits such
-   limitation. Some jurisdictions do not allow the exclusion or limitation of
-   incidental or consequential damages, so this exclusion and limitation may
-   not apply to You.
-
-8. Litigation
-
-   Any litigation relating to this License may be brought only in the courts
-   of a jurisdiction where the defendant maintains its principal place of
-   business and such litigation shall be governed by laws of that
-   jurisdiction, without reference to its conflict-of-law provisions. Nothing
-   in this Section shall prevent a party's ability to bring cross-claims or
-   counter-claims.
-
-9. Miscellaneous
-
-   This License represents the complete agreement concerning the subject
-   matter hereof. If any provision of this License is held to be
-   unenforceable, such provision shall be reformed only to the extent
-   necessary to make it enforceable. Any law or regulation which provides that
-   the language of a contract shall be construed against the drafter shall not
-   be used to construe this License against a Contributor.
-
-
-10. Versions of the License
-
-10.1. New Versions
-
-      Mozilla Foundation is the license steward. Except as provided in Section
-      10.3, no one other than the license steward has the right to modify or
-      publish new versions of this License. Each version will be given a
-      distinguishing version number.
-
-10.2. Effect of New Versions
-
-      You may distribute the Covered Software under the terms of the version
-      of the License under which You originally received the Covered Software,
-      or under the terms of any subsequent version published by the license
-      steward.
-
-10.3. Modified Versions
-
-      If you create software not governed by this License, and you want to
-      create a new license for such software, you may create and use a
-      modified version of this License if you rename the license and remove
-      any references to the name of the license steward (except to note that
-      such modified license differs from this License).
-
-10.4. Distributing Source Code Form that is Incompatible With Secondary
-      Licenses If You choose to distribute Source Code Form that is
-      Incompatible With Secondary Licenses under the terms of this version of
-      the License, the notice described in Exhibit B of this License must be
-      attached.
-
-Exhibit A - Source Code Form License Notice
-
-      This Source Code Form is subject to the
-      terms of the Mozilla Public License, v.
-      2.0. If a copy of the MPL was not
-      distributed with this file, You can
-      obtain one at
-      http://mozilla.org/MPL/2.0/.
-
-If it is not possible or desirable to put the notice in a particular file,
-then You may include the notice in a location (such as a LICENSE file in a
-relevant directory) where a recipient would be likely to look for such a
-notice.
-
-You may add additional accurate notices of copyright ownership.
-
-Exhibit B - "Incompatible With Secondary Licenses" Notice
-
-      This Source Code Form is "Incompatible
-      With Secondary Licenses", as defined by
-      the Mozilla Public License, v. 2.0.
-
----------------------
-
-Healthcare Disclaimer
-
-In the United States, or any other jurisdictions where they may apply, the
-following additional disclaimer of warranty and limitation of liability are
-hereby incorporated into the terms and conditions of MPL 2.0:
-
-1.    No warranties of any kind whatsoever are made as to the results that
-      You will obtain from relying upon the covered code (or any information
-      or content obtained by way of the covered code), including but not
-      limited to compliance with privacy laws or regulations or clinical
-      care industry standards and protocols. Use of the covered code is not
-      a substitute for a health care provider’s standard practice or
-      professional judgment. Any decision with regard to the appropriateness
-      of treatment, or the validity or reliability of information or content
-      made available by the covered code, is the sole responsibility of the
-      health care provider. Consequently, it is incumbent upon each health
-      care provider to verify all medical history and treatment plans with
-      each patient.
-
-2.    Under no circumstances and under no legal theory, whether tort
-      (including negligence), contract, or otherwise, shall any Contributor,
-      or anyone who distributes Covered Software as permitted by the
-      license, be liable to You for any indirect, special, incidental,
-      consequential damages of any character including, without limitation,
-      damages for loss of goodwill, work stoppage, computer failure or
-      malfunction, or any and all other damages or losses, of any nature
-      whatsoever (direct or otherwise) on account of or associated with the
-      use or inability to use the covered content (including, without
-      limitation, the use of information or content made available by the
-      covered code, all documentation associated therewith, and the failure
-      of the covered code to comply with privacy laws and regulations or
-      clinical care industry standards and protocols), even if such party
-      shall have been informed of the possibility of such damages.
-
-Copyright (c) OpenMRS Inc.
-OpenMRS is a registered trademark and the OpenMRS graphic logo is a trademark of OpenMRS Inc.

package/src/react-root-decorator.test.tsx

@@ -1,44 +0,0 @@
-import React from "react";
-import { openmrsRootDecorator } from "./react-root-decorator";
-import { render, screen, waitFor } from "@testing-library/react";
-import { ModuleNameContext } from "./context";
-
-describe("openmrs-react-root-decorator", () => {
-  const opts = {
-    featureName: "Test",
-    throwErrorsToConsole: false,
-    moduleName: "test",
-  };
-
-  it("renders a component", () => {
-    const DecoratedComp = openmrsRootDecorator(opts)(CompThatWorks);
-    render(<DecoratedComp />);
-    waitFor(() => {
-      expect(screen.getByText("The button")).toBeTruthy();
-    });
-  });
-
-  it("catches any errors in the component tree and renders a ui explaining something bad happened", () => {
-    const DecoratedComp = openmrsRootDecorator(opts)(CompThatThrows);
-    render(<DecoratedComp />);
-    // TO-DO assert the UX for broken react app is showing
-  });
-
-  it("provides ModuleNameContext", () => {
-    const DecoratedComp = openmrsRootDecorator(opts)(CompWithConfig);
-    render(<DecoratedComp />);
-  });
-});
-
-function CompThatWorks() {
-  return <button>The button</button>;
-}
-
-function CompThatThrows() {
-  throw Error("ahahaa");
-}
-
-function CompWithConfig() {
-  const moduleName = React.useContext(ModuleNameContext);
-  return <div>{moduleName}</div>;
-}

package/src/react-root-decorator.tsx

@@ -1,120 +0,0 @@
-import React from "react";
-import { I18nextProvider } from "react-i18next";
-import _i18n from "i18next";
-import { ModuleNameContext } from "./context";
-
-const i18n = (_i18n as any).default || _i18n;
-
-const defaultOpts = {
-  strictMode: true,
-  throwErrorsToConsole: true,
-  disableTranslations: false,
-};
-
-export function openmrsRootDecorator(userOpts) {
-  if (
-    typeof userOpts !== "object" ||
-    typeof userOpts.featureName !== "string" ||
-    typeof userOpts.moduleName !== "string"
-  ) {
-    throw new Error(
-      "openmrs-react-root-decorator should be called with an opts object that has " +
-        "1. a featureName string that will be displayed to users, and 2. a moduleName string. " +
-        "The moduleName string will be used to look up configuration. " +
-        "e.g. openmrsRootDecorator({featureName: 'nice feature', moduleName: '@openmrs/esm-nice-feature' })"
-    );
-  }
-
-  const opts = Object.assign({}, defaultOpts, userOpts);
-
-  return function decorateComponent(Comp) {
-    return class OpenmrsReactRoot extends React.Component {
-      static displayName = `OpenmrsReactRoot(${opts.featureName})`;
-      state = {
-        caughtError: null,
-        caughtErrorInfo: null,
-      };
-      render() {
-        if (this.state.caughtError) {
-          // TO-DO have a UX designed for when a catastrophic error occurs
-          return null;
-        } else {
-          const rootComponent = (
-            <ModuleNameContext.Provider value={opts.moduleName}>
-              <React.Suspense fallback={null}>
-                {opts.disableTranslations ? (
-                  <Comp {...this.props} />
-                ) : (
-                  <I18nextLoadNamespace
-                    ns={opts.moduleName}
-                    forceUpdate={() => this.forceUpdate()}
-                  >
-                    <I18nextProvider i18n={i18n} defaultNS={opts.moduleName}>
-                      <Comp {...this.props} />
-                    </I18nextProvider>
-                  </I18nextLoadNamespace>
-                )}
-              </React.Suspense>
-            </ModuleNameContext.Provider>
-          );
-          if (opts.strictMode || !React.StrictMode) {
-            return rootComponent;
-          } else {
-            return <React.StrictMode>{rootComponent}</React.StrictMode>;
-          }
-        }
-      }
-      componentDidCatch(err, info) {
-        if (info && info.componentStack) {
-          err.extra = Object.assign(err.extra || {}, {
-            componentStack: info.componentStack,
-          });
-        }
-
-        if (opts.throwErrorsToConsole) {
-          setTimeout(() => {
-            throw err;
-          });
-        }
-
-        this.setState({
-          caughtError: err,
-          caughtErrorInfo: info,
-        });
-      }
-    };
-  };
-}
-
-function I18nextLoadNamespace(props) {
-  React.useEffect(() => {
-    i18n.on("languageChanged", props.forceUpdate);
-    return () => i18n.off("languageChanged", props.forceUpdate);
-  }, [props.forceUpdate]);
-
-  const loadNamespaceErrRef = React.useRef(null);
-
-  if (loadNamespaceErrRef.current) {
-    throw loadNamespaceErrRef.current;
-  }
-
-  if (!i18n.hasLoadedNamespace(props.ns)) {
-    const timeoutId = setTimeout(() => {
-      console.warn(
-        `openmrs-react-root-decorator: the React suspense promise for i18next.loadNamespaces(['${props.ns}']) did not resolve nor reject after three seconds. This could mean you have multiple versions of i18next and haven't made i18next a webpack external in all projects.`
-      );
-    }, 3000);
-
-    throw i18n
-      .loadNamespaces([props.ns])
-      .then(() => {
-        clearTimeout(timeoutId);
-      })
-      .catch((err) => {
-        clearTimeout(timeoutId);
-        loadNamespaceErrRef.current = err;
-      });
-  }
-
-  return props.children;
-}