working and not working versions

Author: greshje

WebContent/lforms-30.0.0/LICENSE.md

@@ -0,0 +1,70 @@
+# LICENSE
+
+Licensing and Copyright Notice and Terms of Use
+
+Owner Notice: This software (including any associated website-service or
+downloadable source (code) was developed by the Lister Hill National Center
+for Biomedical Communications (LHNCBC), a research and development division
+of the U.S. National Library of Medicine (NLM), with the permission and based
+on the copyrighted content of the Regenstrief Institute.
+
+This material may contain content from LOINC ® (http://loinc.org). The
+LOINC table, LOINC codes, LOINC panels and forms file, LOINC linguistic variants
+file, LOINC/RSNA Radiology Playbook, and LOINC/IEEE Medical Device Code Mapping
+Table are copyright © 1995-2016, Regenstrief Institute, Inc. and the
+Logical Observation Identifiers Names and Codes (LOINC) Committee and is
+available at no cost under the license at http://loinc.org/terms-of-use.
+LOINC ® is a registered United States trademark of Regenstrief Institute, Inc.
+
+If LOINC content is included, this software is distributed under the conditions
+set forth at https://loinc.org/terms-of-use and the following terms and conditions.
+
+If this product includes all or a portion of the UCUM table, UCUM codes, and
+UCUM definitions or is derived from it, it is subject to a license from
+Regenstrief Institute, Inc. and The UCUM Organization. Your use of the UCUM table,
+UCUM codes, UCUM definitions also is subject to this license, a copy of which is
+available at http://unitsofmeasure.org. The current complete UCUM table, UCUM
+Specification are available for download at http://unitsofmeasure.org. The UCUM
+table and UCUM codes are copyright © 1995-2009, Regenstrief Institute, Inc.
+and the Unified Codes for Units of Measures (UCUM) Organization. All rights reserved.
+
+If UCUM content is included, this software is distributed under the conditions
+set forth at http://unitsofmeasure.org/trac/wiki/TermsOfUse and the following
+terms and conditions.
+
+The following terms and conditions are based on the BSD open-source license.
+
+If publishing research that used this software, please include a citation that
+acknowledges it.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted for commercial and non-commercial purposes and products alike,
+provided that the following conditions are met:
+
+  * Redistributions of source code shall retain the above Owner Notice, this
+  list of conditions and the following disclaimer, and display them prominently.
+  * Redistributions in binary form shall prominently reproduce the above Owner
+  Notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+  * Neither the names of the National Library of Medicine (NLM), the Lister
+  Hill National Center for Biomedical Communications (LHNCBC), the National
+  Institutes of Health (NIH), nor the names of any of the software contributors
+  may be used to endorse or promote products derived from this software without
+  specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE OWNER AND CONTRIBUTORS "AS IS" AND ANY EXPRESS
+OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
+SHALL THE OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+
+THE UCUM TABLE (IN ALL FORMATS), UCUM DEFINITIONS, AND SPECIFICATION ARE
+PROVIDED "AS IS." ANY EXPRESS OR IMPLIED WARRANTIES ARE DISCLAIMED, INCLUDING,
+BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE.
+

WebContent/lforms-30.0.0/README.md

@@ -0,0 +1,99 @@
+## What is LForms?
+
+[LForms](http://lhncbc.github.io/lforms/), a.k.a. LHC-Forms, is a feature-rich,
+open-source Web Component that creates input forms, based on definition files, for
+Web-based applications. In addition to its native form-definition format, it
+partially supports the HL7 FHIR Questionnaire standard (SDC profile), and work
+is in progress to expand that support.
+
+It is being developed by the Lister Hill National Center for Biomedical
+Communications ([LHNCBC](https://lhncbc.nlm.nih.gov)), National Library of
+Medicine ([NLM](https://www.nlm.nih.gov)), part of the National Institutes of
+Health ([NIH](https://www.nih.gov)), with the collaboration and support from the
+[Regenstrief Institute](https://www.regenstrief.org/), Inc. and the
+[LOINC](https://loinc.org/) Committee.
+
+For features and demos, please visit the [project
+page](http://lhncbc.github.io/lforms/).
+
+## Licensing and Copyright Notice
+See [LICENSE.md](LICENSE.md).
+
+## Customizing and Contributing
+If you wish to revise this package, the following steps will allow you to make
+changes and test them:
+
+* Install Node.js (version 14 is what we are currently using, but it should work with later versions)
+* Clone the lforms repository and cd to its directory
+* `source bashrc.lforms` (make sure node dir is available at ~/)    
+* `npm ci`
+* `source bashrc.lforms` # to add node_modules/.bin to your path
+* `npm run build` # build both FHIR libs and LHC-Forms web component
+* `npm run start` # starts the app we use for testing
+* `npm run test` # runs the unit tests and e2e tests
+
+If you are planning to contribute new functionality back to us, please
+coordinate with us, so that the new code is in the right places, and so that
+you don't accidentally add something that we are also working on.
+
+## Development server
+
+* Run `npm run start` for a dev server. Navigate to `http://localhost:4200/`. 
+   The app will automatically reload if you change any of the source files.
+
+* Run `npm run start-public` if you need to access to the dev server from a different machine. 
+   For example, to run Narrator from a Windows PC.
+
+## Build
+
+* Run `npm run build` to build the project and generate a production version of
+  the js files, which are much smaller than the development version. It
+  generates two versions of the js files, an ES5 version and ES2015 version, under
+  dist/lforms.  For details on the files to load, see ["Usng the LHC-Forms Web
+  Component"](#using).  The `dist` directory is deleted and recreated during the
+  process. 
+  
+  The build also concatenates all the js files (except for zone.min.js and the
+  FHIR support files) into a single `lhc-forms.es5.js` and `lhc-forms.es2015.js`
+  file, and these work, but we don't currently recommend their use because the
+  source maps don't work with these files.  Also, there is a dist/webcomponent
+  directory that is created with a copy of the files in dist/lforms, but that
+  is only needed for the tests.
+
+## Running tests
+1. Run `npm run test` to run unit tests and e2e tests, which also copies the FHIR lib files 
+   and built files in places for testing.
+
+## Running unit tests
+
+1. Run `npm run test:unit` to execute the unit tests via [Karma](https://karma-runner.github.io).
+
+## Running end-to-end tests
+
+1. Run `npm run test:e2e:prepare` to copy necessary files in places for the tests and to update the web driver.
+
+1. Run `npm run test:e2e` to execute the end-to-end tests via [Protractor](http://www.protractortest.org/). 
+   The e2e tests is configured to use Chrome. If Chrome has been updated, run `npm run update-webdriver` 
+   to update the Chrome web driver.
+
+## <a id="using">Using the LHC-Forms Web Component</a>
+There are several script files to load.  If you are building this or installing via npm, these files will be
+under `dist/lforms`.  If you are using the pre-built versions from
+https://clinicaltables.nlm.nih.gov/lforms-versions, then the file paths below
+are relative to those versioned directories.
+1. `webcomponent/styles.css`
+
+You need to include the following files in your project: 
+1. `webcomponent/styles.css`
+2. `webcomponent/assets/lib/zone.min.js` (unless you already have zone.min.js on the page)
+3. `webcomponent/scripts.js`
+4. `webcomponent/runtime-[es5|es2015].js`
+5. `webcomponent/polyfills-[es5|es2015].js`
+6. `webcomponent/main-[es5|es2015].js`
+7. *One* of the FHIR support library files, assuming you are planning to use
+   FHIR Questionnaires:
+   * `fhir/lformsFHIRAll.min.js`
+   * `fhir/R4/lformsFHIR.min.js`
+   * `fhir/STU3/lformsFHIR.min.js`
+
+There is an example of an app using these files at https://lhcforms.nlm.nih.gov/lforms-fhir-app/.