Metadata-Version: 2.5
Name: bigquery_jupyter_plugin
Version: 0.1.0
Summary: BigQuery JupyterLab Plugin
Project-URL: Homepage, https://github.com/GoogleCloudPlatform/bigquery-jupyter-plugin
Project-URL: Bug Tracker, https://github.com/GoogleCloudPlatform/bigquery-jupyter-plugin/issues
Project-URL: Repository, https://github.com/GoogleCloudPlatform/bigquery-jupyter-plugin.git
Author-email: "Google Inc." <dataproc-plugins@google.com>
License: This file was generated with the generate-license-file npm package!
        https://www.npmjs.com/package/generate-license-file
        
        The following npm packages may be included in this product:
        
         - @codemirror/autocomplete@6.20.3
         - @codemirror/lang-sql@6.10.0
         - @codemirror/language@6.12.4
         - @codemirror/state@6.7.4
         - @codemirror/view@6.43.11
        
        These packages each contain the following license and notice below:
        
        MIT License
        
        Copyright (C) 2018-2021 by Marijn Haverbeke <marijn@haverbeke.berlin> and others
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in
        all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
        THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - @fortawesome/fontawesome-free@5.15.4
        
        This package contains the following license and notice below:
        
        Font Awesome Free License
        -------------------------
        
        Font Awesome Free is free, open source, and GPL friendly. You can use it for
        commercial projects, open source projects, or really almost whatever you want.
        Full Font Awesome Free license: https://fontawesome.com/license/free.
        
        # Icons: CC BY 4.0 License (https://creativecommons.org/licenses/by/4.0/)
        In the Font Awesome Free download, the CC BY 4.0 license applies to all icons
        packaged as SVG and JS file types.
        
        # Fonts: SIL OFL 1.1 License (https://scripts.sil.org/OFL)
        In the Font Awesome Free download, the SIL OFL license applies to all icons
        packaged as web and desktop font files.
        
        # Code: MIT License (https://opensource.org/licenses/MIT)
        In the Font Awesome Free download, the MIT license applies to all non-font and
        non-icon files.
        
        # Attribution
        Attribution is required by MIT, SIL OFL, and CC BY licenses. Downloaded Font
        Awesome Free files already contain embedded comments with sufficient
        attribution, so you shouldn't need to do anything additional when using these
        files normally.
        
        We've kept attribution comments terse, so we ask that you do not actively work
        to remove them from files, especially code. They're a great way for folks to
        learn about Font Awesome.
        
        # Brand Icons
        All brand icons are trademarks of their respective owners. The use of these
        trademarks does not indicate endorsement of the trademark holder by Font
        Awesome, nor vice versa. **Please do not use brand logos for any purpose except
        to represent the company, product, or service to which they refer.**
        
        -----------
        
        The following npm packages may be included in this product:
        
         - @jupyter/react-components@0.16.7
         - @jupyter/web-components@0.16.7
        
        These packages each contain the following license and notice below:
        
        # UI Toolkit for Jupyter
        
        **WIP this is early work in progress.** But don't hesitate to open issues and PRs if you want to
        help.
        
        [![Extension status](https://img.shields.io/badge/status-ready-success 'The package is ready to be used')](https://jupyterlab-contrib.github.io/)
        [![NPM Version](https://img.shields.io/npm/v/@jupyter/web-components?color=blue)](https://www.npmjs.com/package/@jupyter/web-components)
        [![Toolkit CI Status](https://github.com/jupyterlab-contrib/jupyter-ui-toolkit/actions/workflows/ci.yml/badge.svg)](https://github.com/jupyterlab-contrib/jupyter-ui-toolkit/actions/workflows/ci.yml)
        [![Deploy Docs Status](https://github.com/jupyterlab-contrib/jupyter-ui-toolkit/actions/workflows/docs-cd.yml/badge.svg)](https://jupyterlab-contrib.github.io/jupyter-ui-toolkit/)
        [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/jupyterlab-contrib/jupyter-ui-toolkit/main)
        
        ![Toolkit for Jupyter Artwork](https://raw.githubusercontent.com/jupyterlab-contrib/jupyter-ui-toolkit/main/packages/components/docs/assets/toolkit-artwork.png)
        
        [Explore the components](https://jupyterlab-contrib.github.io/jupyter-ui-toolkit/) | [Online JupyterLab demo](https://mybinder.org/v2/gh/jupyterlab-contrib/jupyter-ui-toolkit/main)
        
        ## Introduction
        
        The UI Toolkit is a component library for building web interfaces in Jupyter ecosystem (JupyterHub,
        Jupyter Widgets, JupyterLab,...).
        
        Features of the library include:
        
        - **Implements the Jupyter design language:** All components follow the design language of Jupyter
          – enabling developers to create extensions that have a consistent look and feel with the rest of
          the ecosystem.
        - **Automatic support for color themes:** All components are designed with theming in mind and will
          automatically display the current application theme.
        - **Use any tech stack:** The library ships as a set of web components, meaning developers can use
          the toolkit no matter what tech stack (React, Vue, Svelte, etc.) their extension is built with.
        - **Accessible out of the box:** All components ship with web standard compliant ARIA labels and
          keyboard navigation.
        
        This repository contains three packages:
        
        - [`@jupyter/web-components`](https://github.com/jupyterlab-contrib/jupyter-ui-toolkit/tree/main/packages/components/):
          The main package defining the web components.
        - [`@jupyter/react-components`](https://github.com/jupyterlab-contrib/jupyter-ui-toolkit/tree/main/packages/react-components):
          Wrapped the web components to use them with [React](https://reactjs.org).
        - [`jupyter-ui-demo`](https://github.com/jupyterlab-contrib/jupyter-ui-toolkit/tree/main/packages/lab-example):
          Unpublished JupyterLab extension to demonstrate the integration of the toolkit.
        
        Those features are brought through the [Fast Design](https://www.fast.design/). And it is inspired
        by the [WebView toolkit for Visual Studio Code](https://github.com/microsoft/vscode-webview-ui-toolkit)
        as example for creating a customized toolkit.
        
        ## Release
        
        The UI Toolkit is currently in a proof of concept. Track progress towards 1.0 [here](https://github.com/jupyterlab-contrib/jupyter-ui-toolkit/issues?q=is%3Aopen+is%3Aissue+milestone%3Av1.0).
        Styles and API are not guarantee between minor versions prior to v1.0.0.
        
        ## Getting started
        
        You will need to install `yarn` (for example with `npm install --global yarn`).
        
        To build the components packages, execute:
        
        ```sh
        yarn install
        yarn build
        ```
        
        Then to interactively test or develop web components:
        
        ```sh
        cd packages/components
        yarn start
        ```
        
        ### JupyterLab demo extension
        
        To test locally the JupyterLab demo extension, using `conda` package manager:
        
        ```sh
        conda create -n jupyter-toolkit -c conda-forge -y nodejs yarn jupyterlab=3
        conda activate jupyter-toolkit
        yarn install
        yarn build
        pip install -e .
        jupyter labextension develop --overwrite .
        ```
        
        ## Documentation
        
        Further documentation can be found in the following places:
        
        - [Component Docs](https://github.com/jupyterlab-contrib/jupyter-ui-toolkit/tree/main/packages/components/docs/components.md)
        - [Storybook (Interactive Component Sandbox)](https://jupyterlab-contrib.github.io/jupyter-ui-toolkit/)
        - [Toolkit Extension Samples](https://github.com/jupyterlab-contrib/jupyter-ui-toolkit/tree/main/packages/lab-example):
          [Try online](https://mybinder.org/v2/gh/jupyterlab-contrib/jupyter-ui-toolkit/main)
        
        ## Contributing
        
        See the [contributing](https://github.com/jupyterlab-contrib/jupyter-ui-toolkit/tree/main/CONTRIBUTING.md) documentation.
        
        -----------
        
        The following npm package may be included in this product:
        
         - @jupyter/ydoc@4.1.1
        
        This package contains the following license and notice below:
        
        # @jupyter/ydoc
        
        `@jupyter/ydoc` provides [Yjs](https://github.com/yjs/yjs)-based data structures for various
        documents used in the Jupyter ecosystem. Built-in documents include:
        - `YFile`: a generic text document.
        - `YNotebook`: a Jupyter notebook document.
        
        The API documentation is available [there](https://jupyter-ydoc.readthedocs.io/en/latest/api/index.html).
        
        -----------
        
        The following npm package may be included in this product:
        
         - @jupyterlab/application@4.6.3
        
        This package contains the following license and notice below:
        
        # @jupyterlab/application
        
        A JupyterLab package that provides the top-level application object,
        with which JupyterLab plugins may be registered.
        
        -----------
        
        The following npm package may be included in this product:
        
         - @jupyterlab/apputils@4.7.3
        
        This package contains the following license and notice below:
        
        # @jupyterlab/apputils
        
        A JupyterLab package which provides a collection of utilities and UI elements for building an application and manipulating the DOM.
        
        -----------
        
        The following npm package may be included in this product:
        
         - @jupyterlab/codeeditor@4.6.3
        
        This package contains the following license and notice below:
        
        # @jupyterlab/codeeditor
        
        A JupyterLab package which defines an abstract interface to a code editor,
        which is used in many places in the application, including [cells](../cells)
        and the [file editor](../fileeditor).
        
        -----------
        
        The following npm package may be included in this product:
        
         - @jupyterlab/coreutils@6.6.3
        
        This package contains the following license and notice below:
        
        # @jupyterlab/coreutils
        
        A JupyterLab package which provides utility functions that are widely used
        across many of the `@jupyterlab` packages. This includes (among other things)
        functions for manipulating paths, urls, and the notebook format.
        
        This package is intended for use within both Node.js and browser environments.
        
        -----------
        
        The following npm package may be included in this product:
        
         - @jupyterlab/docregistry@4.6.3
        
        This package contains the following license and notice below:
        
        # @jupyterlab/docregistry
        
        A JupyterLab package which tracks the different types of documents that the application is able to interact with.
        This includes notebooks, text files, and base64 encoded documents.
        
        Extensions may register new document types with the document registry to allow them to be opened with JupyterLab.
        An example of this may be found in the [@jupyterlab/notebook](../notebook) package.
        
        The document registry is a singleton on the [application](../application).
        
        -----------
        
        The following npm package may be included in this product:
        
         - @jupyterlab/launcher@4.6.3
        
        This package contains the following license and notice below:
        
        # @jupyterlab/launcher
        
        A JupyterLab package that provides a launcher for various activities,
        including notebooks, consoles, text editors, and terminals.
        
        JupyterLab extensions may register themselves with the launcher in order to show up as an activity when the application starts.
        
        -----------
        
        The following npm packages may be included in this product:
        
         - @jupyterlab/nbformat@4.6.3
         - @jupyterlab/settingregistry@4.6.3
         - @jupyterlab/statedb@4.6.3
         - @jupyterlab/statusbar@4.6.3
         - @lumino/algorithm@2.0.5
         - @lumino/application@2.4.10
         - @lumino/collections@2.0.5
         - @lumino/commands@2.3.4
         - @lumino/coreutils@2.2.3
         - @lumino/disposable@2.1.6
         - @lumino/domutils@2.0.5
         - @lumino/dragdrop@2.1.9
         - @lumino/keyboard@2.0.5
         - @lumino/messaging@2.0.5
         - @lumino/properties@2.0.5
         - @lumino/signaling@2.1.6
         - @lumino/virtualdom@2.0.5
         - @lumino/widgets@2.9.0
        
        These packages each contain the following license and notice below:
        
        (BSD-3-Clause)
        
        -----------
        
        The following npm package may be included in this product:
        
         - @jupyterlab/observables@5.6.3
        
        This package contains the following license and notice below:
        
        # @jupyterlab/observables
        
        A JupyterLab package which provides data structures (such as strings, lists, and maps), which can be listened to for changes.
        
        -----------
        
        The following npm package may be included in this product:
        
         - @jupyterlab/rendermime-interfaces@3.14.3
        
        This package contains the following license and notice below:
        
        # @jupyterlab/rendermime-interfaces
        
        A package for JupyterLab which provides interfaces for implementing mime renderer extensions.
        
        A general JupyterLab plugin involves a certain amount of boilerplate code
        that can be annoying for authors of relatively extensions.
        The interfaces in this package are meant to give an easier way for extension authors
        to provide a plugin that renders mime bundles and documents of a specific mime type.
        
        When using these interfaces, extensions only need to provide some metadata about
        what kind of mime bundle they are able to render, and a `Widget` with
        a `renderModel` method that renders the mime bundle.
        
        Examples can be found in [@jupyterlab/vega5-extension](../vega5-extension) and [@jupyterlab/pdf-extension](../pdf-extension).
        
        -----------
        
        The following npm package may be included in this product:
        
         - @jupyterlab/rendermime@4.6.3
        
        This package contains the following license and notice below:
        
        # @jupyterlab/rendermime
        
        A JupyterLab package which manages mime bundle renderers for the application,
        and provides default renderers for a number of formats, such as markdown,
        HTML, images, and LaTeX.
        
        A simplified interface for adding new mime renderers to the application
        can be found in [@jupyterlab/rendermime-interfaces](../rendermime-interfaces).
        
        The rendermime is a singleton on the [application](../application).
        
        -----------
        
        The following npm package may be included in this product:
        
         - @jupyterlab/services@7.6.3
        
        This package contains the following license and notice below:
        
        # JupyterLab Services
        
        JavaScript client for the Jupyter services REST APIs
        
        [API Docs](https://jupyterlab.readthedocs.io/en/stable/api/)
        
        [REST API Docs](https://petstore.swagger.io/?url=https://raw.githubusercontent.com/jupyter-server/jupyter_server/main/jupyter_server/services/api/api.yaml)
        
        Note: All functions and classes using the REST API allow a `serverSettings`
        parameter to configure requests.
        
        Requests are made using the `fetch` API, which is available in modern browsers or in Node 18+.
        
        ## Package Install
        
        **Prerequisites**
        
        - [node](http://nodejs.org/)
        - Python, e.g. via [conda](https://www.anaconda.com/download)
        
        ```bash
        npm install --save @jupyterlab/services
        conda install jupyter-server # jupyter-server 2.0+ is recommended
        # or `pip install jupyter-server`
        ```
        
        ## Source Build
        
        **Prerequisites**
        
        See the [building instructions for JupyterLab](../../CONTRIBUTING.md), which
        will build this module as part of the build process.
        
        **Rebuild**
        
        ```bash
        yarn run clean
        yarn run build
        ```
        
        ## Run Tests
        
        Follow the source build instructions first.
        
        ```bash
        yarn run test
        ```
        
        ## Build Docs
        
        Follow the source build instructions first.
        
        ```bash
        yarn run docs
        ```
        
        Navigate to `docs/index.html`.
        
        ## Supported Runtimes
        
        The runtime versions which should work are listed below. Earlier versions may
        also work, but come with no guarantees.
        
        - Node 10
        - Firefox 52+
        - Chrome 55+
        
        Note: "requirejs" may need be included in a global context for `Comm` targets
        using the a `target_module` (in the classic Notebook).
        This can be as a `<script>` tag in the browser or by using the `requirejs`
        package in node (`npm install requirejs` and setting
        `global.requirejs = require('requirejs');`).
        
        ## Starting the Jupyter Server
        
        Follow the package install instructions first.
        
        The library requires a running Jupyter Server, launched as:
        
        ```bash
        jupyter server
        ```
        
        or
        
        ```bash
        jupyter lab
        ```
        
        ## Bundling for the Browser
        
        Follow the package install instructions first.
        
        See `examples/browser` for an example of using Rspack to bundle the library.
        
        ## Usage from Node.js
        
        Follow the package install instructions first.
        
        See `examples/node` for an example of using an ES5 node script.
        
        ## Usage Examples
        
        **Note:** This package is compiled to ES2018 JavaScript syntax from
        TypeScript. Here are some examples of using parts of this package. See the
        other `examples` subdirectories for more examples.
        
        - [Comms](./examples/browser/src/comm.ts)
        - [Config](./examples/browser/src/config.ts)
        - [Contents](./examples/browser/src/contents.ts)
        - [Kernel](./examples/browser/src/kernel.ts)
        - [Session](./examples/browser/src/session.ts)
        - [Terminal](./examples/browser/src/terminal.ts)
        
        ## Overview
        
        This package introduces a number of concepts, such as session context, etc.
        Here we give a brief overview of some of the top-level concepts in this
        package.
        
        ### Clients
        
        A _client_ is a single entity connected to a kernel. Since kernel messages
        include the client id, it is easy for a client to filter kernel messages for
        just messages between it and the kernel. In JupyterLab, different activities
        (such as a console and a notebook) are usually considered separate clients when
        connected to the same kernel.
        
        ### Kernel specs
        
        A _kernel spec_ is the data about an available kernel on the system. We can
        retrieve a current list of kernel specs from the server.
        
        ### Kernels
        
        A _kernel_ represents a running process on the server that implements the
        Jupyter kernel messaging protocol.
        
        #### Kernel model
        
        A _kernel model_ mirrors the server kernel models, and represents a single
        running kernel on the server. A kernel can be created, restarted, shut down,
        etc., through calls to the server. A kernel model's lifecycle mirrors the
        server kernel model's lifecycle, and it will be disposed when the server
        kernel is shut down.
        
        #### Kernel connection
        
        A _kernel connection_ represents a single client connecting to a kernel over a
        websocket. Typically only one kernel connection handles comms for any given
        kernel. The kernel connection is disposed when the client no longer has a need
        for the connection. Disposing a kernel connection does not cause the kernel to
        shut down. However, if a kernel is shut down, (eventually) all of its kernel
        connections should be disposed if they were initiated from a kernel manager.
        If the kernel connections were instantiated outside of a manager, you are
        responsible for cleaning them up.
        
        A kernel connection has a number of signals, such as kernel status, kernel
        connection status, etc.
        
        #### Kernel manager
        
        A _kernel manager_ is an object that maintains a list of kernel models by
        regular polling. The kernel manager can instantiate a kernel connection and
        will manage its lifecycle (e.g., when the kernel is shut down, the connections
        will be disposed). The manager provides some minimal bookkeeping around
        kernels and their connections. Generally, it is easiest to interact with
        kernels on a server through a manager.
        
        ### Sessions
        
        A _session_ is a mapping on the server from an identifying string (the
        session's `path`) to a kernel. A session has a few other pieces of information
        to allow for easy categorization and searching of sessions.
        
        The primary use case of a session is to enable persisting a connection to a
        kernel. For example, a notebook viewer may start a session with session path
        of the notebook's file path. When a browser is refreshed, the notebook viewer
        can connect to the same kernel by asking the server for the session
        corresponding with the notebook file path.
        
        #### Session model
        
        A _session model_ mirrors a server session. The session models can be
        refreshed from the server, created, changed (including creating a new session
        kernel), and shut down (which implies that the kernel will be shut down). A
        session model's lifecycle mirrors the server session's lifecycle, and it will
        be disposed when the server session is shut down.
        
        #### Session connection
        
        A _session connection_ represents a single client connected to a session's
        kernel. A session's kernel connection can change and may be null to signify no
        current kernel connection. A session connection owns the kernel connection,
        meaning the kernel connection is created and disposed by the session
        connection as needed. The session connection proxies signals from the kernel
        connection for convenience (e.g., you can listen to the session's status
        signal to get status changes for whatever the current kernel is, without
        having to disconnect and reconnect your signal handlers every time the session
        kernel changes). The session connection can be disposed when the client no
        longer is connected to that session's kernel, and disposal will not cause the
        session model to be deleted.
        
        #### Session manager
        
        A _session manager_ is an object that maintains a list of session models by
        regular polling. The session manager can instantiate a session connection and
        will manage its lifecycle (e.g., when the session is shut down, the connections
        will be disposed). The manager provides some minimal bookkeeping around
        sessions and their connections. Generally, it is easiest to interact with
        sessions on a server through a manager.
        
        ### Session Context
        
        A _session context_ is an object which has the same lifecycle as the client.
        The session context owns a session connection (which may be null if the client
        is not currently associated with a session). The session context proxies the
        current session connection's signals for convenience. The session context
        primarily serves as a stable object for a client to keep track of the current
        session connection. The session context also contains some convenience
        functionality, such as preferences for whether a kernel should be started and
        a user-friendly kernel name and status.
        
        Here is a diagram that provides an overview of the different components:
        
        ![architecture-diagram](./architecture.png)
        
        _The diagram can be edited on [diagrams.net](https://diagrams.net) by importing the [source](./architecture.xml)_.
        
        -----------
        
        The following npm package may be included in this product:
        
         - @jupyterlab/translation@4.6.3
        
        This package contains the following license and notice below:
        
        # @jupyterlab/translation
        
        Translation utilities.
        
        -----------
        
        The following npm package may be included in this product:
        
         - @jupyterlab/ui-components@4.6.3
        
        This package contains the following license and notice below:
        
        <!--
        THIS FILE IS AUTOGENERATED, DO NOT EDIT
        
        Instead, make changes to docs sources in `packages/ui-components/docs`,
        then run "jlpm docs:init" to refresh the built docs
        -->
        
        # @jupyterlab/ui-components
        
        The
        [@jupyterlab/ui-components](https://jupyterlab.github.io/jupyterlab/modules/_ui_components_src_index_.html)
        package provides UI elements that are widely used in JupyterLab core,
        and that can be reused in your own extensions.
        
        For example, all of the icons in JupyterLab core can be reused via
        `LabIcon`. You can also use `LabIcon` to create your own custom icons
        that will be able to automatically change color to match the current
        JupyterLab theme.
        
        # `LabIcon` - set up and render icons
        
        `LabIcon` is the icon class used by JupyterLab, and is part of the new
        icon system introduced in JupyterLab v2.0.
        
        ## How JupyterLab handles icons
        
        The @jupyterlab/ui-components package provides icons to the rest of
        JupyterLab, in the form of a set of `LabIcon` instances (currently about
        80). All of the icons in the core JupyterLab packages are rendered using
        one of these `LabIcon` instances.
        
        ## Using the icons in your own code
        
        You can use any of JupyterLab icons in your own code via an `import`
        statement. For example, to use `jupyterIcon` you would first do:
        
        ```typescript
        import { jupyterIcon } from '@jupyterlab/ui-components';
        ```
        
        ## How to render an icon into a DOM node
        
        Icons can be added as children to any `div` or `span` nodes using the
        `icon.element(...)` method (where `icon` is any instance of `LabIcon`).
        For example, to render the Jupyter icon you could do:
        
        ```typescript
        jupyterIcon.element({
          container: elem,
          height: '16px',
          width: '16px',
          marginLeft: '2px'
        });
        ```
        
        where `elem` is any `HTMLElement` with a `div` or `span` tag. As shown
        in the above example, the icon can be styled by passing CSS parameters
        into `.element(...)`. Any valid CSS parameter can be used (one catch:
        snake case params do have to be converted to camel case: instead of
        `foo-bar: '8px'`, you’d need to use `fooBar: '8px'`.
        
        ## How to render an icon as a React component
        
        Icons can also be rendered using React. The `icon.react` parameter holds
        a standard React component that will display the icon on render. Like
        any React component, `icon.react` can be used in various ways.
        
        For example, here is how you would add the Jupyter icon to the render
        tree of another React component:
        
        ```jsx
        public render() {
          return (
            <div className="outer">
              <div className="inner">
                <jupyterIcon.react tag="span" right="7px" top="5px" />
                "and here's a text node"
              </div>
            </div>
          );
        }
        ```
        
        Alternatively, you can just render the icon directly into any existing
        DOM node `elem` by using the `ReactDOM` module:
        
        ```typescript
        const root = createRoot(elem);
        root.render(jupyterIcon.react);
        ```
        
        If do you use `ReactDOM` to render, and if the `elem` node is ever
        removed from the DOM, you’ll first need to clean it up:
        
        ```typescript
        root.unmount();
        ```
        
        This cleanup step is not a special property of `LabIcon`, but is instead
        needed for any React component that is rendered directly at the top
        level by `ReactDOM`.
        
        ## How to create your own custom `LabIcon`
        
        You can create your own custom icon by constructing a new instance of
        `LabIcon`:
        
        ```typescript
        export const fooIcon = new LabIcon({
          name: 'barpkg:foo',
          svgstr: '<svg>...</svg>'
        });
        ```
        
        where `name` should be of the form “your-pkg:icon-name”, and `svgstr` is
        the raw contents of your icon’s svg file.
        
        ## How to create a new `LabIcon` from an external svg file
        
        Although you can copy-and-paste an svg directly into the `LabIcon`
        constructor, the best practice is to keep the svg for each of your icons
        in its own separate svg file. You will need to have an `svg.d.ts` file
        at the root of your project’s `src` directory:
        
        ```typescript
        // svg.d.ts
        
        declare module '*.svg' {
          const value: string;
          export default value;
        }
        ```
        
        You can then `import` the contents of an svg file:
        
        ```typescript
        import fooSvgstr from 'path-to-your/foo.svg';
        
        export const fooIcon = new LabIcon({
          name: 'barpkg:foo',
          svgstr: fooSvgstr
        });
        ```
        
        ## Sync icon color to JupyterLab theme
        
        <em>Example SVGs with class annotation can be found in <a href="https://github.com/jupyterlab/jupyterlab/tree/f0153e0258b32674c9aec106383ddf7b618cebab/packages/ui-components/style/icons">ui-components/style/icons</a></em>
        
        You can ensure that the colors of your custom `LabIcon` sync up to the
        colors of the current JupyterLab theme by adding appropriate `class`
        annotations to each colored element of your icon's svg.
        
        In other words, each element of your svg that a `fill="..."` or a
        `stroke="..."` property should also have a `class="jp-icon<whatever>"`
        property.
        
        ### Available icon classes
        
        <em>Icon-related CSS classes are defined in <a href="https://github.com/jupyterlab/jupyterlab/blob/f0153e0258b32674c9aec106383ddf7b618cebab/packages/ui-components/style/icons.css">ui-components/style/icons.css</a></em>
        
        All colors shown are for the standard light/dark theme, mouse over for
        hex values.
        
        #### `jp-iconX`: contrast to theme background
        
        <ul>
        <li>jp-icon0: <svg width="16" viewBox="0 0 1 1"><rect width="1" height="1" fill="#111"/><title>#111</title></svg> / <svg width="16" viewBox="0 0 1 1"><rect width="1" height="1" fill="#fff"/><title>#fff</title></svg></li>
        <li>jp-icon1: <svg width="16" viewBox="0 0 1 1"><rect width="1" height="1" fill="#212121"/><title>#212121</title></svg> / <svg width="16" viewBox="0 0 1 1"><rect width="1" height="1" fill="#fff"/><title>#fff</title></svg></li>
        <li>jp-icon2: <svg width="16" viewBox="0 0 1 1"><rect width="1" height="1" fill="#424242"/><title>#424242</title></svg> / <svg width="16" viewBox="0 0 1 1"><rect width="1" height="1" fill="#eee"/><title>#eee</title></svg></li>
        <li>jp-icon3: <svg width="16" viewBox="0 0 1 1"><rect width="1" height="1" fill="#616161"/><title>#616161</title></svg> / <svg width="16" viewBox="0 0 1 1"><rect width="1" height="1" fill="#bdbdbd"/><title>#bdbdbd</title></svg></li>
        <li>jp-icon4: <svg width="16" viewBox="0 0 1 1"><rect width="1" height="1" fill="#757575"/><title>#757575</title></svg> / <svg width="16" viewBox="0 0 1 1"><rect width="1" height="1" fill="#757575"/><title>#757575</title></svg></li>
        </ul>
        
        Most one-color icons in JupyterLab (including the sidebar and toolbar
        icons) are colored using the `jp-icon3` class.
        
        For light/dark themes, `jp-icon0` corresponds to the darkest/lightest
        background color, while `jp-icon1` is somewhat lighter/darker, and so
        forth.
        
        #### `jp-icon-accentX`: match to theme background
        
        <ul>
        <li>jp-icon-accent0: <svg width="16" viewBox="0 0 1 1"><rect width="1" height="1" fill="#fff"/><title>#fff</title></svg> / <svg width="16" viewBox="0 0 1 1"><rect width="1" height="1" fill="#111"/><title>#111</title></svg></li>
        <li>jp-icon-accent1: <svg width="16" viewBox="0 0 1 1"><rect width="1" height="1" fill="#fff"/><title>#fff</title></svg> / <svg width="16" viewBox="0 0 1 1"><rect width="1" height="1" fill="#212121"/><title>#212121</title></svg></li>
        <li>jp-icon-accent2: <svg width="16" viewBox="0 0 1 1"><rect width="1" height="1" fill="#eee"/><title>#eee</title></svg> / <svg width="16" viewBox="0 0 1 1"><rect width="1" height="1" fill="#424242"/><title>#424242</title></svg></li>
        <li>jp-icon-accent3: <svg width="16" viewBox="0 0 1 1"><rect width="1" height="1" fill="#bdbdbd"/><title>#bdbdbd</title></svg> / <svg width="16" viewBox="0 0 1 1"><rect width="1" height="1" fill="#616161"/><title>#616161</title></svg></li>
        <li>jp-icon-accent4: <svg width="16" viewBox="0 0 1 1"><rect width="1" height="1" fill="#757575"/><title>#757575</title></svg> / <svg width="16" viewBox="0 0 1 1"><rect width="1" height="1" fill="#757575"/><title>#757575</title></svg></li>
        </ul>
        
        For light/dark themes, `jp-icon-accent0` corresponds to the
        lightest/darkest background color, while `jp-icon-accent1` is somewhat
        darker/lighter, and so forth.
        
        ### Adding classes to a one-color icon
        
        For most simple, one-color icons, it is desirable for the icon's color
        to strongly contrast with that of the application's background. You can
        achieve this using one of the `jp-iconX` classes.
        
        **Example: check icon**
        
        _svg source:_
        
        ```html
        <svg xmlns="http://www.w3.org/2000/svg" width="100" viewBox="0 0 24 24">
          <path
            class="jp-icon3"
            fill="#616161"
            d="M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z"
          />
        </svg>
        ```
        
        _rendered icon:_
        
        <svg xmlns="http://www.w3.org/2000/svg" width="100" viewBox="0 0 24 24">
          <path class="jp-icon3" fill="#616161" d="M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z"/>
        </svg>
        
        ### Adding classes to a multi-colored icon
        
        For more complex icons, each element that needs to match the background
        should be annotated with a `jp-icon-accentX` class, while each element
        that needs to contrast with the background should be annotated with a
        `jp-iconX` class.
        
        **Example: close-circle icon**
        
        _svg source:_
        
        ```html
        <svg xmlns="http://www.w3.org/2000/svg" width="100" viewBox="0 0 24 24">
          <circle class="jp-icon3" fill="#616161" cx="12" cy="12" r="11" />
          <rect
            class="jp-icon-accent0"
            fill="#fff"
            height="18"
            width="2"
            x="11"
            y="3"
            transform="rotate(315, 12, 12)"
          />
          <rect
            class="jp-icon-accent0"
            fill="#fff"
            height="18"
            width="2"
            x="11"
            y="3"
            transform="rotate(45, 12, 12)"
          />
        </svg>
        ```
        
        _rendered icon:_
        
        <svg xmlns="http://www.w3.org/2000/svg" width="100" viewBox="0 0 24 24">
          <circle class="jp-icon3" fill="#616161" cx="12" cy="12" r="11"/>
          <rect class="jp-icon-accent0" fill="#fff" height="18" width="2" x="11" y="3" transform="rotate(315, 12, 12)"/>
          <rect class="jp-icon-accent0" fill="#fff" height="18" width="2" x="11" y="3" transform="rotate(45, 12, 12)"/>
        </svg>
        
        ## Background
        
        ### Icon handling in Jupyterlab
        
        Pre JupyterLab 2.0, most icons were created using the
        icons-as-css-background pattern:
        
        - Set up the icon’s svg as a `background-image` in CSS:
        
          ```css
          /* CSS */
        
          .jp-FooIcon {
            background-image: url('path-to-your/foo.svg');
          }
          ```
        
        - Add the icon to the DOM by constructing an otherwise empty DOM node
          with the appropriate class:
        
          ```typescript
          // typescript
        
          const e = document.createElement('div');
          e.className = 'jp-FooIcon';
          document.body.append(e);
          ```
        
        What you end up with is a single DOM node that has the “foo” icon as a
        background image.
        
        Post JupyterLab 2.0, nearly all icons in core are now created using
        [LabIcon](https://github.com/jupyterlab/jupyterlab/blob/f0153e0258b32674c9aec106383ddf7b618cebab/packages/ui-components/src/icon/labicon.tsx)
        and the icons-as-inline-svg pattern:
        
        - Construct a new instance of LabIcon from the icon’s name and svg:
        
          ```typescript
          // typescript
        
          // svgstr is the raw contents of an icon's svg file
          export const fooIcon = new LabIcon({
            name: 'barpkg:foo',
            svgstr: '<svg>...</svg>'
          });
          ```
        
        - Add the icon to the DOM using the appropriate property of your
          LabIcon instance (either LabIcon.element() to directly create a DOM
          node, or LabIcon.react to get the icon as a react component):
        
          ```typescript
          // typescript
        
          const e = fooIcon.element();
          document.body.append(e);
          ```
        
        What you end up with is a DOM node (by default a ‘div’) that has an
        inline svg node as a child.
        
        ### `background-image` vs inline svg
        
        The big limitation of the old icon-as-css-background pattern is that svg
        images rendered as `background-image` are invisible to CSS. On the other
        hand, an icon rendered as an inline svg node is fully exposed to the
        CSS. This allows us to dynamically change icon styling as needed simply by
        modifying our CSS. Most importantly, this allows us to recolor icons
        according to Jupyterlab’s current theme.
        
        -----------
        
        The following npm packages may be included in this product:
        
         - @lezer/common@1.5.2
         - @lezer/highlight@1.2.3
         - @lezer/lr@1.4.10
        
        These packages each contain the following license and notice below:
        
        MIT License
        
        Copyright (C) 2018 by Marijn Haverbeke <marijn@haverbeke.berlin> and others
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in
        all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
        THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - @lumino/polling@2.1.6
        
        This package contains the following license and notice below:
        
        # @lumino/polling
        
        This package provides a class for generic polling functionality (`Poll`). It
        also provides rate limiters (`Debouncer` and `Throttler`).
        
        The `Poll` class provides three different ways to "subscribe" to poll ticks:
        
        - [`@lumino/signaling`](../signaling/): `Poll#ticked` is a Lumino signal that
          emits each time there is a poll tick.
        - `Promise`-based: `Poll#tick` is a promise that resolves after every tick and
          only rejects when the poll is disposed.
        - `AsyncIterable`: `Poll#[`Symbol.asyncIterator`]` implements the async iterable
          protocol that allows iteration using [`for-await...of`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/for-await...of) loops.
        
        ## Example usage
        
        These are examples from the unit tests for this package. They
        demonstrate the three different ways polling is supported.
        
        ### Using `Poll#tick` promise
        
        Here, we set up the testing state variables and create a new `Poll` instance.
        
        ```typescript
        const expected = 'started resolved resolved';
        const ticker: IPoll.Phase<any>[] = [];
        const tock = (poll: Poll) => {
          ticker.push(poll.state.phase);
          poll.tick.then(tock).catch(() => undefined);
        };
        const poll = new Poll({
          auto: false,
          factory: () => Promise.resolve(),
          frequency: { interval: 100, backoff: false }
        });
        ```
        
        Next we assign the `tock` function to run after the poll ticks and
        we start the poll.
        
        ```typescript
        void poll.tick.then(tock);
        void poll.start();
        ```
        
        And we verify that the `ticker` did indeed get populated when `tock`
        was called and the next promise was captured as well.
        
        ```typescript
        await sleep(1000); // Sleep for longer than the interval.
        expect(ticker.join(' ').startsWith(expected)).to.equal(true);
        poll.dispose();
        ```
        
        ### Using `Poll#ticked` signal
        
        Here, we set up the testing state variables and create a new `Poll` instance.
        
        ```typescript
        const poll = new Poll<void, void>({
          factory: () => Promise.resolve(),
          frequency: { interval: 100, backoff: false }
        });
        ```
        
        Here we connect to the `ticked` signal and simply check that each
        tick matches the poll `state` accessor's contents.
        
        ```typescript
        poll.ticked.connect((_, tick) => {
          expect(tick).to.equal(poll.state);
        });
        await sleep(1000); // Sleep for longer than the interval.
        poll.dispose();
        ```
        
        ### Using `Poll` as an `AsyncIterable`
        
        Here, we set up the testing state variables and create a new `Poll` instance.
        
        ```typescript
        let poll: Poll;
        let total = 2;
        let i = 0;
        
        poll = new Poll({
          auto: false,
          factory: () => Promise.resolve(++i > total ? poll.dispose() : void 0),
          frequency: { interval: Poll.IMMEDIATE }
        });
        
        const expected = `started${' resolved'.repeat(total)}`;
        const ticker: IPoll.Phase<any>[] = [];
        ```
        
        Then the poll is started:
        
        ```typescript
        void poll.start();
        ```
        
        Instead of connecting to the `ticked` signal or awaiting the `tick` promise, we can now use a `for-await...of` loop:
        
        ```typescript
        for await (const state of poll) {
          ticker.push(state.phase);
          if (poll.isDisposed) {
            break;
          }
        }
        ```
        
        And we check to make sure the results are as expected:
        
        ```typescript
        // ticker and expected both equal:
        // 'started resolved resolved disposed'
        expect(ticker.join(' ')).to.equal(expected);
        ```
        
        ### Note for consumers of async iterators
        
        In order to use `for-await...of` loops in TypeScript, you will need to use `ES2018` or above in your `lib` array in `tsconfig.json`.
        
        -----------
        
        The following npm package may be included in this product:
        
         - @marijn/find-cluster-break@1.0.4
        
        This package contains the following license and notice below:
        
        MIT License
        
        Copyright (C) 2024 by Marijn Haverbeke <marijn@haverbeke.berlin>
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in
        all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
        THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - @microsoft/fast-colors@5.3.1
        
        This package contains the following license and notice below:
        
        # FAST Colors
        
        `@microsoft/fast-colors` includes a number of color classes and utilities designed to make parsing and manipulating colors easy, fast, and light-weight.
        
        ## Color classes
        
        There are a number of color classes exported for common color formats. These include:
        
        - `ColorHSL`
        - `ColorHSV`
        - `ColorLAB`
        - `ColorLCH`
        - `ColorRGBA64` (note each channel is a number from 0-1)
        - `ColorXYZ`
        
        ```ts
        const myColor: new ColorRGBA64(0, 0, 0, 1);
        
        myColor.toStringHexRGB() // "#000000"
        ```
        
        ## Color parsers
        
        A number of color parsers are also available to parse a variety of different color formats.
        
        - `parseColorHexRGB(raw: string): ColorRGBA64 | null` parses `#RGB` or `#RRGGBB` color strings
        - `parseColorHexARGB(raw: string): ColorRGBA64 | null` parses `#ARGB` or `#AARRGGBB` color strings
        - `parseColorHexRGBA(raw: string): ColorRGBA64 | null` parses `#RGBA` or `#RRGGBBAA` color strings
        - `parseColorWebRGB(raw: string): ColorRGBA64 | null` parses `#rgb(R, G, B)` color strings
        - `parseColorWebRGBA(raw: string): ColorRGBA64 | null` parses `#rgb(R, G, B, A)` color strings
        - `parseColorNamned(raw: string): ColorRGBA64 | null` parses [named color strings](https://www.w3schools.com/colors/colors_names.asp)
        
        ## Color Palette
        
        A utility for creating a palette of colors from a source color and configuration options:
        
        - `baseColor?: ColorRGBA64`
        - `steps?: number`
        - `interpolationMode?: ColorInterpolationSpace`
        - `scaleColorLight?: ColorRGBA64`
        - `scaleColorDark?: ColorRGBA64`
        - `clipLight?: number`
        - `clipDark?: number`
        - `saturationAdjustmentCutoff?: number`
        - `saturationLight?: number`
        - `saturationDark?: number`
        - `overlayLight?: number`
        - `overlayDark?: number`
        - `multiplyLight?: number`
        - `multiplyDark?: number`
        
        Example:
        
        ```ts
        const palette: ColorPalette = new ColorPalette({
            baseColor: new ColorRGBA64(.4, .4, .7, 1),
            steps: 99,
            interpolationMode: ColorInterpolationSpace.RGB
        })
        ```
        
        ## Color converters
        
        A number of color converters are available to convert one color format to the other. Each color accepts a color class of the source type and returns a color class of the converted type:
        
        - `hslToRGB`
        - `rgbToHSL`
        - `rgbToHSV`
        - `hsvToRGB`
        - `lchToLAB`
        - `labToLCH`
        - `labToXYZ`
        - `xyzToLAB`
        - `rgbToXYZ`
        - `xyzToRGB`
        - `rgbToLAB`
        - `labToRGB`
        - `rgbToLCH`
        - `lchToRGB`
        
        ```ts
        const rgb: ColorRGBA64 = new ColorRGBA64(.5, .5, .5, 1);
        const hsl: ColorHSL = rgbToHSL(rgb);
        ```
        
        -----------
        
        The following npm package may be included in this product:
        
         - @microsoft/fast-element@1.14.0
        
        This package contains the following license and notice below:
        
        # FAST Element
        
        [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
        [![npm version](https://badge.fury.io/js/%40microsoft%2Ffast-element.svg)](https://badge.fury.io/js/%40microsoft%2Ffast-element)
        
        The `fast-element` library is a lightweight means to easily build performant, memory-efficient, standards-compliant Web Components. FAST Elements work in every major browser and can be used in combination with any front-end framework or even without a framework.
        
        ## Installation
        
        ### From NPM
        
        To install the `fast-element` library, use either `npm` or `yarn` as follows:
        
        ```shell
        npm install --save @microsoft/fast-element
        ```
        
        ```shell
        yarn add @microsoft/fast-element
        ```
        
        Within your JavaScript or TypeScript code, you can then import library APIs like this:
        
        ```ts
        import { FASTElement } from '@microsoft/fast-element';
        ```
        
        :::tip
        Looking for a setup that integrates with a particular front-end framework or bundler? Check out [our integration docs](../integrations/introduction.md).
        :::
        
        ### From CDN
        
        A pre-bundled script that contains all APIs needed to build web components with FAST Element is available on CDN. You can use this script by adding [`type="module"`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) to the script element and then importing from the CDN.
        
        ```html
        <!DOCTYPE html>
        <html lang="en">
            <head>
                <script type="module">
                  import { FASTElement } from "https://cdn.jsdelivr.net/npm/@microsoft/fast-element/dist/fast-element.min.js";
        
                  // your code here
                </script>
            </head>
            <!-- ... -->
        </html>
        ```
        
        The markup above always references the latest release. When deploying to production, you will want to ship with a specific version. Here's an example of the markup for that:
        
        ```html
        <script type="module" src="https://cdn.jsdelivr.net/npm/@microsoft/fast-element@1.6.2/dist/fast-element.min.js"></script>
        ```
        
        :::note
        For simplicity, examples throughout the documentation will assume the library has been installed from NPM, but you can always replace the import location with the CDN URL.
        :::
        
        :::tip
        Looking for a quick guide on building components?  Check out [our Cheat Sheet](../resources/cheat-sheet.md#building-components).
        :::
        
        -----------
        
        The following npm package may be included in this product:
        
         - @microsoft/fast-foundation@2.50.0
        
        This package contains the following license and notice below:
        
        # FAST Foundation
        
        [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
        [![npm version](https://badge.fury.io/js/%40microsoft%2Ffast-foundation.svg)](https://badge.fury.io/js/%40microsoft%2Ffast-foundation)
        
        The `fast-foundation` package is a library of Web Component classes, templates, and other utilities intended to be composed into registered Web Components by design systems (e.g. Fluent Design, Material Design, etc.). The exports of this package can generally be thought of as un-styled base components that implement semantic and accessible markup and behavior.
        
        This package does not export Web Components registered as [custom elements](https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_custom_elements) - it exports parts and pieces intended to be *composed* into Web Components, allowing you to implement your own design language by simply applying CSS styles and behaviors without having to write all the JavaScript that's involved in building production-quality component implementations.
        
        ## Installation
        
        ### From NPM
        
        To install the `fast-foundation` library, use either `npm` or `yarn` as follows:
        
        ```shell
        npm install --save @microsoft/fast-foundation
        ```
        
        ```shell
        yarn add @microsoft/fast-foundation
        ```
        
        Within your JavaScript or TypeScript code, you can then import library APIs like this:
        
        ```ts
        import { Anchor } from '@microsoft/fast-foundation';
        ```
        
        Looking for a setup that integrates with a particular front-end framework or bundler? Check out [our integration docs](https://fast.design/docs/integrations/introduction).
        
        ### From CDN
        
        A pre-bundled script that contains all APIs needed to use FAST Foundation is available on CDN. You can use this script by adding [`type="module"`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) to the script element and then importing from the CDN.
        
        ```html
        <!DOCTYPE html>
        <html lang="en">
            <head>
                <script type="module">
                  import { Anchor } from "https://cdn.jsdelivr.net/npm/@microsoft/fast-foundation/dist/fast-foundation.min.js";
        
                  // your code here
                </script>
            </head>
            <!-- ... -->
        </html>
        ```
        
        The markup above always references the latest release. When deploying to production, you will want to ship with a specific version. Here's an example of the markup for that:
        
        ```html
        <script type="module" src="https://cdn.jsdelivr.net/npm/@microsoft/fast-foundation@2.26.2/dist/fast-foundation.min.js"></script>
        ```
        
        :::note
        For simplicity, examples throughout the documentation will assume the library has been installed from NPM, but you can always replace the import location with the CDN URL.
        :::
        
        -----------
        
        The following npm package may be included in this product:
        
         - @microsoft/fast-web-utilities@5.4.1
        
        This package contains the following license and notice below:
        
        # FAST Web utilities
        
        This package is a collection of utilities intended to be used for web projects.
        
        ## Installation
        
        `npm i --save @microsoft/fast-web-utilities`
        
        ## Usage
        
        ### DOM utilities
        
        #### getKeyCode
        
        The `getKeyCode` function gets the numeric key code associated with a keyboard event. This method is for use with DOM level 3 events that still use the deprecated keyCode property.
        
        ```js
        import { getKeyCode } from "@microsoft/fast-web-utilities";
        
        handleKeyPress = (e) => {
            let keyCode = getKeyCode(e);
        
            // Do something based on keyCode value
        }
        ```
        
        ### HTML utilities
        
        #### getClientRectWithMargin
        
        The `getClientRectWithMargin` function gets the client bounding rectangle including any margins of an element.
        
        ```js
        import { getClientRectWithMargin } from "@microsoft/fast-web-utilities";
        
        const itemWidth = getClientRectWithMargin(item).width;
        const itemHeight = getClientRectWithMargin(item).height;
        ```
        
        #### convertStylePropertyPixelsToNumber
        
        The `convertStylePropertyPixelsToNumber` function will convert a property value from an elements computed style from pixels to a number value.
        
        ```js
        import { convertStylePropertyPixelsToNumber } from "@microsoft/fast-web-utilities";
        
        const elementTopMargin = convertStylePropertyPixelsToNumber(style, "margin-top");
        ```
        
        ### Key utilities
        
        #### Key strings
        
        Commonly used `event.key` values are available as individual exports. Additional `key` values will be added as needed.  
        
        ```js
        import { keyEnter, keySpace } from "@microsoft/fast-web-utilities";
        
        handleKeyPress = (e) => {
            switch (e.key) {
                case keySpace:
                case keyEnter:
                    // Do something if key matches
                    break;
            }
        }
        ```
        
        #### KeyCodes (enum)
        
        Keycodes are deprecated and their use should be avoided. Use the individual string `key` values instead.
        
        ### Localization utilities
        
        #### Typescript enum
        
        The `Direction` enum contains the `ltr` and `rtl` enum for use in a Typescript project.
        
        ```typescript
        import { Direction } from "@microsoft/fast-web-utilities";
        
        let direction: Direction = Direction.ltr;
        ```
        
        ### Number utilities
        
        #### Limit
        
        The `limit` function ensures that a value is between a min and max value. If the value is lower than min, min will be returned. If the value is greater than max, max will be retured.
        
        ```js
        import { limit } from "@microsoft/fast-web-utilities";
        const incomingNumber; // 11 
        const setNumberByLimit = limit(0, 10, incomingNumber); // returns 10
        ```
        
        #### wrapInBounds
        
        The `wrapInBounds` function keeps a given value within the bounds of a min and max value. If the value is larger than the max, the minimum value will be returned. If the value is smaller than the minimum, the maximum will be returned. Otherwise, the value is returned un-changed.
        
        ```js
        import { wrapInBounds } from "@microsoft/fast-web-utilities";
        const slides; // 5
        const index; // 5
        const activeIndex = wrapInBounds(0, this.slides.length - 1, index) // returns 0
        ```
        
        ### String utilities
        
        #### Format
        
        The `format` function builds a string from a format specifier and replacement parameters.
        
        ```js
        import { format } from "@microsoft/fast-web-utilities";
        
        const formatterString = "View {0} {1}";
        
        const newString = format(formatterString, "page", "4")); // "View page 4"
        ```
        
        #### startsWith
        
        The `startsWith` function checks to see if one string starts with another. The function is case sensitive.
        
        ```js
        import { startsWith } from "@microsoft/fast-web-utilities";
        
        const matchIsFalse = startsWith("HelloWorld", "World"); // false
        const matchIsTrue = startsWith("HelloWorld", "Hello"); // true
        ```
        
        #### isNullOrWhiteSpace
        
        The `isNullOrWhiteSpace` function determines if the specified string is undefined, null, empty, or whitespace. The function returns true if the value is undefined, null, empty, or whitespace, otherwise false.
        
        ```js
        import { isNullOrWhiteSpace } from "@microsoft/fast-web-utilities";
        
        const myAnchor = document.querySelector("#id");
        const checkWhitespace = isNullOrWhiteSpace(myAnchor.href);
        ```
        
        #### pascalCase
        
        The `pascalCase` function converts a string to Pascal Case
        
        ```js
        import { pascalCase } from "@microsoft/fast-web-utilities";
        
        const hyphenatedToPascal = pascalCase("my-string");
        const uppercaseToPascal = pascalCase("MY STRING");
        const whitespaceToPascal = pascalCase(" my string ");
        ```
        
        #### classNames
        A utility for merging class names into a single string conditionally. Accepts any number of strings, functions that return strings and two index arrays where the first index is a string or function that returns a string, and the second index is a boolean.
        
        ```js
        import { classNames } from "@microsoft/fast-web-utilities";
        
        // evaluates to "classOne classTwo classThree classFive"
        const myJoinedClassNames = classNames(
            "classOne",
            () => "classTwo",
            ["classThree", true],
            ["classFour", false]
            [() => "classFive", true],
            [() => "classSix", false]
        )
        ```
        
        -----------
        
        The following npm packages may be included in this product:
        
         - @rjsf/core@5.24.13
         - @rjsf/utils@5.24.13
        
        These packages each contain the following license and notice below:
        
        Apache License
                                   Version 2.0, January 2004
                                http://www.apache.org/licenses/
        
        TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
        
        1.  Definitions.
        
            "License" shall mean the terms and conditions for use, reproduction,
            and distribution as defined by Sections 1 through 9 of this document.
        
            "Licensor" shall mean the copyright owner or entity authorized by
            the copyright owner that is granting the License.
        
            "Legal Entity" shall mean the union of the acting entity and all
            other entities that control, are controlled by, or are under common
            control with that entity. For the purposes of this definition,
            "control" means (i) the power, direct or indirect, to cause the
            direction or management of such entity, whether by contract or
            otherwise, or (ii) ownership of fifty percent (50%) or more of the
            outstanding shares, or (iii) beneficial ownership of such entity.
        
            "You" (or "Your") shall mean an individual or Legal Entity
            exercising permissions granted by this License.
        
            "Source" form shall mean the preferred form for making modifications,
            including but not limited to software source code, documentation
            source, and configuration files.
        
            "Object" form shall mean any form resulting from mechanical
            transformation or translation of a Source form, including but
            not limited to compiled object code, generated documentation,
            and conversions to other media types.
        
            "Work" shall mean the work of authorship, whether in Source or
            Object form, made available under the License, as indicated by a
            copyright notice that is included in or attached to the work
            (an example is provided in the Appendix below).
        
            "Derivative Works" shall mean any work, whether in Source or Object
            form, that is based on (or derived from) the Work and for which the
            editorial revisions, annotations, elaborations, or other modifications
            represent, as a whole, an original work of authorship. For the purposes
            of this License, Derivative Works shall not include works that remain
            separable from, or merely link (or bind by name) to the interfaces of,
            the Work and Derivative Works thereof.
        
            "Contribution" shall mean any work of authorship, including
            the original version of the Work and any modifications or additions
            to that Work or Derivative Works thereof, that is intentionally
            submitted to Licensor for inclusion in the Work by the copyright owner
            or by an individual or Legal Entity authorized to submit on behalf of
            the copyright owner. For the purposes of this definition, "submitted"
            means any form of electronic, verbal, or written communication sent
            to the Licensor or its representatives, including but not limited to
            communication on electronic mailing lists, source code control systems,
            and issue tracking systems that are managed by, or on behalf of, the
            Licensor for the purpose of discussing and improving the Work, but
            excluding communication that is conspicuously marked or otherwise
            designated in writing by the copyright owner as "Not a Contribution."
        
            "Contributor" shall mean Licensor and any individual or Legal Entity
            on behalf of whom a Contribution has been received by Licensor and
            subsequently incorporated within the Work.
        
        2.  Grant of Copyright License. Subject to the terms and conditions of
            this License, each Contributor hereby grants to You a perpetual,
            worldwide, non-exclusive, no-charge, royalty-free, irrevocable
            copyright license to reproduce, prepare Derivative Works of,
            publicly display, publicly perform, sublicense, and distribute the
            Work and such Derivative Works in Source or Object form.
        
        3.  Grant of Patent License. Subject to the terms and conditions of
            this License, each Contributor hereby grants to You a perpetual,
            worldwide, non-exclusive, no-charge, royalty-free, irrevocable
            (except as stated in this section) patent license to make, have made,
            use, offer to sell, sell, import, and otherwise transfer the Work,
            where such license applies only to those patent claims licensable
            by such Contributor that are necessarily infringed by their
            Contribution(s) alone or by combination of their Contribution(s)
            with the Work to which such Contribution(s) was submitted. If You
            institute patent litigation against any entity (including a
            cross-claim or counterclaim in a lawsuit) alleging that the Work
            or a Contribution incorporated within the Work constitutes direct
            or contributory patent infringement, then any patent licenses
            granted to You under this License for that Work shall terminate
            as of the date such litigation is filed.
        
        4.  Redistribution. You may reproduce and distribute copies of the
            Work or Derivative Works thereof in any medium, with or without
            modifications, and in Source or Object form, provided that You
            meet the following conditions:
        
            (a) You must give any other recipients of the Work or
            Derivative Works a copy of this License; and
        
            (b) You must cause any modified files to carry prominent notices
            stating that You changed the files; and
        
            (c) You must retain, in the Source form of any Derivative Works
            that You distribute, all copyright, patent, trademark, and
            attribution notices from the Source form of the Work,
            excluding those notices that do not pertain to any part of
            the Derivative Works; and
        
            (d) If the Work includes a "NOTICE" text file as part of its
            distribution, then any Derivative Works that You distribute must
            include a readable copy of the attribution notices contained
            within such NOTICE file, excluding those notices that do not
            pertain to any part of the Derivative Works, in at least one
            of the following places: within a NOTICE text file distributed
            as part of the Derivative Works; within the Source form or
            documentation, if provided along with the Derivative Works; or,
            within a display generated by the Derivative Works, if and
            wherever such third-party notices normally appear. The contents
            of the NOTICE file are for informational purposes only and
            do not modify the License. You may add Your own attribution
            notices within Derivative Works that You distribute, alongside
            or as an addendum to the NOTICE text from the Work, provided
            that such additional attribution notices cannot be construed
            as modifying the License.
        
            You may add Your own copyright statement to Your modifications and
            may provide additional or different license terms and conditions
            for use, reproduction, or distribution of Your modifications, or
            for any such Derivative Works as a whole, provided Your use,
            reproduction, and distribution of the Work otherwise complies with
            the conditions stated in this License.
        
        5.  Submission of Contributions. Unless You explicitly state otherwise,
            any Contribution intentionally submitted for inclusion in the Work
            by You to the Licensor shall be under the terms and conditions of
            this License, without any additional terms or conditions.
            Notwithstanding the above, nothing herein shall supersede or modify
            the terms of any separate license agreement you may have executed
            with Licensor regarding such Contributions.
        
        6.  Trademarks. This License does not grant permission to use the trade
            names, trademarks, service marks, or product names of the Licensor,
            except as required for reasonable and customary use in describing the
            origin of the Work and reproducing the content of the NOTICE file.
        
        7.  Disclaimer of Warranty. Unless required by applicable law or
            agreed to in writing, Licensor provides the Work (and each
            Contributor provides its Contributions) on an "AS IS" BASIS,
            WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
            implied, including, without limitation, any warranties or conditions
            of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
            PARTICULAR PURPOSE. You are solely responsible for determining the
            appropriateness of using or redistributing the Work and assume any
            risks associated with Your exercise of permissions under this License.
        
        8.  Limitation of Liability. In no event and under no legal theory,
            whether in tort (including negligence), contract, or otherwise,
            unless required by applicable law (such as deliberate and grossly
            negligent acts) or agreed to in writing, shall any Contributor be
            liable to You for damages, including any direct, indirect, special,
            incidental, or consequential damages of any character arising as a
            result of this License or out of the use or inability to use the
            Work (including but not limited to damages for loss of goodwill,
            work stoppage, computer failure or malfunction, or any and all
            other commercial damages or losses), even if such Contributor
            has been advised of the possibility of such damages.
        
        9.  Accepting Warranty or Additional Liability. While redistributing
            the Work or Derivative Works thereof, You may choose to offer,
            and charge a fee for, acceptance of support, warranty, indemnity,
            or other liability obligations and/or rights consistent with this
            License. However, in accepting such obligations, You may act only
            on Your own behalf and on Your sole responsibility, not on behalf
            of any other Contributor, and only if You agree to indemnify,
            defend, and hold each Contributor harmless for any liability
            incurred by, or claims asserted against, such Contributor by reason
            of your accepting any such warranty or additional liability.
        
        END OF TERMS AND CONDITIONS
        
        APPENDIX: How to apply the Apache License to your work.
        
              To apply the Apache License to your work, attach the following
              boilerplate notice, with the fields enclosed by brackets "[]"
              replaced with your own identifying information. (Don't include
              the brackets!)  The text should be enclosed in the appropriate
              comment syntax for the file format. We also recommend that a
              file or class name and description of purpose be included on the
              same "printed page" as the copyright notice for easier
              identification within third-party archives.
        
        Copyright 2015-2024 rjsf-team
        
        Licensed under the Apache License, Version 2.0 (the "License");
        you may not use this file except in compliance with the License.
        You may obtain a copy of the License at
        
               http://www.apache.org/licenses/LICENSE-2.0
        
        Unless required by applicable law or agreed to in writing, software
        distributed under the License is distributed on an "AS IS" BASIS,
        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
        See the License for the specific language governing permissions and
        limitations under the License.
        
        -----------
        
        The following npm packages may be included in this product:
        
         - @tanstack/query-core@5.102.8
         - @tanstack/react-query@5.102.8
        
        These packages each contain the following license and notice below:
        
        MIT License
        
        Copyright (c) 2021-present Tanner Linsley
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        The following npm packages may be included in this product:
        
         - @types/prop-types@15.7.15
         - @types/react@18.3.31
        
        These packages each contain the following license and notice below:
        
        MIT License
        
            Copyright (c) Microsoft Corporation.
        
            Permission is hereby granted, free of charge, to any person obtaining a copy
            of this software and associated documentation files (the "Software"), to deal
            in the Software without restriction, including without limitation the rights
            to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
            copies of the Software, and to permit persons to whom the Software is
            furnished to do so, subject to the following conditions:
        
            The above copyright notice and this permission notice shall be included in all
            copies or substantial portions of the Software.
        
            THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
            IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
            FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
            AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
            LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
            OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
            SOFTWARE
        
        -----------
        
        The following npm package may be included in this product:
        
         - ajv@8.20.0
        
        This package contains the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) 2015-2021 Evgeny Poberezkin
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - argparse@2.0.1
        
        This package contains the following license and notice below:
        
        A. HISTORY OF THE SOFTWARE
        ==========================
        
        Python was created in the early 1990s by Guido van Rossum at Stichting
        Mathematisch Centrum (CWI, see http://www.cwi.nl) in the Netherlands
        as a successor of a language called ABC.  Guido remains Python's
        principal author, although it includes many contributions from others.
        
        In 1995, Guido continued his work on Python at the Corporation for
        National Research Initiatives (CNRI, see http://www.cnri.reston.va.us)
        in Reston, Virginia where he released several versions of the
        software.
        
        In May 2000, Guido and the Python core development team moved to
        BeOpen.com to form the BeOpen PythonLabs team.  In October of the same
        year, the PythonLabs team moved to Digital Creations, which became
        Zope Corporation.  In 2001, the Python Software Foundation (PSF, see
        https://www.python.org/psf/) was formed, a non-profit organization
        created specifically to own Python-related Intellectual Property.
        Zope Corporation was a sponsoring member of the PSF.
        
        All Python releases are Open Source (see http://www.opensource.org for
        the Open Source Definition).  Historically, most, but not all, Python
        releases have also been GPL-compatible; the table below summarizes
        the various releases.
        
            Release         Derived     Year        Owner       GPL-
                            from                                compatible? (1)
        
            0.9.0 thru 1.2              1991-1995   CWI         yes
            1.3 thru 1.5.2  1.2         1995-1999   CNRI        yes
            1.6             1.5.2       2000        CNRI        no
            2.0             1.6         2000        BeOpen.com  no
            1.6.1           1.6         2001        CNRI        yes (2)
            2.1             2.0+1.6.1   2001        PSF         no
            2.0.1           2.0+1.6.1   2001        PSF         yes
            2.1.1           2.1+2.0.1   2001        PSF         yes
            2.1.2           2.1.1       2002        PSF         yes
            2.1.3           2.1.2       2002        PSF         yes
            2.2 and above   2.1.1       2001-now    PSF         yes
        
        Footnotes:
        
        (1) GPL-compatible doesn't mean that we're distributing Python under
            the GPL.  All Python licenses, unlike the GPL, let you distribute
            a modified version without making your changes open source.  The
            GPL-compatible licenses make it possible to combine Python with
            other software that is released under the GPL; the others don't.
        
        (2) According to Richard Stallman, 1.6.1 is not GPL-compatible,
            because its license has a choice of law clause.  According to
            CNRI, however, Stallman's lawyer has told CNRI's lawyer that 1.6.1
            is "not incompatible" with the GPL.
        
        Thanks to the many outside volunteers who have worked under Guido's
        direction to make these releases possible.
        
        
        B. TERMS AND CONDITIONS FOR ACCESSING OR OTHERWISE USING PYTHON
        ===============================================================
        
        PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2
        --------------------------------------------
        
        1. This LICENSE AGREEMENT is between the Python Software Foundation
        ("PSF"), and the Individual or Organization ("Licensee") accessing and
        otherwise using this software ("Python") in source or binary form and
        its associated documentation.
        
        2. Subject to the terms and conditions of this License Agreement, PSF hereby
        grants Licensee a nonexclusive, royalty-free, world-wide license to reproduce,
        analyze, test, perform and/or display publicly, prepare derivative works,
        distribute, and otherwise use Python alone or in any derivative version,
        provided, however, that PSF's License Agreement and PSF's notice of copyright,
        i.e., "Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010,
        2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 Python Software Foundation;
        All Rights Reserved" are retained in Python alone or in any derivative version
        prepared by Licensee.
        
        3. In the event Licensee prepares a derivative work that is based on
        or incorporates Python or any part thereof, and wants to make
        the derivative work available to others as provided herein, then
        Licensee hereby agrees to include in any such work a brief summary of
        the changes made to Python.
        
        4. PSF is making Python available to Licensee on an "AS IS"
        basis.  PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
        IMPLIED.  BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND
        DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
        FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT
        INFRINGE ANY THIRD PARTY RIGHTS.
        
        5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON
        FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS
        A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON,
        OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
        
        6. This License Agreement will automatically terminate upon a material
        breach of its terms and conditions.
        
        7. Nothing in this License Agreement shall be deemed to create any
        relationship of agency, partnership, or joint venture between PSF and
        Licensee.  This License Agreement does not grant permission to use PSF
        trademarks or trade name in a trademark sense to endorse or promote
        products or services of Licensee, or any third party.
        
        8. By copying, installing or otherwise using Python, Licensee
        agrees to be bound by the terms and conditions of this License
        Agreement.
        
        
        BEOPEN.COM LICENSE AGREEMENT FOR PYTHON 2.0
        -------------------------------------------
        
        BEOPEN PYTHON OPEN SOURCE LICENSE AGREEMENT VERSION 1
        
        1. This LICENSE AGREEMENT is between BeOpen.com ("BeOpen"), having an
        office at 160 Saratoga Avenue, Santa Clara, CA 95051, and the
        Individual or Organization ("Licensee") accessing and otherwise using
        this software in source or binary form and its associated
        documentation ("the Software").
        
        2. Subject to the terms and conditions of this BeOpen Python License
        Agreement, BeOpen hereby grants Licensee a non-exclusive,
        royalty-free, world-wide license to reproduce, analyze, test, perform
        and/or display publicly, prepare derivative works, distribute, and
        otherwise use the Software alone or in any derivative version,
        provided, however, that the BeOpen Python License is retained in the
        Software, alone or in any derivative version prepared by Licensee.
        
        3. BeOpen is making the Software available to Licensee on an "AS IS"
        basis.  BEOPEN MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
        IMPLIED.  BY WAY OF EXAMPLE, BUT NOT LIMITATION, BEOPEN MAKES NO AND
        DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
        FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE WILL NOT
        INFRINGE ANY THIRD PARTY RIGHTS.
        
        4. BEOPEN SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF THE
        SOFTWARE FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS
        AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THE SOFTWARE, OR ANY
        DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
        
        5. This License Agreement will automatically terminate upon a material
        breach of its terms and conditions.
        
        6. This License Agreement shall be governed by and interpreted in all
        respects by the law of the State of California, excluding conflict of
        law provisions.  Nothing in this License Agreement shall be deemed to
        create any relationship of agency, partnership, or joint venture
        between BeOpen and Licensee.  This License Agreement does not grant
        permission to use BeOpen trademarks or trade names in a trademark
        sense to endorse or promote products or services of Licensee, or any
        third party.  As an exception, the "BeOpen Python" logos available at
        http://www.pythonlabs.com/logos.html may be used according to the
        permissions granted on that web page.
        
        7. By copying, installing or otherwise using the software, Licensee
        agrees to be bound by the terms and conditions of this License
        Agreement.
        
        
        CNRI LICENSE AGREEMENT FOR PYTHON 1.6.1
        ---------------------------------------
        
        1. This LICENSE AGREEMENT is between the Corporation for National
        Research Initiatives, having an office at 1895 Preston White Drive,
        Reston, VA 20191 ("CNRI"), and the Individual or Organization
        ("Licensee") accessing and otherwise using Python 1.6.1 software in
        source or binary form and its associated documentation.
        
        2. Subject to the terms and conditions of this License Agreement, CNRI
        hereby grants Licensee a nonexclusive, royalty-free, world-wide
        license to reproduce, analyze, test, perform and/or display publicly,
        prepare derivative works, distribute, and otherwise use Python 1.6.1
        alone or in any derivative version, provided, however, that CNRI's
        License Agreement and CNRI's notice of copyright, i.e., "Copyright (c)
        1995-2001 Corporation for National Research Initiatives; All Rights
        Reserved" are retained in Python 1.6.1 alone or in any derivative
        version prepared by Licensee.  Alternately, in lieu of CNRI's License
        Agreement, Licensee may substitute the following text (omitting the
        quotes): "Python 1.6.1 is made available subject to the terms and
        conditions in CNRI's License Agreement.  This Agreement together with
        Python 1.6.1 may be located on the Internet using the following
        unique, persistent identifier (known as a handle): 1895.22/1013.  This
        Agreement may also be obtained from a proxy server on the Internet
        using the following URL: http://hdl.handle.net/1895.22/1013".
        
        3. In the event Licensee prepares a derivative work that is based on
        or incorporates Python 1.6.1 or any part thereof, and wants to make
        the derivative work available to others as provided herein, then
        Licensee hereby agrees to include in any such work a brief summary of
        the changes made to Python 1.6.1.
        
        4. CNRI is making Python 1.6.1 available to Licensee on an "AS IS"
        basis.  CNRI MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
        IMPLIED.  BY WAY OF EXAMPLE, BUT NOT LIMITATION, CNRI MAKES NO AND
        DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
        FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON 1.6.1 WILL NOT
        INFRINGE ANY THIRD PARTY RIGHTS.
        
        5. CNRI SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON
        1.6.1 FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS
        A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON 1.6.1,
        OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
        
        6. This License Agreement will automatically terminate upon a material
        breach of its terms and conditions.
        
        7. This License Agreement shall be governed by the federal
        intellectual property law of the United States, including without
        limitation the federal copyright law, and, to the extent such
        U.S. federal law does not apply, by the law of the Commonwealth of
        Virginia, excluding Virginia's conflict of law provisions.
        Notwithstanding the foregoing, with regard to derivative works based
        on Python 1.6.1 that incorporate non-separable material that was
        previously distributed under the GNU General Public License (GPL), the
        law of the Commonwealth of Virginia shall govern this License
        Agreement only as to issues arising under or with respect to
        Paragraphs 4, 5, and 7 of this License Agreement.  Nothing in this
        License Agreement shall be deemed to create any relationship of
        agency, partnership, or joint venture between CNRI and Licensee.  This
        License Agreement does not grant permission to use CNRI trademarks or
        trade name in a trademark sense to endorse or promote products or
        services of Licensee, or any third party.
        
        8. By clicking on the "ACCEPT" button where indicated, or by copying,
        installing or otherwise using Python 1.6.1, Licensee agrees to be
        bound by the terms and conditions of this License Agreement.
        
                ACCEPT
        
        
        CWI LICENSE AGREEMENT FOR PYTHON 0.9.0 THROUGH 1.2
        --------------------------------------------------
        
        Copyright (c) 1991 - 1995, Stichting Mathematisch Centrum Amsterdam,
        The Netherlands.  All rights reserved.
        
        Permission to use, copy, modify, and distribute this software and its
        documentation for any purpose and without fee is hereby granted,
        provided that the above copyright notice appear in all copies and that
        both that copyright notice and this permission notice appear in
        supporting documentation, and that the name of Stichting Mathematisch
        Centrum or CWI not be used in advertising or publicity pertaining to
        distribution of the software without specific, written prior
        permission.
        
        STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO
        THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
        FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE
        FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
        WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
        ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
        OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - commander@2.20.3
        
        This package contains the following license and notice below:
        
        (The MIT License)
        
        Copyright (c) 2011 TJ Holowaychuk <tj@vision-media.ca>
        
        Permission is hereby granted, free of charge, to any person obtaining
        a copy of this software and associated documentation files (the
        'Software'), to deal in the Software without restriction, including
        without limitation the rights to use, copy, modify, merge, publish,
        distribute, sublicense, and/or sell copies of the Software, and to
        permit persons to whom the Software is furnished to do so, subject to
        the following conditions:
        
        The above copyright notice and this permission notice shall be
        included in all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
        EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
        MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
        IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
        CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
        TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
        SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
        
        -----------
        
        The following npm packages may be included in this product:
        
         - compute-gcd@1.2.1
         - compute-lcm@1.1.2
         - validate.io-array@1.0.6
        
        These packages each contain the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) 2014-2015 Athan Reines.
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - crelt@1.0.7
        
        This package contains the following license and notice below:
        
        Copyright (C) 2020 by Marijn Haverbeke <marijn@haverbeke.berlin>
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in
        all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
        THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - csstype@3.0.10
        
        This package contains the following license and notice below:
        
        Copyright (c) 2017-2018 Fredrik Nicol
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - csstype@3.2.3
        
        This package contains the following license and notice below:
        
        Copyright (c) 2017-2018 Fredrik Nicol
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - deepmerge@4.3.1
        
        This package contains the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) 2012 James Halliday, Josh Duff, and other contributors
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in
        all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
        THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - discontinuous-range@1.0.0
        
        This package contains the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) 2014 David Tudury
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - dom-serializer@2.0.0
        
        This package contains the following license and notice below:
        
        License
        
        (The MIT License)
        
        Copyright (c) 2014 The cheeriojs contributors
        
        Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
        
        -----------
        
        The following npm packages may be included in this product:
        
         - domelementtype@2.3.0
         - domhandler@5.0.3
         - domutils@3.2.2
         - entities@4.5.0
        
        These packages each contain the following license and notice below:
        
        Copyright (c) Felix Böhm
        All rights reserved.
        
        Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
        
        Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
        
        Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
        
        THIS IS PROVIDED BY THE COPYRIGHT HOLDERS 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 COPYRIGHT HOLDER 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,
        EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - escape-string-regexp@4.0.0
        
        This package contains the following license and notice below:
        
        MIT License
        
        Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
        
        Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - exenv-es6@1.1.1
        
        This package contains the following license and notice below:
        
        MIT License
        
        Copyright (c) 2018 Chris Holt
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        The following npm packages may be included in this product:
        
         - fast-deep-equal@3.1.3
         - json-schema-traverse@1.0.0
        
        These packages each contain the following license and notice below:
        
        MIT License
        
        Copyright (c) 2017 Evgeny Poberezkin
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - fast-uri@3.1.7
        
        This package contains the following license and notice below:
        
        Copyright (c) 2011-2021, Gary Court until https://github.com/garycourt/uri-js/commit/a1acf730b4bba3f1097c9f52e7d9d3aba8cdcaae
        Copyright (c) 2021-present The Fastify team <https://github.com/fastify/fastify#team>
        All rights reserved.
        
        Redistribution and use in source and binary forms, with or without
        modification, are permitted provided that the following conditions are met:
            * Redistributions of source code must retain the above copyright
              notice, this list of conditions and the following disclaimer.
            * Redistributions in binary form must reproduce the above copyright
              notice, this list of conditions and the following disclaimer in the
              documentation and/or other materials provided with the distribution.
            * The names of any contributors may not be used to endorse or promote
              products derived from this software without specific prior written
              permission.
        
        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS 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 COPYRIGHT HOLDERS AND 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 complete list of contributors can be found at:
        - https://github.com/garycourt/uri-js/graphs/contributors
        
        -----------
        
        The following npm package may be included in this product:
        
         - free-style@3.1.0
        
        This package contains the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) 2014 Blake Embrey (hello@blakeembrey.com)
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in
        all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
        THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - htmlparser2@8.0.2
        
        This package contains the following license and notice below:
        
        Copyright 2010, 2011, Chris Winberry <chris@winberry.net>. All rights reserved.
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to
        deal in the Software without restriction, including without limitation the
        rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
        sell copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
         
        The above copyright notice and this permission notice shall be included in
        all copies or substantial portions of the Software.
         
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
        FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
        IN THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - is-plain-object@5.1.0
        
        This package contains the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) 2014-2017, Jon Schlinkert.
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in
        all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
        THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - isomorphic.js@0.2.5
        
        This package contains the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) 2020 Kevin Jahns <kevin.jahns@protonmail.com>.
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - js-tokens@4.0.0
        
        This package contains the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) 2014, 2015, 2016, 2017, 2018 Simon Lydell
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in
        all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
        THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - json-schema-compare@0.2.2
        
        This package contains the following license and notice below:
        
        MIT License
        
        Copyright (c) 2017 Martin Hansen
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - json-schema-merge-allof@0.8.1
        
        This package contains the following license and notice below:
        
        # json-schema-merge-allof [![Build Status](https://travis-ci.org/mokkabonna/json-schema-merge-allof.svg?branch=master)](https://travis-ci.org/mokkabonna/json-schema-merge-allof) [![Coverage Status](https://coveralls.io/repos/github/mokkabonna/json-schema-merge-allof/badge.svg?branch=master)](https://coveralls.io/github/mokkabonna/json-schema-merge-allof?branch=master)
        
        > Merge schemas combined using allOf into a more readable composed schema free from allOf.
        
        ```bash
        npm install json-schema-merge-allof --save
        ```
        
        ## Features
        
        - **Real** and **safe** merging of schemas combined with **allOf**
        - Takes away all allOf found in the whole schema
        - Lossless in terms of validation rules, merged schema does not validate more or less than the original schema
        - Results in a more readable root schema
        - Removes almost all logical impossibilities
        - Throws if no logical intersection is found (your schema would not validate anything from the start)
        - Validates in a way not possible by regular simple meta validators
        - Correctly considers additionalProperties, patternProperties and properties as a part of an whole when merging schemas containing those
        - Correctly considers items and additionalItems as a whole when merging schemas containing those
        - Supports merging schemas with items as array and direct schema
        - Supports merging dependencies when mixed array and schema
        - Supports all JSON schema core/validation keywords (v6, use custom resolvers to support other keywords)
        - Option to override common impossibility like adding properties when using **additionalProperties: false**
        - Pluggable keyword resolvers
        
        ## How
        
        Since allOf require ALL schemas provided (including the parent schema) to apply, we can iterate over all the schemas, extracting all the values for say, **type**, and find the **intersection** of valid values. Here is an example:
        
        ```js
        {
          type: ['object', 'null'],
          additionalProperties: {
            type: 'string',
            minLength: 5
          },
          allOf: [{
            type: ['array', 'object'],
            additionalProperties: {
              type: 'string',
              minLength: 10,
              maxLength: 20
            }
          }]
        }
        ```
        
        This result in the schema :
        ```js
        {
          type: 'object',
          additionalProperties: {
            type: 'string',
            minLength: 10,
            maxLength: 20
          }
        }
        ```
        
        Notice that type now excludes null and array since those are not logically possible. Also minLength is raised to 10. The other properties have no conflict and are merged into the root schema with no resolving needed.
        
        For other keywords other methods are used, here are some simple examples:
        
        - minLength, minimum, minItems etc chooses the **highest** value of the conflicting values.
        - maxLength, maximum, maxItems etc chooses the **lowest** value of the conflicting values.
        - uniqueItems is true if **any** of the conflicting values are true
        
        As you can see above the strategy is to choose the **most** restrictive of the set of values that conflict. For some keywords that is done by intersection, for others like **required** it is done by a union of all the values, since that is the most restrictive.
        
        What you are left with is a schema completely free of allOf. Except for in a couple of values that are impossible to properly intersect/combine:
        
        ### not
        
        When multiple conflicting **not** values are found, we also use the approach that pattern use, but instead of allOf we use anyOf. When extraction of common rules from anyOf is in place this can be further simplified.
        
        ## Options
        **ignoreAdditionalProperties** default **false**
        
        Allows you to combine schema properties even though some schemas have `additionalProperties: false` This is the most common issue people face when trying to expand schemas using allOf and a limitation of the json schema spec. Be aware though that the schema produced will allow more than the original schema. But this is useful if just want to combine schemas using allOf as if additionalProperties wasn't false during the merge process. The resulting schema will still get additionalProperties set to false.
        
        **deep** boolean, default *true*
        If false, resolves only the top-level `allOf` keyword in the schema.
        
        If true, resolves all `allOf` keywords in the schema.
        
        
        **resolvers** Object
        Override any default resolver like this:
        
        ```js
        mergeAllOf(schema, {
          resolvers: {
            title: function(values, path, mergeSchemas, options) {
              // choose what title you want to be used based on the conflicting values
              // resolvers MUST return a value other than undefined
            }
          }
        })
        ```
        
        The function is passed:
        
        - **values** an array of the conflicting values that need to be resolved
        - **path** an array of strings containing the path to the position in the schema that caused the resolver to be called (useful if you use the same resolver for multiple keywords, or want to implement specific logic for custom paths)
        - **mergeSchemas** a function you can call that merges an array of schemas
        - **options** the options mergeAllOf was called with
        
        
        ### Combined resolvers
        Some keyword are dependant on other keywords, like properties, patternProperties, additionalProperties. To create a resolver for these the resolver requires this structure:
        
        ```js
        mergeAllOf(schema, {
          resolvers: {
            properties:
              keywords: ['properties', 'patternProperties', 'additionalProperties'],
              resolver(values, parents, mergers, options) {
        
              }
            }
          }
        })
        ```
        
        This type of resolvers are expected to return an object containing the resolved values of all the associated keywords. The keys must be the name of the keywords. So the properties resolver need to return an object like this containing the resolved values for each keyword:
        
        ```js
        {
            properties: ...,
            patternProperties: ...,
            additionalProperties: ...,
        }
        ```
        
        Also the resolve function is not passed **mergeSchemas**, but an object **mergers** that contains mergers for each of the related keywords. So properties get passed an object like this:
        
        ```js
        const mergers = {
            properties: function mergeSchemas(schemas, childSchemaName){...},
            patternProperties: function mergeSchemas(schemas, childSchemaName){...},
            additionalProperties: function mergeSchemas(schemas){...},
        }
        ```
        
        Some of the mergers requires you to supply a string of the name or index of the subschema you are currently merging. This is to make sure the path passed to child resolvers are correct.
        
        ### Default resolver
        You can set a default resolver that catches any unknown keyword. Let's say you want to use the same strategy as the ones for the meta keywords, to use the first value found. You can accomplish that like this:
        
        ```js
        mergeJsonSchema({
          ...
        }, {
          resolvers: {
            defaultResolver: mergeJsonSchema.options.resolvers.title
          }
        })
        ```
        
        
        ## Resolvers
        
        Resolvers are called whenever multiple conflicting values are found on the same position in the schemas.
        
        You can override a resolver by supplying it in the options.
        
        ### Lossy vs lossless
        
        All built in reducers for validation keywords are lossless, meaning that they don't remove or add anything in terms of validation.
        
        For meta keywords like title, description, $id, $schema, default the strategy is to use the first possible value if there are conflicting ones. So the root schema is prioritized. This process possibly removes some meta information from your schema. So it's lossy. Override this by providing custom resolvers.
        
        
        ## $ref
        
        If one of your schemas contain a $ref property you should resolve them using a ref resolver like [json-schema-ref-parser](https://github.com/BigstickCarpet/json-schema-ref-parser) to dereference your schema for you first. Resolving $refs is not the task of this library.
        
        
        ## Other libraries
        
        There exists some libraries that claim to merge schemas combined with allOf, but they just merge schemas using a **very** basic logic. Basically just the same as lodash merge. So you risk ending up with a schema that allows more or less than the original schema would allow.
        
        
        ## Restrictions
        
        We cannot merge schemas that are a logical impossibility, like:
        
        ```js
        {
          type: 'object',
          allOf: [{
            type: 'array'
          }]
        }
        ```
        
        The library will then throw an error reporting the values that had no valid intersection. But then again, your original schema wouldn't validate anything either.
        
        
        ## Roadmap
        
        - [x] Treat the interdependent validations like properties and additionalProperties as one resolver (and items additionalItems)
        - [ ] Extract repeating validators from anyOf/oneOf and merge them with parent schema
        - [ ] After extraction of validators from anyOf/oneOf, compare them and remove duplicates.
        - [ ] If left with only one in anyOf/oneOf then merge it to the parent schema.
        - [ ] Expose seperate tools for validation, extraction
        - [ ] Consider adding even more logical validation (like minLength <= maxLength)
        
        ## Contributing
        
        Create tests for new functionality and follow the eslint rules.
        
        ## License
        
        MIT © [Martin Hansen](http://martinhansen.com)
        
        -----------
        
        The following npm package may be included in this product:
        
         - json5@2.2.3
        
        This package contains the following license and notice below:
        
        MIT License
        
        Copyright (c) 2012-2018 Aseem Kishore, and [others].
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        [others]: https://github.com/json5/json5/contributors
        
        -----------
        
        The following npm package may be included in this product:
        
         - jsonpointer@5.0.1
        
        This package contains the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) 2011-2015 Jan Lehnardt <jan@apache.org> & Marc Bachmann <https://github.com/marcbachmann> 
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in
        all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
        THE SOFTWARE.
        
        -----------
        
        The following npm packages may be included in this product:
        
         - lib0@0.2.117
         - y-protocols@1.0.7
        
        These packages each contain the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) 2019 Kevin Jahns <kevin.jahns@protonmail.com>.
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        The following npm packages may be included in this product:
        
         - lodash-es@4.18.1
         - lodash@4.18.1
        
        These packages each contain the following license and notice below:
        
        Copyright OpenJS Foundation and other contributors <https://openjsf.org/>
        
        Based on Underscore.js, copyright Jeremy Ashkenas,
        DocumentCloud and Investigative Reporters & Editors <http://underscorejs.org/>
        
        This software consists of voluntary contributions made by many
        individuals. For exact contribution history, see the revision history
        available at https://github.com/lodash/lodash
        
        The following license applies to all parts of this software except as
        documented below:
        
        ====
        
        Permission is hereby granted, free of charge, to any person obtaining
        a copy of this software and associated documentation files (the
        "Software"), to deal in the Software without restriction, including
        without limitation the rights to use, copy, modify, merge, publish,
        distribute, sublicense, and/or sell copies of the Software, and to
        permit persons to whom the Software is furnished to do so, subject to
        the following conditions:
        
        The above copyright notice and this permission notice shall be
        included in all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
        EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
        MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
        NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
        LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
        OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
        WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
        
        ====
        
        Copyright and related rights for sample code are waived via CC0. Sample
        code is defined as all source code displayed within the prose of the
        documentation.
        
        CC0: http://creativecommons.org/publicdomain/zero/1.0/
        
        ====
        
        Files located in the node_modules and vendor directories are externally
        maintained libraries used by this software which have their own
        licenses; we recommend you read them, as their terms may differ from the
        terms above.
        
        -----------
        
        The following npm package may be included in this product:
        
         - lodash.escape@4.0.1
        
        This package contains the following license and notice below:
        
        Copyright jQuery Foundation and other contributors <https://jquery.org/>
        
        Based on Underscore.js, copyright Jeremy Ashkenas,
        DocumentCloud and Investigative Reporters & Editors <http://underscorejs.org/>
        
        This software consists of voluntary contributions made by many
        individuals. For exact contribution history, see the revision history
        available at https://github.com/lodash/lodash
        
        The following license applies to all parts of this software except as
        documented below:
        
        ====
        
        Permission is hereby granted, free of charge, to any person obtaining
        a copy of this software and associated documentation files (the
        "Software"), to deal in the Software without restriction, including
        without limitation the rights to use, copy, modify, merge, publish,
        distribute, sublicense, and/or sell copies of the Software, and to
        permit persons to whom the Software is furnished to do so, subject to
        the following conditions:
        
        The above copyright notice and this permission notice shall be
        included in all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
        EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
        MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
        NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
        LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
        OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
        WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
        
        ====
        
        Copyright and related rights for sample code are waived via CC0. Sample
        code is defined as all source code displayed within the prose of the
        documentation.
        
        CC0: http://creativecommons.org/publicdomain/zero/1.0/
        
        ====
        
        Files located in the node_modules and vendor directories are externally
        maintained libraries used by this software which have their own
        licenses; we recommend you read them, as their terms may differ from the
        terms above.
        
        -----------
        
        The following npm package may be included in this product:
        
         - loose-envify@1.4.0
        
        This package contains the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) 2015 Andres Suarez <zertosh@gmail.com>
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in
        all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
        THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - markdown-to-jsx@7.7.17
        
        This package contains the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) 2015-present Evan Jacobs
        
        Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - minimist@1.2.8
        
        This package contains the following license and notice below:
        
        This software is released under the MIT license:
        
        Permission is hereby granted, free of charge, to any person obtaining a copy of
        this software and associated documentation files (the "Software"), to deal in
        the Software without restriction, including without limitation the rights to
        use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
        the Software, and to permit persons to whom the Software is furnished to do so,
        subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
        FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
        COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
        IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
        CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - moo@0.5.3
        
        This package contains the following license and notice below:
        
        BSD 3-Clause License
        
        Copyright (c) 2017, Tim Radvan (tjvr)
        All rights reserved.
        
        Redistribution and use in source and binary forms, with or without
        modification, are permitted provided that the following conditions are met:
        
        * Redistributions of source code must retain the above copyright notice, this
          list of conditions and the following disclaimer.
        
        * Redistributions in binary form must reproduce the above copyright notice,
          this list of conditions and the following disclaimer in the documentation
          and/or other materials provided with the distribution.
        
        * Neither the name of the copyright holder nor the names of its
          contributors may be used to endorse or promote products derived from
          this software without specific prior written permission.
        
        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS 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 COPYRIGHT HOLDER 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 following npm package may be included in this product:
        
         - nanoid@3.3.19
        
        This package contains the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright 2017 Andrey Sitnik <andrey@sitnik.ru>
        
        Permission is hereby granted, free of charge, to any person obtaining a copy of
        this software and associated documentation files (the "Software"), to deal in
        the Software without restriction, including without limitation the rights to
        use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
        the Software, and to permit persons to whom the Software is furnished to do so,
        subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
        FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
        COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
        IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
        CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - nearley@2.20.1
        
        This package contains the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) 2014, 2015, 2016, 2017, 2018, 2019 Kartik Chandra, Tim Radvan
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - object-assign@4.1.1
        
        This package contains the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in
        all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
        THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - parse-srcset@1.0.2
        
        This package contains the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) 2014 Alex Bell
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - path-browserify@1.0.1
        
        This package contains the following license and notice below:
        
        MIT License
        
        Copyright (c) 2013 James Halliday
        
        Permission is hereby granted, free of charge, to any person obtaining a copy of
        this software and associated documentation files (the "Software"), to deal in
        the Software without restriction, including without limitation the rights to
        use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
        the Software, and to permit persons to whom the Software is furnished to do so,
        subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
        FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
        COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
        IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
        CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - picocolors@1.1.1
        
        This package contains the following license and notice below:
        
        ISC License
        
        Copyright (c) 2021-2024 Oleksii Raspopov, Kostiantyn Denysov, Anton Verinov
        
        Permission to use, copy, modify, and/or distribute this software for any
        purpose with or without fee is hereby granted, provided that the above
        copyright notice and this permission notice appear in all copies.
        
        THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
        WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
        MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
        ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
        WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
        ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
        OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - postcss@8.5.28
        
        This package contains the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright 2013 Andrey Sitnik <andrey@sitnik.es>
        
        Permission is hereby granted, free of charge, to any person obtaining a copy of
        this software and associated documentation files (the "Software"), to deal in
        the Software without restriction, including without limitation the rights to
        use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
        the Software, and to permit persons to whom the Software is furnished to do so,
        subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
        FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
        COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
        IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
        CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - prop-types@15.8.1
        
        This package contains the following license and notice below:
        
        MIT License
        
        Copyright (c) 2013-present, Facebook, Inc.
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        The following npm packages may be included in this product:
        
         - querystringify@2.2.0
         - requires-port@1.0.0
         - url-parse@1.5.10
        
        These packages each contain the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) 2015 Unshift.io, Arnout Kazemier,  the Contributors.
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - railroad-diagrams@1.0.0
        
        This package contains the following license and notice below:
        
        Railroad-diagram Generator
        ==========================
        
        This is a small js library for generating railroad diagrams
        (like what [JSON.org](http://json.org) uses)
        using SVG.
        
        Railroad diagrams are a way of visually representing a grammar
        in a form that is more readable than using regular expressions or BNF.
        I think (though I haven't given it a lot of thought yet) that if it's easy to write a context-free grammar for the language,
        the corresponding railroad diagram will be easy as well.
        
        There are several railroad-diagram generators out there, but none of them had the visual appeal I wanted.
        [Here's an example of how they look!](http://www.xanthir.com/etc/railroad-diagrams/example.html)
        And [here's an online generator for you to play with and get SVG code from!](http://www.xanthir.com/etc/railroad-diagrams/generator.html)
        
        The library now exists in a Python port as well!  See the information further down.
        
        Details
        -------
        
        To use the library, just include the js and css files, and then call the Diagram() function.
        Its arguments are the components of the diagram (Diagram is a special form of Sequence).
        An alternative to Diagram() is ComplexDiagram() which is used to describe a complex type diagram.
        Components are either leaves or containers.
        
        The leaves:
        * Terminal(text) or a bare string - represents literal text
        * NonTerminal(text) - represents an instruction or another production
        * Comment(text) - a comment
        * Skip() - an empty line
        
        The containers:
        * Sequence(children) - like simple concatenation in a regex
        * Choice(index, children) - like | in a regex.  The index argument specifies which child is the "normal" choice and should go in the middle
        * Optional(child, skip) - like ? in a regex.  A shorthand for `Choice(1, [Skip(), child])`.  If the optional `skip` parameter has the value `"skip"`, it instead puts the Skip() in the straight-line path, for when the "normal" behavior is to omit the item.
        * OneOrMore(child, repeat) - like + in a regex.  The 'repeat' argument is optional, and specifies something that must go between the repetitions.
        * ZeroOrMore(child, repeat, skip) - like * in a regex.  A shorthand for `Optional(OneOrMore(child, repeat))`.  The optional `skip` parameter is identical to Optional().
        
        For convenience, each component can be called with or without `new`.
        If called without `new`,
        the container components become n-ary;
        that is, you can say either `new Sequence([A, B])` or just `Sequence(A,B)`.
        
        After constructing a Diagram, call `.format(...padding)` on it, specifying 0-4 padding values (just like CSS) for some additional "breathing space" around the diagram (the paddings default to 20px).
        
        The result can either be `.toString()`'d for the markup, or `.toSVG()`'d for an `<svg>` element, which can then be immediately inserted to the document.  As a convenience, Diagram also has an `.addTo(element)` method, which immediately converts it to SVG and appends it to the referenced element with default paddings. `element` defaults to `document.body`.
        
        Options
        -------
        
        There are a few options you can tweak, at the bottom of the file.  Just tweak either until the diagram looks like what you want.
        You can also change the CSS file - feel free to tweak to your heart's content.
        Note, though, that if you change the text sizes in the CSS,
        you'll have to go adjust the metrics for the leaf nodes as well.
        
        * VERTICAL_SEPARATION - sets the minimum amount of vertical separation between two items.  Note that the stroke width isn't counted when computing the separation; this shouldn't be relevant unless you have a very small separation or very large stroke width.
        * ARC_RADIUS - the radius of the arcs used in the branching containers like Choice.  This has a relatively large effect on the size of non-trivial diagrams.  Both tight and loose values look good, depending on what you're going for.
        * DIAGRAM_CLASS - the class set on the root `<svg>` element of each diagram, for use in the CSS stylesheet.
        * STROKE_ODD_PIXEL_LENGTH - the default stylesheet uses odd pixel lengths for 'stroke'. Due to rasterization artifacts, they look best when the item has been translated half a pixel in both directions. If you change the styling to use a stroke with even pixel lengths, you'll want to set this variable to `false`.
        * INTERNAL_ALIGNMENT - when some branches of a container are narrower than others, this determines how they're aligned in the extra space.  Defaults to "center", but can be set to "left" or "right".
        
        Caveats
        -------
        
        At this early stage, the generator is feature-complete and works as intended, but still has several TODOs:
        
        * The font-sizes are hard-coded right now, and the font handling in general is very dumb - I'm just guessing at some metrics that are probably "good enough" rather than measuring things properly.
        
        Python Port
        -----------
        
        In addition to the canonical JS version, the library now exists as a Python library as well.
        
        Using it is basically identical.  The config variables are globals in the file, and so may be adjusted either manually or via tweaking from inside your program.
        
        The main difference from the JS port is how you extract the string from the Diagram.  You'll find a `writeSvg(writerFunc)` method on `Diagram`, which takes a callback of one argument and passes it the string form of the diagram.  For example, it can be used like `Diagram(...).writeSvg(sys.stdout.write)` to write to stdout.  **Note**: the callback will be called multiple times as it builds up the string, not just once with the whole thing.  If you need it all at once, consider something like a `StringIO` as an easy way to collect it into a single string.
        
        License
        -------
        
        This document and all associated files in the github project are licensed under [CC0](http://creativecommons.org/publicdomain/zero/1.0/) ![](http://i.creativecommons.org/p/zero/1.0/80x15.png).
        This means you can reuse, remix, or otherwise appropriate this project for your own use **without restriction**.
        (The actual legal meaning can be found at the above link.)
        Don't ask me for permission to use any part of this project, **just use it**.
        I would appreciate attribution, but that is not required by the license.
        
        -----------
        
        The following npm packages may be included in this product:
        
         - randexp@0.4.6
         - ret@0.1.15
        
        These packages each contain the following license and notice below:
        
        Copyright (C) 2011 by Roly Fentanes
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in
        all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
        THE SOFTWARE.
        
        -----------
        
        The following npm packages may be included in this product:
        
         - react-dom@18.3.1
         - react-is@16.13.1
         - react-is@18.3.1
         - react@18.3.1
         - scheduler@0.23.2
        
        These packages each contain the following license and notice below:
        
        MIT License
        
        Copyright (c) Facebook, Inc. and its affiliates.
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - require-from-string@2.0.2
        
        This package contains the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) Vsevolod Strukchinsky <floatdrop@gmail.com> (github.com/floatdrop)
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in
        all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
        THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - sanitize-html@2.12.1
        
        This package contains the following license and notice below:
        
        Copyright (c) 2013, 2014, 2015 P'unk Avenue LLC
        
        Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - source-map-js@1.2.1
        
        This package contains the following license and notice below:
        
        Copyright (c) 2009-2011, Mozilla Foundation and contributors
        All rights reserved.
        
        Redistribution and use in source and binary forms, with or without
        modification, are permitted provided that the following conditions are met:
        
        * Redistributions of source code must retain the above copyright notice, this
          list of conditions and the following disclaimer.
        
        * Redistributions in binary form must reproduce the above copyright 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 Mozilla Foundation nor the names of project
          contributors may be used to endorse or promote products derived from this
          software without specific prior written permission.
        
        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS 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 COPYRIGHT HOLDER 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 following npm package may be included in this product:
        
         - sql-formatter@15.8.2
        
        This package contains the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) 2016-2020 ZeroTurnaround LLC
        Copyright (c) 2020-2021 George Leslie-Waksman and other contributors
        Copyright (c) 2021-Present inferrinizzard and other contributors
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - style-mod@4.1.3
        
        This package contains the following license and notice below:
        
        Copyright (C) 2018 by Marijn Haverbeke <marijn@haverbeke.berlin> and others
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in
        all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
        THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - tabbable@5.3.3
        
        This package contains the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) 2015 David Clark
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - tslib@1.14.1
        
        This package contains the following license and notice below:
        
        Copyright (c) Microsoft Corporation.
        
        Permission to use, copy, modify, and/or distribute this software for any
        purpose with or without fee is hereby granted.
        
        THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
        REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
        AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
        INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
        LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
        OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
        PERFORMANCE OF THIS SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - typestyle@2.4.0
        
        This package contains the following license and notice below:
        
        MIT License
        
        Copyright (c) 2016 typestyle
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        The following npm packages may be included in this product:
        
         - validate.io-function@1.0.2
         - validate.io-integer@1.0.5
         - validate.io-number@1.0.3
        
        These packages each contain the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) 2014 Athan Reines.
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - validate.io-integer-array@1.0.0
        
        This package contains the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) 2015 Athan Reines.
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - w3c-keyname@2.2.8
        
        This package contains the following license and notice below:
        
        Copyright (C) 2016 by Marijn Haverbeke <marijn@haverbeke.berlin> and others
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in
        all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
        THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - ws@8.21.3
        
        This package contains the following license and notice below:
        
        Copyright (c) 2011 Einar Otto Stangvik <einaros@gmail.com>
        Copyright (c) 2013 Arnout Kazemier and contributors
        Copyright (c) 2016 Luigi Pinca and contributors
        
        Permission is hereby granted, free of charge, to any person obtaining a copy of
        this software and associated documentation files (the "Software"), to deal in
        the Software without restriction, including without limitation the rights to
        use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
        the Software, and to permit persons to whom the Software is furnished to do so,
        subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
        FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
        COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
        IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
        CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
        
        -----------
        
        The following npm package may be included in this product:
        
         - yjs@13.6.32
        
        This package contains the following license and notice below:
        
        The MIT License (MIT)
        
        Copyright (c) 2023
          - Kevin Jahns <kevin.jahns@protonmail.com>.
          - Chair of Computer Science 5 (Databases & Information Systems), RWTH Aachen University, Germany
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
        -----------
        
        This file was generated with the generate-license-file npm package!
        https://www.npmjs.com/package/generate-license-file
License-File: LICENSE
Keywords: jupyter,jupyterlab,jupyterlab-extension
Classifier: Framework :: Jupyter
Classifier: Framework :: Jupyter :: JupyterLab
Classifier: Framework :: Jupyter :: JupyterLab :: 4
Classifier: Framework :: Jupyter :: JupyterLab :: Extensions
Classifier: Framework :: Jupyter :: JupyterLab :: Extensions :: Prebuilt
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Requires-Dist: google-cloud-bigquery>=3.0.0
Requires-Dist: jupyter-server<3,>=2.0.1
Provides-Extra: test
Requires-Dist: coverage; extra == 'test'
Requires-Dist: pytest; extra == 'test'
Requires-Dist: pytest-asyncio; extra == 'test'
Requires-Dist: pytest-cov; extra == 'test'
Requires-Dist: pytest-jupyter[server]>=0.6.0; extra == 'test'
Description-Content-Type: text/markdown

# bigquery_jupyter_plugin

BigQuery JupyterLab Plugin

This extension provides extensions to JupyterLab for working with BigQuery.

## Requirements

- JupyterLab >= 4.0.0

## Install

To install the extension, execute:

```bash
pip install bigquery_jupyter_plugin
```

## Uninstall

To remove the extension, execute:

```bash
pip uninstall bigquery_jupyter_plugin
```

## Troubleshoot

To check if the server extension is enabled:

```bash
jupyter server extension list
```

## Contributing

### Installing from your local repo/branch

```bash
pip install -e ".[test]"
```

### Testing the extension

#### Server tests

This extension is using [Pytest](https://docs.pytest.org/) for Python code testing.

Install test dependencies (needed only once):

```sh
pip install -e ".[test]"
```

To execute them, run:

```sh
pytest -vv -r ap --cov bigquery_jupyter_plugin
```

### Packaging the extension

See [RELEASE](RELEASE.md)
