scheduler-jupyter-plugin


Namescheduler-jupyter-plugin JSON
Version 0.1.0 PyPI version JSON
download
home_pageNone
SummaryA JupyterLab extension.
upload_time2025-07-09 17:39:54
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseThis 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: - @ant-design/colors@7.2.0 - @ant-design/icons@5.6.0 These packages each contain the following license and notice below: MIT LICENSE Copyright (c) 2018-present Ant UED, https://xtech.antfin.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: - @ant-design/cssinjs-utils@1.1.3 - @ant-design/fast-color@2.0.6 - @rc-component/qrcode@1.0.0 - @rc-component/trigger@2.2.6 - rc-dropdown@4.2.1 - rc-slider@11.1.8 These packages each contain the following license and notice below: The MIT License (MIT) Copyright (c) 2015-present Alipay.com, https://www.alipay.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: - @ant-design/cssinjs@1.23.0 - rc-input@1.7.2 - rc-motion@2.9.5 - rc-overflow@1.4.1 - rc-picker@4.9.2 - rc-resize-observer@1.4.3 - rc-segmented@2.7.0 - rc-textarea@1.9.0 These packages each contain the following license and notice below: The MIT License (MIT) Copyright (c) 2019-present afc163 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: - @ant-design/icons-svg@4.4.2 This package contains the following license and notice below: <h1 align="center"> Ant Design Icons </h1> <p align="center"> ⭐ The abstract node of the Ant Design SVG icons. </p> <div align="center"> [![NPM version](https://img.shields.io/npm/v/@ant-design/icons-svg.svg?style=flat)](https://npmjs.org/package/@ant-design/icons-svg) [![NPM downloads](http://img.shields.io/npm/dm/@ant-design/icons-svg.svg?style=flat)](https://npmjs.org/package/@ant-design/icons-svg) </div> Check [all icons list](https://github.com/ant-design/ant-design-icons/issues/227). ## Install ```bash # use yarn $ yarn add @ant-design/icons-svg # or use npm $ npm install @ant-design/icons-svg --save ``` ## Use Library Adapter - React: See [@ant-design/icons](../icons-react) to learn about detail usage. ## Contribution Guide 贡献指南 See contribution guide. [English](./docs/ContributionGuide.md) | [中文](./docs/ContributionGuide.zh-CN.md) ## Get started ```ts import { AccountBookOutlined } from '@ant-design/icons-svg'; // or // import AccountBookOutlined from '@ant-design/icons-svg/es/asn/AccountBookOutlined'; console.log(AccountBookOutlined); // ==> // { // name: 'account-book', // theme: 'outlined', // icon: { // tag: 'svg', // attrs: { // viewBox: '64 64 896 896', // focusable: 'false' // }, // children: [ // { // tag: 'path', // attrs: { // d: // 'M880 184H712v-64c0-4.4-3.6-8-8-8h- ...' // } // } // ] // } // }; ``` - Interfaces This library export all SVG files as `IconDefinition`. ```ts // types.d.ts export declare type ThemeType = 'filled' | 'outlined' | 'twotone'; export interface AbstractNode { tag: string; attrs: { [key: string]: string; }; children?: AbstractNode[]; } export interface IconDefinition { name: string; // kebab-case-style theme: ThemeType; icon: | ((primaryColor: string, secondaryColor: string) => AbstractNode) | AbstractNode; } ``` ## Render Helpers ```ts import { AccountBookFilled } from '@ant-design/icons-svg'; import { renderIconDefinitionToSVGElement } from '@ant-design/icons-svg/es/helpers'; const svgHTMLString = renderIconDefinitionToSVGElement(AccountBookFilled, { extraSVGAttrs: { width: '1em', height: '1em', fill: 'currentColor' } }); console.log(svgHTMLString); // ==> // '<svg viewBox="64 64 896 896" width="1em" height="1em" fill="currentColor"><path d="M880 184H712v-64c0-4.4-3.6-8-8-8h-56c-4.4 0-8 3.6-8 8v64H384v-64c0-4.4-3.6-8-8-8h-56c-4.4 0-8 3.6-8 8v64H144c-17.7 0-32 14.3-32 32v664c0 17.7 14.3 32 32 32h736c17.7 0 32-14.3 32-32V216c0-17.7-14.3-32-32-32zM648.3 426.8l-87.7 161.1h45.7c5.5 0 10 4.5 10 10v21.3c0 5.5-4.5 10-10 10h-63.4v29.7h63.4c5.5 0 10 4.5 10 10v21.3c0 5.5-4.5 10-10 10h-63.4V752c0 5.5-4.5 10-10 10h-41.3c-5.5 0-10-4.5-10-10v-51.8h-63.1c-5.5 0-10-4.5-10-10v-21.3c0-5.5 4.5-10 10-10h63.1v-29.7h-63.1c-5.5 0-10-4.5-10-10v-21.3c0-5.5 4.5-10 10-10h45.2l-88-161.1c-2.6-4.8-.9-10.9 4-13.6 1.5-.8 3.1-1.2 4.8-1.2h46c3.8 0 7.2 2.1 8.9 5.5l72.9 144.3 73.2-144.3a10 10 0 0 1 8.9-5.5h45c5.5 0 10 4.5 10 10 .1 1.7-.3 3.3-1.1 4.8z" /></svg>' ``` - Interfaces ```ts declare function renderIconDefinitionToSVGElement( icon: IconDefinition, options?: HelperRenderOptions ): string; interface HelperRenderOptions { placeholders?: { primaryColor?: string; // default #333 secondaryColor?: string; // default #E6E6E6 }; extraSVGAttrs?: { [key: string]: string; }; } ``` ----------- The following npm packages may be included in this product: - @ant-design/react-slick@1.1.2 - json2mq@0.2.0 These packages each contain the following license and notice below: The MIT License (MIT) Copyright (c) 2014 Kiran Abburi 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: - @babel/code-frame@7.26.2 - @babel/generator@7.26.5 - @babel/helper-module-imports@7.25.9 - @babel/helper-string-parser@7.25.9 - @babel/helper-validator-identifier@7.25.9 - @babel/runtime@7.26.7 - @babel/template@7.25.9 - @babel/traverse@7.26.7 - @babel/types@7.26.7 These packages each contain the following license and notice below: MIT License Copyright (c) 2014-present Sebastian McKenzie 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: - @babel/parser@7.26.7 This package contains the following license and notice below: Copyright (C) 2012-2014 by various contributors (see AUTHORS) 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: - @codemirror/state@6.5.1 This package contains 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 packages may be included in this product: - @emotion/babel-plugin@11.13.5 - @emotion/cache@11.14.0 - @emotion/hash@0.8.0 - @emotion/hash@0.9.2 - @emotion/is-prop-valid@1.3.1 - @emotion/memoize@0.9.0 - @emotion/react@11.14.0 - @emotion/serialize@1.3.3 - @emotion/sheet@1.4.0 - @emotion/styled@11.14.0 - @emotion/unitless@0.10.0 - @emotion/unitless@0.7.5 - @emotion/use-insertion-effect-with-fallbacks@1.2.0 - @emotion/utils@1.4.2 - @emotion/weak-memoize@0.4.0 These packages each contain the following license and notice below: MIT License Copyright (c) Emotion team 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 packages may be included in this product: - @floating-ui/core@1.6.9 - @floating-ui/dom@1.6.13 - @floating-ui/react-dom@2.1.2 - @floating-ui/utils@0.2.9 These packages each contain the following license and notice below: MIT License Copyright (c) 2021-present Floating UI 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: - @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: - @jridgewell/gen-mapping@0.3.8 - @jridgewell/set-array@1.2.1 These packages each contain the following license and notice below: Copyright 2022 Justin Ridgewell <jridgewell@google.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: - @jridgewell/resolve-uri@3.1.2 This package contains the following license and notice below: Copyright 2019 Justin Ridgewell <jridgewell@google.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: - @jridgewell/sourcemap-codec@1.5.0 This package contains the following license and notice below: The MIT License Copyright (c) 2015 Rich Harris 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: - @jridgewell/trace-mapping@0.3.25 This package contains the following license and notice below: Copyright 2022 Justin Ridgewell <justin@ridgewell.name> 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: - @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@3.0.2 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.3.4 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.4.4 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.3.4 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.3.4 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.3.4 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.3.4 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 package may be included in this product: - @jupyterlab/mainmenu@4.3.4 This package contains the following license and notice below: # @jupyterlab/mainmenu A JupyterLab extension which provides the application menubar. ----------- The following npm packages may be included in this product: - @jupyterlab/nbformat@4.3.4 - @jupyterlab/settingregistry@4.3.4 - @jupyterlab/statedb@4.3.4 - @jupyterlab/statusbar@4.3.4 - @lumino/algorithm@2.0.2 - @lumino/application@2.4.1 - @lumino/collections@2.0.2 - @lumino/commands@2.3.1 - @lumino/coreutils@2.2.0 - @lumino/disposable@2.1.3 - @lumino/domutils@2.0.2 - @lumino/dragdrop@2.1.5 - @lumino/keyboard@2.0.2 - @lumino/messaging@2.0.2 - @lumino/properties@2.0.2 - @lumino/signaling@2.1.3 - @lumino/virtualdom@2.0.2 - @lumino/widgets@2.5.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.3.4 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.11.4 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.3.4 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.3.4 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 Webpack 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 usecase 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.3.4 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.3.4 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 package may be included in this product: - @lumino/polling@2.1.3 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.2 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: - @mui/base@5.0.0-dev.20240529-082515-213b5e33ab - @mui/core-downloads-tracker@5.16.14 - @mui/icons-material@5.16.14 - @mui/material@5.16.14 - @mui/private-theming@5.16.14 - @mui/styled-engine@5.16.14 - @mui/system@5.16.14 - @mui/types@7.2.21 - @mui/utils@5.16.14 - @mui/utils@6.4.1 These packages each contain the following license and notice below: The MIT License (MIT) Copyright (c) 2014 Call-Em-All 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: - @mui/x-date-pickers@6.20.2 This package contains the following license and notice below: MIT License Copyright (c) 2020 Material-UI SAS 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: - @popperjs/core@2.11.8 This package contains the following license and notice below: The MIT License (MIT) Copyright (c) 2019 Federico Zivolo 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: - @rc-component/async-validator@5.0.4 - @rc-component/context@1.4.0 - rc-collapse@3.9.0 - rc-dialog@9.6.0 - rc-input-number@9.4.0 - rc-menu@9.16.0 - rc-notification@5.6.2 - rc-pagination@5.0.0 - rc-progress@4.0.0 - rc-rate@2.13.0 - rc-steps@6.0.1 - rc-switch@4.1.0 - rc-tabs@15.5.0 These packages each contain the following license and notice below: The MIT License (MIT) Copyright (c) 2014-present yiminghe 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: - @rc-component/color-picker@2.0.1 - rc-mentions@2.19.1 These packages each contain the following license and notice below: The MIT License (MIT) Copyright (c) 2019-present alipay.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: - @rc-component/mini-decimal@1.1.0 - @rc-component/mutate-observer@1.1.0 - @rc-component/portal@1.1.2 - @rc-component/tour@1.15.1 - rc-field-form@2.7.0 These packages each contain the following license and notice below: MIT License Copyright (c) 2019-present react-component 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: - @react-dnd/asap@4.0.1 This package contains the following license and notice below: Copyright 2009–2014 Contributors. 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 packages may be included in this product: - @react-dnd/invariant@2.0.0 - prop-types@15.8.1 These packages each contain 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 package may be included in this product: - @react-dnd/shallowequal@2.0.0 This package contains the following license and notice below: MIT License Copyright (c) 2017 Alberto Leal <mailforalberto@gmail.com> (github.com/dashed) 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: - @rjsf/core@5.24.1 - @rjsf/utils@5.24.1 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: - @types/hoist-non-react-statics@3.3.6 - @types/node@22.10.10 - @types/parse-json@4.0.2 - @types/prop-types@15.7.14 - @types/react-transition-group@4.4.12 - @types/react@18.3.18 - @types/react@19.0.8 - @types/uuid@9.0.8 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.17.1 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: - antd@5.23.2 This package contains the following license and notice below: MIT LICENSE Copyright (c) 2015-present Ant UED, https://xtech.antfin.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: - babel-plugin-macros@3.1.0 This package contains the following license and notice below: The MIT License (MIT) Copyright (c) 2020 Kent C. Dodds 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: - callsites@3.1.0 - globals@11.12.0 - parent-module@1.0.1 - path-type@4.0.0 - resolve-from@4.0.0 These packages each contain the following license and notice below: MIT License 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: - classnames@2.5.1 This package contains the following license and notice below: The MIT License (MIT) Copyright (c) 2018 Jed Watson 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: - clsx@1.2.1 - clsx@2.1.1 These packages each contain the following license and notice below: MIT License Copyright (c) Luke Edwards <luke.edwards05@gmail.com> (lukeed.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: - 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: - compute-scroll-into-view@3.1.1 This package contains the following license and notice below: MIT License Copyright (c) 2025 Cody Olsen 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: - convert-source-map@1.9.0 This package contains the following license and notice below: Copyright 2013 Thorsten Lorenz. 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: - copy-to-clipboard@3.3.3 This package contains the following license and notice below: MIT License Copyright (c) 2017 sudodoki <smd.deluzion@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 packages may be included in this product: - cosmiconfig@7.1.0 - tabbable@5.3.3 These packages each contain 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: - 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.1.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: - dayjs@1.11.13 This package contains the following license and notice below: MIT License Copyright (c) 2018-present, iamkun 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: - debug@4.4.0 This package contains the following license and notice below: (The MIT License) Copyright (c) 2014-2017 TJ Holowaychuk <tj@vision-media.ca> Copyright (c) 2018-2021 Josh Junon 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 packages may be included in this product: - dnd-core@14.0.1 - react-dnd-html5-backend@14.1.0 These packages each contain the following license and notice below: The MIT License (MIT) Copyright (c) 2015 Dan Abramov 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-helpers@5.2.1 This package contains the following license and notice below: The MIT License (MIT) Copyright (c) 2015 Jason Quense 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 packages may be included in this product: - error-ex@1.3.2 - is-arrayish@0.2.1 These packages each contain the following license and notice below: The MIT License (MIT) Copyright (c) 2015 JD Ballard 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: - escape-string-regexp@4.0.0 - import-fresh@3.3.0 - parse-json@5.2.0 These packages each contain 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.0.6 This package contains the following license and notice below: Copyright (c) 2021 The Fastify Team Copyright (c) 2011-2021, Gary Court until https://github.com/garycourt/uri-js/commit/a1acf730b4bba3f1097c9f52e7d9d3aba8cdcaae 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: - find-root@1.1.0 This package contains the following license and notice below: Copyright © 2017 jsdnxx 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: - 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: - function-bind@1.1.2 This package contains the following license and notice below: Copyright (c) 2013 Raynos. 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: - hasown@2.0.2 This package contains the following license and notice below: MIT License Copyright (c) Jordan Harband 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: - hoist-non-react-statics@3.3.2 This package contains the following license and notice below: Software License Agreement (BSD License) ======================================== Copyright (c) 2015, Yahoo! Inc. All rights reserved. ---------------------------------------------------- Redistribution and use of this software 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 Yahoo! Inc. nor the names of YUI's contributors may be used to endorse or promote products derived from this software without specific prior written permission of Yahoo! Inc. 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 OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ----------- The 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-core-module@2.16.1 This package contains the following license and notice below: The MIT License (MIT) Copyright (c) 2014 Dave Justice 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.0.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: - jsesc@3.1.0 This package contains the following license and notice below: Copyright Mathias Bynens <https://mathiasbynens.be/> 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-parse-even-better-errors@2.3.1 This package contains the following license and notice below: Copyright 2017 Kat Marchán Copyright npm, 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. --- This library is a fork of 'better-json-errors' by Kat Marchán, extended and distributed under the terms of the MIT license above. ----------- 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.99 - y-protocols@1.0.6 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 package may be included in this product: - lines-and-columns@1.2.4 This package contains the following license and notice below: The MIT License (MIT) Copyright (c) 2015 Brian Donovan 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.17.21 - lodash@4.17.21 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.3 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: - memoize-one@5.2.1 This package contains the following license and notice below: MIT License Copyright (c) 2019 Alexander Reardon 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: - ms@2.1.3 This package contains the following license and notice below: The MIT License (MIT) Copyright (c) 2020 Vercel, 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 package may be included in this product: - mui-chips-input@2.1.5 This package contains the following license and notice below: MIT License Copyright (c) 2022 Victor de la Fouchardière 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: - nanoid@3.3.8 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: - 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: - path-parse@1.0.7 This package contains the following license and notice below: The MIT License (MIT) Copyright (c) 2015 Javier Blanco 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.1 This package contains the following license and notice below: The MIT License (MIT) Copyright 2013 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 packages may be included in this product: - property-expr@2.0.6 - yup@1.6.1 These packages each contain the following license and notice below: The MIT License (MIT) Copyright (c) 2014 Jason Quense 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 packages may be included in this product: - rc-cascader@3.33.0 - rc-select@14.16.6 These packages each contain the following license and notice below: The MIT License (MIT) Copyright (c) 2014-present alipay.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: - rc-checkbox@3.5.0 This package contains the following license and notice below: The MIT License (MIT) Copyright (c) 2016 React Components 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: - rc-drawer@7.2.0 - rc-tree-select@5.27.0 - rc-tree@5.13.0 These packages each contain the following license and notice below: MIT LICENSE Copyright (c) 2015-present Alipay.com, https://www.alipay.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: - rc-image@7.11.0 - rc-table@7.50.2 These packages each contain the following license and notice below: MIT LICENSE Copyright (c) 2015-present Alipay.com, https://www.alipay.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: - rc-tooltip@6.3.2 - rc-virtual-list@3.18.1 These packages each contain the following license and notice below: The MIT License (MIT) Copyright (c) 2015-present Alipay.com, https://www.alipay.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: - rc-upload@4.8.1 This package contains the following license and notice below: The MIT License (MIT) Copyright (c) 2016-present react-component 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: - rc-util@5.44.3 This package contains the following license and notice below: The MIT License (MIT) Copyright (c) 2014-present yiminghe Copyright (c) 2015-present Alipay.com, https://www.alipay.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: - react-arborist@3.4.0 This package contains the following license and notice below: ![Logo](https://user-images.githubusercontent.com/3460638/161630636-3512fe81-41c2-4ee5-8f7e-adaad07033b6.svg) <h1>React Arborist</h1> [See the Demos](https://react-arborist.netlify.app/) The tree view is ubiquitous in software applications. This library provides the React ecosystem with a complete solution to build the equivalent of a VSCode sidebar, Mac Finder, Windows Explorer, or Sketch/Figma layers panel. Here is a Gmail sidebar clone built with react-arborist. <img src="https://user-images.githubusercontent.com/3460638/197306119-59fe59e6-50ae-4bc2-8cb9-3faa2bc52cd2.gif" width="270px" alt="Gmail sidebar clone built with react-arborist" /> ## Features - Drag and drop sorting - Open/close folders - Inline renaming - Virtualized rendering - Custom styling - Keyboard navigation - Aria attributes - Tree filtering - Selection synchronization - Callbacks (onScroll, onActivate, onSelect) - Controlled or uncontrolled trees ## Installation ``` yarn add react-arborist ``` ``` npm install react-arborist ``` ## Examples Assume our data is this: ```js const data = [ { id: "1", name: "Unread" }, { id: "2", name: "Threads" }, { id: "3", name: "Chat Rooms", children: [ { id: "c1", name: "General" }, { id: "c2", name: "Random" }, { id: "c3", name: "Open Source Projects" }, ], }, { id: "4", name: "Direct Messages", children: [ { id: "d1", name: "Alice" }, { id: "d2", name: "Bob" }, { id: "d3", name: "Charlie" }, ], }, ]; ``` ### The Simplest Tree Use all the defaults. The _initialData_ prop makes the tree an uncontrolled component. Create, move, rename, and delete will be handled internally. ```jsx function App() { return <Tree initialData={data} />; } ``` <img width="214" alt="image" src="https://user-images.githubusercontent.com/3460638/198098015-d7dc6400-6391-4094-9f66-0f56a99433e9.png"> [Demo](https://codesandbox.io/s/the-simplest-tree-7tbedw) ### Customize the Appearance We provide our own dimensions and our own `Node` component. ```jsx function App() { return ( <Tree initialData={data} openByDefault={false} width={600} height={1000} indent={24} rowHeight={36} overscanCount={1} paddingTop={30} paddingBottom={10} padding={25 /* sets both */} > {Node} </Tree> ); } function Node({ node, style, dragHandle }) { /* This node instance can do many things. See the API reference. */ return ( <div style={style} ref={dragHandle}> {node.isLeaf ? "🍁" : "🗀"} {node.data.name} </div> ); } ``` <img width="166" alt="image" src="https://user-images.githubusercontent.com/3460638/198100281-594a492d-2ea0-4ff0-883d-1dd79dbb5acd.png"> [Demo](https://codesandbox.io/s/customize-appearance-f4g15v?file=/src/App.tsx) ### Control the Tree data Here we use the _data_ prop to make the tree a controlled component. We must handle all the data modifications ourselves using the props below. ```jsx function App() { /* Handle the data modifications outside the tree component */ const onCreate = ({ parentId, index, type }) => {}; const onRename = ({ id, name }) => {}; const onMove = ({ dragIds, parentId, index }) => {}; const onDelete = ({ ids }) => {}; return ( <Tree data={data} onCreate={onCreate} onRename={onRename} onMove={onMove} onDelete={onDelete} /> ); } ``` ### Tree Filtering Providing a non-empty _searchTerm_ will only show nodes that match. If a child matches, all its parents also match. Internal nodes are opened when filtering. You can provide your own _searchMatch_ function, or use the default. ```jsx function App() { const term = useSearchTermString() <Tree data={data} searchTerm={term} searchMatch={ (node, term) => node.data.name.toLowerCase().includes(term.toLowerCase()) } /> } ``` ### Sync the Selection It's common to open something elsewhere in the app, but have the tree reflect the new selection. Passing an id to the _selection_ prop will select and scroll to that node whenever that id changes. ```jsx function App() { const chatId = useCurrentChatId(); /* Whenever the currentChatRoomId changes, the tree will automatically select it and scroll to it. */ return <Tree initialData={data} selection={chatId} />; } ``` ### Use the Tree Api Instance You can access the Tree Api in the parent component by giving a ref to the tree. ```jsx function App() { const treeRef = useRef(); useEffect(() => { const tree = treeRef.current; tree.selectAll(); /* See the Tree API reference for all you can do with it. */ }, []); return <Tree initialData={data} ref={treeRef} />; } ``` ### Data with Different Property Names The _idAccessor_ and _childrenAccessor_ props allow you to specify the children and id fields in your data. ```jsx function App() { const data = [ { category: "Food", subCategories: [{ category: "Restaurants" }, { category: "Groceries" }], }, ]; return ( <Tree data={data} /* An accessor can provide a string property name */ idAccessor="category" /* or a function with the data as the argument */ childrenAccessor={(d) => d.subCategories} /> ); } ``` ### Custom Rendering Render every single piece of the tree yourself. See the API reference for the props passed to each renderer. ```jsx function App() { return ( <Tree data={data} /* The outer most element in the list */ renderRow={MyRow} /* The "ghost" element that follows the mouse as you drag */ renderDragPreview={MyDragPreview} /* The line that shows where an element will be dropped */ renderCursor={MyCursor} > {/* The inner element that shows the indentation and data */} {MyNode} </Tree> ); } ``` ## API Reference - Components - [Tree Component Props](#tree-component-props) - [Row Component Props](#row-component-props) - [Node Component Props](#node-component-props) - [DragPreview Component Props](#dragpreview-component-props) - [Cursor Component Props](#cursor-component-props) - Interfaces - [Node API](#node-api-reference) - [Tree API](#tree-api-reference) ## Tree Component Props These are all the props you can pass to the Tree component. ```ts interface TreeProps<T> { /* Data Options */ data?: readonly T[]; initialData?: readonly T[]; /* Data Handlers */ onCreate?: handlers.CreateHandler<T>; onMove?: handlers.MoveHandler<T>; onRename?: handlers.RenameHandler<T>; onDelete?: handlers.DeleteHandler<T>; /* Renderers*/ children?: ElementType<renderers.NodeRendererProps<T>>; renderRow?: ElementType<renderers.RowRendererProps<T>>; renderDragPreview?: ElementType<renderers.DragPreviewProps>; renderCursor?: ElementType<renderers.CursorProps>; renderContainer?: ElementType<{}>; /* Sizes */ rowHeight?: number; overscanCount?: number; width?: number | string; height?: number; indent?: number; paddingTop?: number; paddingBottom?: number; padding?: number; /* Config */ childrenAccessor?: string | ((d: T) => T[] | null); idAccessor?: string | ((d: T) => string); openByDefault?: boolean; selectionFollowsFocus?: boolean; disableMultiSelection?: boolean; disableEdit?: string | boolean | BoolFunc<T>; disableDrag?: string | boolean | BoolFunc<T>; disableDrop?: | string | boolean | ((args: { parentNode: NodeApi<T>; dragNodes: NodeApi<T>[]; index: number; }) => boolean); /* Event Handlers */ onActivate?: (node: NodeApi<T>) => void; onSelect?: (nodes: NodeApi<T>[]) => void; onScroll?: (props: ListOnScrollProps) => void; onToggle?: (id: string) => void; onFocus?: (node: NodeApi<T>) => void; /* Selection */ selection?: string; /* Open State */ initialOpenState?: OpenMap; /* Search */ searchTerm?: string; searchMatch?: (node: NodeApi<T>, searchTerm: string) => boolean; /* Extra */ className?: string | undefined; rowClassName?: string | undefined; dndRootElement?: globalThis.Node | null; onClick?: MouseEventHandler; onContextMenu?: MouseEventHandler; dndManager?: DragDropManager; } ``` ## Row Component Props The _\<RowRenderer\>_ is responsible for attaching the drop ref, the row style (top, height) and the aria-attributes. The default should work fine for most use cases, but it can be replaced by your own component if you need. See the _renderRow_ prop in the _\<Tree\>_ component. ```ts type RowRendererProps<T> = { node: NodeApi<T>; innerRef: (el: HTMLDivElement | null) => void; attrs: HTMLAttributes<any>; children: ReactElement; }; ``` ## Node Component Props The _\<NodeRenderer\>_ is responsible for attaching the drag ref, the node style (padding for indentation), the visual look of the node, the edit input of the node, and anything else you can dream up. There is a default renderer, but it's only there as a placeholder to get started. You'll want to create your own component for this. It is passed as the _\<Tree\>_ components only child. ```ts export type NodeRendererProps<T> = { style: CSSProperties; node: NodeApi<T>; tree: TreeApi<T>; dragHandle?: (el: HTMLDivElement | null) => void; preview?: boolean; }; ``` ## DragPreview Component Props The _\<DragPreview\>_ is responsible for showing a "ghost" version of the node being dragged. The default is a semi-transparent version of the NodeRenderer and should work fine for most people. To customize it, pass your new component to the _renderDragPreview_ prop. ```ts type DragPreviewProps = { offset: XYCoord | null; mouse: XYCoord | null; id: string | null; dragIds: string[]; isDragging: boolean; }; ``` ## Cursor Component Props The _\<Cursor\>_ is responsible for showing a line that indicates where the node will move to when it's dropped. The default is a blue line with circle on the left side. You may want to customize this. Pass your own component to the _renderCursor_ prop. ```ts export type CursorProps = { top: number; left: number; indent: number; }; ``` ## Node API Reference ### State Properties All these properties on the node instance return booleans related to the state of the node. _node_.**isRoot** Returns true if this is the root node. The root node is added internally by react-arborist and not shown in the UI. _node_.**isLeaf** Returns true if the children property is not an array. _node_.**isInternal** Returns true if the children property is an array. _node_.**isOpen** Returns true if node is internal and in an open state. _node_.**isEditing** Returns true if this node is currently being edited. Use this property in the NodeRenderer to render the rename form. _node_.**isSelected** Returns true if node is selected. _node_.**isSelectedStart** Returns true if node is the first of a contiguous group of selected nodes. Useful for styling. _node_.**isSelectedEnd** Returns true if node is the last of a contiguous group of selected nodes. Useful for styling. _node_.**isOnlySelection** Returns true if node is the only node selected in the tree. _node_.**isFocused** Returns true if node is focused. _node_.**isDragging** Returns true if node is being dragged. _node_.**willReceiveDrop** Returns true if node is internal and the user is hovering a dragged node over it. _node_.**state** Returns an object with all the above properties as keys and boolean values. Useful for adding class names to an element with a library like [clsx](https://github.com/lukeed/clsx) or [classnames](https://github.com/JedWatson/classnames). ```ts type NodeState = { isEditing: boolean; isDragging: boolean; isSelected: boolean; isSelectedStart: boolean; isSelectedEnd: boolean; isFocused: boolean; isOpen: boolean; isClosed: boolean; isLeaf: boolean; isInternal: boolean; willReceiveDrop: boolean; }; ``` ### Accessors _node_.**childIndex** Returns the node's index in relation to its siblings. _node_.**next** Returns the next visible node. The node directly under this node in the tree component. Returns null if none exist. _node_.**prev** Returns the previous visible node. The node directly above this node in the tree component. Returns null if none exist. _node_.**nextSibling** Returns the next sibling in the data of this node. Returns null if none exist. ### Selection Methods _node_.**select**() Select only this node. _node_.**deselect**() Deselect this node. Other nodes may still be selected. _node_.**selectMulti**() Select this node while maintaining all other selections. _node_.**selectContiguous**() Deselect all nodes from the anchor node to the last selected node, the select all nodes from the anchor node to this node. The anchor changes to the focused node after calling _select()_ or _selectMulti()_. ### Activation Methods _node_.**activate**() Runs the Tree props' onActivate callback passing in this node. _node_.**focus**() Focus this node. ### Open/Close Methods _node_.**open**() Opens the node if it is an internal node. _node_.**close**() Closes the node if it is an internal node. _node_.**toggle**() Toggles the open/closed state of the node if it is an internal node. _node_.**openParents**() Opens all the parents of this node. _node_.**edit**() Moves this node into the editing state. Calling node._isEditing_ will return true. _node_.**submit**(_newName_) Submits _newName_ string to the _onRename_ handler. Moves this node out of the editing state. _node_.**reset**() Moves this node out of the editing state without submitting a new name. ### Event Handlers _node_.**handleClick**(_event_) Useful for using the standard selection methods when a node is clicked. If the meta key is down, call _multiSelect()_. If the shift key is down, call _selectContiguous()_. Otherwise, call _select()_ and _activate()_. ## Tree API Reference The tree api reference is stable across re-renders. It always has the most recent state and props. ### Node Accessors _tree_.**get**(_id_) : _NodeApi | null_ Get node by id from the _visibleNodes_ array. _tree_.**at**(_index_) : _NodeApi | null_ Get node by index from the _visibleNodes_ array. _tree_.**visibleNodes** : _NodeApi[]_ Returns an array of the visible nodes. _tree_.**firstNode** : _NodeApi | null_ The first node in the _visibleNodes_ array. _tree_.**lastNode** : _NodeApi | null_ The last node in the _visibleNodes_ array. _tree_.**focusedNode** : _NodeApi | null_ The currently focused node. _tree_.**mostRecentNode** : _NodeApi | null_ The most recently selected node. _tree_.**nextNode** : _NodeApi | null_ The node directly after the _focusedNode_ in the _visibleNodes_ array. _tree_.**prevNode** : _NodeApi | null_ The node directly before the _focusedNode_ in the _visibleNodes_ array. ### Focus Methods _tree_.**hasFocus** : _boolean_ Returns true if the the tree has focus somewhere within it. _tree_.**focus**(_id_) Focus on the node with _id_. _tree_.**isFocused**(_id_) : _boolean_ Check if the node with _id_ is focused. _tree_.**pageUp**() Move focus up one page. _tree_.**pageDown**() Move focus down one page. ### Selection Methods _tree_.**selectedIds** : _Set\<string\>_ Returns a set of ids that are selected. _tree_.**selectedNodes** : _NodeApi[]_ Returns an array of nodes that are selected. _tree_.**hasNoSelection** : boolean Returns true if nothing is selected in the tree. _tree_.**hasSingleSelection** : boolean Returns true if there is only one selection. _tree_.**hasMultipleSelections** : boolean Returns true if there is more than one selection. _tree_.**isSelected**(_id_) : _boolean_ Returns true if the node with _id_ is selected. _tree_.**select**(_id_) Select only the node with _id_. _tree_.**deselect**(_id_) Deselect the node with _id_. _tree_.**selectMulti**(_id_) Add to the selection the node with _id_. _tree_.**selectContiguous**(_id_) Deselected nodes between the anchor and the last selected node, then select the nodes between the anchor and the node with _id_. _tree_.**deselectAll**() Deselect all nodes. _tree_.**selectAll**() Select all nodes. ### Visibility _tree_.**open**(_id_) Open the node with _id_. _tree_.**close**(_id_) Close the node with _id_. _tree_.**toggle**(_id_) Toggle the open state of the node with _id_. _tree_.**openParents**(_id_) Open all parents of the node with _id_. _tree_.**openSiblings**(_id_) Open all siblings of the node with _id_. _tree_.**openAll**() Open all internal nodes. _tree_.**closeAll**() Close all internal nodes. _tree_.**isOpen**(_id_) : _boolean_ Returns true if the node with _id_ is open. ### Drag and Drop _tree_.**isDragging**(_id_) : _boolean_ Returns true if the node with _id_ is being dragged. _tree_.**willReceiveDrop**(_id_) : _boolean_ Returns true if the node with _id_ is internal and is under the dragged node. ### Scrolling _tree_.**scrollTo**(_id_, _[align]_) Scroll to the node with _id_. If this node is not visible, this method will open all its parents. The align argument can be _"auto" | "smart" | "center" | "end" | "start"_. ### Properties _tree_.**isEditing** : _boolean_ Returns true if the tree is editing a node. _tree_.**isFiltered** : _boolean_ Returns true if the _searchTerm_ prop is not an empty string when trimmed. _tree_.**props** : _TreeProps_ Returns all the props that were passed to the _\<Tree\>_ component. _tree_.**root** : _NodeApi_ Returns the root _NodeApi_ instance. Its children are the Node representations of the _data_ prop array. ## Author [James Kerr](https://twitter.com/specialCaseDev) at [Brim Data](https://brimdata.io) for the [Zui desktop app](https://www.youtube.com/watch?v=I2y663n8d2A). ----------- The following npm package may be included in this product: - react-dnd@14.0.5 This package contains the following license and notice below: The MIT License (MIT) Copyright (c) 2016 Dan Abramov 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 packages may be included in this product: - react-is@19.0.0 - use-sync-external-store@1.4.0 These packages each contain the following license and notice below: MIT License Copyright (c) Meta Platforms, Inc. and 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: - react-js-cron@5.0.1 This package contains the following license and notice below: The MIT License (MIT) Copyright (c) Xavier Rutayisire 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: - react-spinners@0.13.8 This package contains the following license and notice below: The MIT License (MIT) Copyright (c) 2017 David Hu 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: - react-table@7.8.0 This package contains the following license and notice below: MIT License Copyright (c) 2016 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 package may be included in this product: - react-toastify@9.1.3 This package contains the following license and notice below: MIT License Copyright (c) 2023 Fadi Khadra 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: - react-transition-group@4.4.5 This package contains the following license and notice below: BSD 3-Clause License Copyright (c) 2018, React Community Forked from React (https://github.com/facebook/react) Copyright 2013-present, Facebook, Inc. 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: - react-window@1.8.11 This package contains the following license and notice below: The MIT License (MIT) Copyright (c) 2018 Brian Vaughn 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: - redux@4.2.1 - redux@5.0.1 These packages each contain the following license and notice below: The MIT License (MIT) Copyright (c) 2015-present Dan Abramov 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: - regenerator-runtime@0.14.1 This package contains the following license and notice below: MIT License Copyright (c) 2014-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 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: - resize-observer-polyfill@1.5.1 This package contains the following license and notice below: The MIT License (MIT) Copyright (c) 2016 Denis Rul 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: - resolve@1.22.10 This package contains the following license and notice below: MIT License Copyright (c) 2012 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: - 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: - scroll-into-view-if-needed@3.1.0 This package contains the following license and notice below: MIT License Copyright (c) 2023 Cody Olsen 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: - source-map-js@1.2.1 - source-map@0.5.7 These packages each contain 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: - string-convert@0.2.1 This package contains the following license and notice below: The MIT License (MIT) Copyright (c) 2014 Kiran Abburi 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: - stylis@4.2.0 - stylis@4.3.5 These packages each contain the following license and notice below: MIT License Copyright (c) 2016-present Sultan Tarimo 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: - supports-preserve-symlinks-flag@1.0.0 This package contains the following license and notice below: MIT License Copyright (c) 2022 Inspect JS 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: - throttle-debounce@5.0.2 This package contains the following license and notice below: Copyright (c) Ivan Nikolić <http://ivannikolic.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. --- Copyright (c) 2010 "Cowboy" Ben Alman 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: - tiny-case@1.0.3 This package contains the following license and notice below: # tiny-case Extremely minimal string casing utilities that mimic most of lodash's casing behavior, e.g. numbers are considered seperate "words". ```sh npm i tiny-case ``` ## Usage ```js import { camelCase, pascalCase, snakeCase, kebabCase, titleCase, sentenceCase, words, upperFirst, } from 'tiny-case' words('hi-there john') // ['hi', 'there', 'john'] words(' 1ApplePlease ') // ['1', 'Apple', 'Please'] ``` ----------- The following npm package may be included in this product: - toggle-selection@1.0.6 This package contains the following license and notice below: # Toggle Selection Simple module exposing function that deselects current browser selection and returns function that restores selection. ``` var deselect = require('toggle-selection'); var reselect = deselect(); // remove all selection // … // do something with current selection, text, etc; // … reselect(); // restore selection ``` All credits go to [@shvaikalesh](https://github.com/shvaikalesh). # [Example](https://github.com/sudodoki/toggle-selection/blob/master/example) ![example recording](http://g.recordit.co/YPu6mHvcKe.gif) ----------- The following npm package may be included in this product: - toposort@2.0.2 This package contains the following license and notice below: Toposort - Topological sorting for node.js Copyright (c) 2012 by Marcel Klehr <mklehr@gmx.net> 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: - 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: - type-fest@2.19.0 This package contains the following license and notice below: <div align="center"> <br> <br> <img src="media/logo.svg" alt="type-fest" height="300"> <br> <br> <b>A collection of essential TypeScript types</b> <br> <br> <br> <br> <hr> <div align="center"> <p> <p> <sup> <a href="https://github.com/sponsors/sindresorhus">Sindre Sorhus' open source work is supported by the community</a> </sup> </p> <sup>Special thanks to:</sup> <br> <br> <a href="https://standardresume.co/tech"> <img src="https://sindresorhus.com/assets/thanks/standard-resume-logo.svg" width="180"/> </a> <br> <br> <br> <a href="https://workos.com/?utm_campaign=github_repo&utm_medium=referral&utm_content=type-fest&utm_source=github"> <div> <img src="https://sindresorhus.com/assets/thanks/workos-logo-white-bg.svg" width="220" alt="WorkOS"> </div> <b>Your app, enterprise-ready.</b> <div> <sub>Start selling to enterprise customers with just a few lines of code.</sub> <br> <sup>Add Single Sign-On (and more) in minutes instead of months.</sup> </div> </a> <br> <br> <br> <a href="https://www.useanvil.com/?utm_source=sindresorhus#gh-light-mode-only"> <div> <img src="https://sindresorhus.com/assets/thanks/anvil-logo-light.svg" width="200" alt="Anvil"> </div> <br> <b>Paperwork that makes the data work.</b> <div> <sub> Easy APIs for paperwork. PDF generation, e-signature and embeddable no-code webforms. <br> The easiest way to build paperwork automation into your product. </sub> </div> </a> <a href="https://www.useanvil.com/?utm_source=sindresorhus#gh-dark-mode-only"> <div> <img src="https://sindresorhus.com/assets/thanks/anvil-logo-dark.svg" width="200" alt="Anvil"> </div> <br> <b>Paperwork that makes the data work.</b> <div> <sub> Easy APIs for paperwork. PDF generation, e-signature and embeddable no-code webforms. <br> The easiest way to build paperwork automation into your product. </sub> </div> </a> </p> </div> <br> <hr> </div> <br> <br> [![](https://img.shields.io/badge/unicorn-approved-ff69b4.svg)](https://giphy.com/gifs/illustration-rainbow-unicorn-26AHG5KGFxSkUWw1i) [![npm dependents](https://badgen.net/npm/dependents/type-fest)](https://www.npmjs.com/package/type-fest?activeTab=dependents) [![npm downloads](https://badgen.net/npm/dt/type-fest)](https://www.npmjs.com/package/type-fest) [![Docs](https://paka.dev/badges/v0/cute.svg)](https://paka.dev/npm/type-fest) Many of the types here should have been built-in. You can help by suggesting some of them to the [TypeScript project](https://github.com/Microsoft/TypeScript/blob/main/CONTRIBUTING.md). Either add this package as a dependency or copy-paste the needed types. No credit required. 👌 PR welcome for additional commonly needed types and docs improvements. Read the [contributing guidelines](.github/contributing.md) first. **Help wanted with reviewing [proposals](https://github.com/sindresorhus/type-fest/issues) and [pull requests](https://github.com/sindresorhus/type-fest/pulls).** ## Install ```sh npm install type-fest ``` *Requires TypeScript >=4.2* ## Usage ```ts import type {Except} from 'type-fest'; type Foo = { unicorn: string; rainbow: boolean; }; type FooWithoutRainbow = Except<Foo, 'rainbow'>; //=> {unicorn: string} ``` ## API Click the type names for complete docs. ### Basic - [`Primitive`](source/primitive.d.ts) - Matches any [primitive value](https://developer.mozilla.org/en-US/docs/Glossary/Primitive). - [`Class`](source/basic.d.ts) - Matches a [`class`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes). - [`Constructor`](source/basic.d.ts) - Matches a [`class` constructor](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes). - [`TypedArray`](source/typed-array.d.ts) - Matches any [typed array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray), like `Uint8Array` or `Float64Array`. - [`ObservableLike`](source/observable-like.d.ts) - Matches a value that is like an [Observable](https://github.com/tc39/proposal-observable). ### Utilities - [`Except`](source/except.d.ts) - Create a type from an object type without certain keys. This is a stricter version of [`Omit`](https://www.typescriptlang.org/docs/handbook/utility-types.html#omittype-keys). - [`Writable`](source/writable.d.ts) - Create a type that strips `readonly` from all or some of an object's keys. The inverse of `Readonly<T>`. Formerly named `Mutable`. - [`Merge`](source/merge.d.ts) - Merge two types into a new type. Keys of the second type overrides keys of the first type. - [`MergeExclusive`](source/merge-exclusive.d.ts) - Create a type that has mutually exclusive keys. - [`RequireAtLeastOne`](source/require-at-least-one.d.ts) - Create a type that requires at least one of the given keys. - [`RequireExactlyOne`](source/require-exactly-one.d.ts) - Create a type that requires exactly a single key of the given keys and disallows more. - [`RequireAllOrNone`](source/require-all-or-none.d.ts) - Create a type that requires all of the given keys or none of the given keys. - [`RemoveIndexSignature`](source/remove-index-signature.d.ts) - Create a type that only has explicitly defined properties, absent of any index signatures. - [`PartialDeep`](source/partial-deep.d.ts) - Create a deeply optional version of another type. Use [`Partial<T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#partialtype) if you only need one level deep. - [`PartialOnUndefinedDeep`](source/partial-on-undefined-deep.d.ts) - Create a deep version of another type where all keys accepting `undefined` type are set to optional. - [`ReadonlyDeep`](source/readonly-deep.d.ts) - Create a deeply immutable version of an `object`/`Map`/`Set`/`Array` type. Use [`Readonly<T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#readonlytype) if you only need one level deep. - [`LiteralUnion`](source/literal-union.d.ts) - Create a union type by combining primitive types and literal types without sacrificing auto-completion in IDEs for the literal type part of the union. Workaround for [Microsoft/TypeScript#29729](https://github.com/Microsoft/TypeScript/issues/29729). - [`Opaque`](source/opaque.d.ts) - Create an [opaque type](https://codemix.com/opaque-types-in-javascript/). - [`UnwrapOpaque`](source/opaque.d.ts) - Revert an [opaque type](https://codemix.com/opaque-types-in-javascript/) back to its original type. - [`InvariantOf`](source/invariant-of.d.ts) - Create an [invariant type](https://basarat.gitbook.io/typescript/type-system/type-compatibility#footnote-invariance), which is a type that does not accept supertypes and subtypes. - [`SetOptional`](source/set-optional.d.ts) - Create a type that makes the given keys optional. - [`SetRequired`](source/set-required.d.ts) - Create a type that makes the given keys required. - [`SetNonNullable`](source/set-non-nullable.d.ts) - Create a type that makes the given keys non-nullable. - [`ValueOf`](source/value-of.d.ts) - Create a union of the given object's values, and optionally specify which keys to get the values from. - [`ConditionalKeys`](source/conditional-keys.d.ts) - Extract keys from a shape where values extend the given `Condition` type. - [`ConditionalPick`](source/conditional-pick.d.ts) - Like `Pick` except it selects properties from a shape where the values extend the given `Condition` type. - [`ConditionalExcept`](source/conditional-except.d.ts) - Like `Omit` except it removes properties from a shape where the values extend the given `Condition` type. - [`UnionToIntersection`](source/union-to-intersection.d.ts) - Convert a union type to an intersection type. - [`LiteralToPrimitive`](source/literal-to-primitive.d.ts) - Convert a [literal type](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#literal-types) to the [primitive type](source/primitive.d.ts) it belongs to. - [`Stringified`](source/stringified.d.ts) - Create a type with the keys of the given type changed to `string` type. - [`IterableElement`](source/iterable-element.d.ts) - Get the element type of an `Iterable`/`AsyncIterable`. For example, an array or a generator. - [`Entry`](source/entry.d.ts) - Create a type that represents the type of an entry of a collection. - [`Entries`](source/entries.d.ts) - Create a type that represents the type of the entries of a collection. - [`SetReturnType`](source/set-return-type.d.ts) - Create a function type with a return type of your choice and the same parameters as the given function type. - [`Simplify`](source/simplify.d.ts) - Useful to flatten the type output to improve type hints shown in editors. And also to transform an interface into a type to aide with assignability. - [`Get`](source/get.d.ts) - Get a deeply-nested property from an object using a key path, like [Lodash's `.get()`](https://lodash.com/docs/latest#get) function. - [`StringKeyOf`](source/string-key-of.d.ts) - Get keys of the given type as strings. - [`Schema`](source/schema.d.ts) - Create a deep version of another object type where property values are recursively replaced into a given value type. - [`Exact`](source/exact.d.ts) - Create a type that does not allow extra properties. - [`OptionalKeysOf`](source/optional-keys-of.d.ts) - Extract all optional keys from the given type. - [`HasOptionalKeys`](source/has-optional-keys.d.ts) - Create a `true`/`false` type depending on whether the given type has any optional fields. - [`RequiredKeysOf`](source/required-keys-of.d.ts) - Extract all required keys from the given type. - [`HasRequiredKeys`](source/has-required-keys.d.ts) - Create a `true`/`false` type depending on whether the given type has any required fields. - [`Spread`](source/spread.d.ts) - Mimic the type inferred by TypeScript when merging two objects or two arrays/tuples using the spread syntax. ### JSON - [`Jsonify`](source/jsonify.d.ts) - Transform a type to one that is assignable to the `JsonValue` type. - [`JsonPrimitive`](source/basic.d.ts) - Matches a JSON primitive. - [`JsonObject`](source/basic.d.ts) - Matches a JSON object. - [`JsonArray`](source/basic.d.ts) - Matches a JSON array. - [`JsonValue`](source/basic.d.ts) - Matches any valid JSON value. ### Async - [`Promisable`](source/promisable.d.ts) - Create a type that represents either the value or the value wrapped in `PromiseLike`. - [`AsyncReturnType`](source/async-return-type.d.ts) - Unwrap the return type of a function that returns a `Promise`. - [`Asyncify`](source/asyncify.d.ts) - Create an async version of the given function type. ### String - [`Trim`](source/trim.d.ts) - Remove leading and trailing spaces from a string. - [`Split`](source/split.d.ts) - Represents an array of strings split using a given character or character set. - [`Replace`](source/replace.d.ts) - Represents a string with some or all matches replaced by a replacement. ### Array - [`Includes`](source/includes.d.ts) - Returns a boolean for whether the given array includes the given item. - [`Join`](source/join.d.ts) - Join an array of strings and/or numbers using the given string as a delimiter. - [`LastArrayElement`](source/last-array-element.d.ts) - Extracts the type of the last element of an array. - [`FixedLengthArray`](source/fixed-length-array.d.ts) - Create a type that represents an array of the given type and length. - [`MultidimensionalArray`](source/multidimensional-array.d.ts) - Create a type that represents a multidimensional array of the given type and dimensions. - [`MultidimensionalReadonlyArray`](source/multidimensional-readonly-array.d.ts) - Create a type that represents a multidimensional readonly array of the given type and dimensions. - [`ReadonlyTuple`](source/readonly-tuple.d.ts) - Create a type that represents a read-only tuple of the given type and length. ### Numeric - [`PositiveInfinity`](source/numeric.d.ts) - Matches the hidden `Infinity` type. - [`NegativeInfinity`](source/numeric.d.ts) - Matches the hidden `-Infinity` type. - [`Finite`](source/numeric.d.ts) - A finite `number`. - [`Integer`](source/numeric.d.ts) - A `number` that is an integer. - [`Float`](source/numeric.d.ts) - A `number` that is not an integer. - [`NegativeFloat`](source/numeric.d.ts) - A negative (`-∞ < x < 0`) `number` that is not an integer. - [`Negative`](source/numeric.d.ts) - A negative `number`/`bigint` (`-∞ < x < 0`) - [`NonNegative`](source/numeric.d.ts) - A non-negative `number`/`bigint` (`0 <= x < ∞`). - [`NegativeInteger`](source/numeric.d.ts) - A negative (`-∞ < x < 0`) `number` that is an integer. - [`NonNegativeInteger`](source/numeric.d.ts) - A non-negative (`0 <= x < ∞`) `number` that is an integer. ### Change case - [`CamelCase`](source/camel-case.d.ts) - Convert a string literal to camel-case (`fooBar`). - [`CamelCasedProperties`](source/camel-cased-properties.d.ts) - Convert object properties to camel-case (`fooBar`). - [`CamelCasedPropertiesDeep`](source/camel-cased-properties-deep.d.ts) - Convert object properties to camel-case recursively (`fooBar`). - [`KebabCase`](source/kebab-case.d.ts) - Convert a string literal to kebab-case (`foo-bar`). - [`KebabCasedProperties`](source/kebab-cased-properties.d.ts) - Convert a object properties to kebab-case recursively (`foo-bar`). - [`KebabCasedPropertiesDeep`](source/kebab-cased-properties-deep.d.ts) - Convert object properties to kebab-case (`foo-bar`). - [`PascalCase`](source/pascal-case.d.ts) - Converts a string literal to pascal-case (`FooBar`) - [`PascalCasedProperties`](source/pascal-cased-properties.d.ts) - Converts object properties to pascal-case (`FooBar`) - [`PascalCasedPropertiesDeep`](source/pascal-cased-properties-deep.d.ts) - Converts object properties to pascal-case (`FooBar`) - [`SnakeCase`](source/snake-case.d.ts) - Convert a string literal to snake-case (`foo_bar`). - [`SnakeCasedProperties`](source/snake-cased-properties-deep.d.ts) - Convert object properties to snake-case (`foo_bar`). - [`SnakeCasedPropertiesDeep`](source/snake-cased-properties-deep.d.ts) - Convert object properties to snake-case recursively (`foo_bar`). - [`ScreamingSnakeCase`](source/screaming-snake-case.d.ts) - Convert a string literal to screaming-snake-case (`FOO_BAR`). - [`DelimiterCase`](source/delimiter-case.d.ts) - Convert a string literal to a custom string delimiter casing. - [`DelimiterCasedProperties`](source/delimiter-cased-properties.d.ts) - Convert object properties to a custom string delimiter casing. - [`DelimiterCasedPropertiesDeep`](source/delimiter-cased-properties-deep.d.ts) - Convert object properties to a custom string delimiter casing recursively. ### Miscellaneous - [`PackageJson`](source/package-json.d.ts) - Type for [npm's `package.json` file](https://docs.npmjs.com/creating-a-package-json-file). It also includes support for [TypeScript Declaration Files](https://www.typescriptlang.org/docs/handbook/declaration-files/publishing.html) and [Yarn Workspaces](https://classic.yarnpkg.com/lang/en/docs/workspaces/). - [`TsConfigJson`](source/tsconfig-json.d.ts) - Type for [TypeScript's `tsconfig.json` file](https://www.typescriptlang.org/docs/handbook/tsconfig-json.html) (TypeScript 4.4). ## Declined types *If we decline a type addition, we will make sure to document the better solution here.* - [`Diff` and `Spread`](https://github.com/sindresorhus/type-fest/pull/7) - The pull request author didn't provide any real-world use-cases and the PR went stale. If you think this type is useful, provide some real-world use-cases and we might reconsider. - [`Dictionary`](https://github.com/sindresorhus/type-fest/issues/33) - You only save a few characters (`Dictionary<number>` vs `Record<string, number>`) from [`Record`](https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type), which is more flexible and well-known. Also, you shouldn't use an object as a dictionary. We have `Map` in JavaScript now. - [`ExtractProperties` and `ExtractMethods`](https://github.com/sindresorhus/type-fest/pull/4) - The types violate the single responsibility principle. Instead, refine your types into more granular type hierarchies. - [`Url2Json`](https://github.com/sindresorhus/type-fest/pull/262) - Inferring search parameters from a URL string is a cute idea, but not very useful in practice, since search parameters are usually dynamic and defined separately. - [`Nullish`](https://github.com/sindresorhus/type-fest/pull/318) - The type only saves a couple of characters, not everyone knows what "nullish" means, and I'm also trying to [get away from `null`](https://github.com/sindresorhus/meta/discussions/7). - [`TitleCase`](https://github.com/sindresorhus/type-fest/pull/303) - It's not solving a common need and is a better fit for a separate package. - [`ExtendOr` and `ExtendAnd`](https://github.com/sindresorhus/type-fest/pull/247) - The benefits don't outweigh having to learn what they mean. - [`PackageJsonExtras`](https://github.com/sindresorhus/type-fest/issues/371) - There are too many possible configurations that can be put into `package.json`. If you would like to extend `PackageJson` to support an additional configuration in your project, please see the *Extending existing types* section below. ## Alternative type names *If you know one of our types by a different name, add it here for discovery.* - `PartialBy` - See [`SetOptional`](https://github.com/sindresorhus/type-fest/blob/main/source/set-optional.d.ts) - `RecordDeep`- See [`Schema`](https://github.com/sindresorhus/type-fest/blob/main/source/schema.d.ts) ## Tips ### Extending existing types - [`PackageJson`](source/package-json.d.ts) - There are a lot of tools that place extra configurations inside the `package.json` file. You can extend `PackageJson` to support these additional configurations. <details> <summary> Example </summary> [Playground](https://www.typescriptlang.org/play?#code/JYWwDg9gTgLgBDAnmApnA3gBQIYGMDW2A5igFIDOEAdnNuXAEJ0o4HFmVUC+cAZlBBBwA5ElQBaXinIxhAbgCwAKFCRYCZGnQAZYFRgooPfoJHSANntmKlysWlaESFanAC8jZo-YuaAMgwLKwBhal5gIgB+AC44XX1DADpQqnCiLhsgA) ```ts import type {PackageJson as BasePackageJson} from 'type-fest'; import type {Linter} from 'eslint'; type PackageJson = BasePackageJson & {eslintConfig?: Linter.Config}; ``` </details> ### Related - [typed-query-selector](https://github.com/g-plane/typed-query-selector) - Enhances `document.querySelector` and `document.querySelectorAll` with a template literal type that matches element types returned from an HTML element query selector. - [`Linter.Config`](https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/eslint/index.d.ts) - Definitions for the [ESLint configuration schema](https://eslint.org/docs/user-guide/configuring/language-options). ### Built-in types There are many advanced types most users don't know about. - [`Partial<T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#partialtype) - Make all properties in `T` optional. <details> <summary> Example </summary> [Playground](https://www.typescriptlang.org/play/#code/JYOwLgpgTgZghgYwgAgHIHsAmEDC6QzADmyA3gLABQyycADnanALYQBcyAzmFKEQNxUaddFDAcQAV2YAjaIMoBfKlQQAbOJ05osEAIIMAQpOBrsUMkOR1eANziRkCfISKSoD4Pg4ZseAsTIALyW1DS0DEysHADkvvoMMQA0VsKi4sgAzAAMuVaKClY2wPaOknSYDrguADwA0sgQAB6QIJjaANYQAJ7oMDp+LsQAfAAUXd0cdUnI9mo+uv6uANp1ALoAlKHhyGAAFsCcAHTOAW4eYF4gyxNrwbNwago0ypRWp66jH8QcAApwYmAjxq8SWIy2FDCNDA3ToKFBQyIdR69wmfQG1TOhShyBgomQX3w3GQE2Q6IA8jIAFYQBBgI4TTiEs5bTQYsFInrLTbbHZOIlgZDlSqQABqj0kKBC3yINx6a2xfOQwH6o2FVXFaklwSCIUkbQghBAEEwENSfNOlykEGefNe5uhB2O6sgS3GPRmLogmslG1tLxUOKgEDA7hAuydtteryAA) ```ts interface NodeConfig { appName: string; port: number; } class NodeAppBuilder { private configuration: NodeConfig = { appName: 'NodeApp', port: 3000 }; private updateConfig<Key extends keyof NodeConfig>(key: Key, value: NodeConfig[Key]) { this.configuration[key] = value; } config(config: Partial<NodeConfig>) { type NodeConfigKey = keyof NodeConfig; for (const key of Object.keys(config) as NodeConfigKey[]) { const updateValue = config[key]; if (updateValue === undefined) { continue; } this.updateConfig(key, updateValue); } return this; } } // `Partial<NodeConfig>`` allows us to provide only a part of the // NodeConfig interface. new NodeAppBuilder().config({appName: 'ToDoApp'}); ``` </details> - [`Required<T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#requiredtype) - Make all properties in `T` required. <details> <summary> Example </summary> [Playground](https://typescript-play.js.org/?target=6#code/AQ4SwOwFwUwJwGYEMDGNgGED21VQGJZwC2wA3gFCjXAzFJgA2A-AFzADOUckA5gNxUaIYjA4ckvGG07c+g6gF8KQkAgCuEFFDA5O6gEbEwUbLm2ESwABQIixACJIoSdgCUYAR3Vg4MACYAPGYuFvYAfACU5Ko0APRxwADKMBD+wFAAFuh2Vv7OSBlYGdmc8ABu8LHKsRyGxqY4oQT21pTCIHQMjOwA5DAAHgACxAAOjDAAdChYxL0ANLHUouKSMH0AEmAAhJhY6ozpAJ77GTCMjMCiV0ToSAb7UJPPC9WRgrEJwAAqR6MwSRQPFGUFocDgRHYxnEfGAowh-zgUCOwF6KwkUl6tXqJhCeEsxDaS1AXSYfUGI3GUxmc0WSneQA) ```ts interface ContactForm { email?: string; message?: string; } function submitContactForm(formData: Required<ContactForm>) { // Send the form data to the server. } submitContactForm({ email: 'ex@mple.com', message: 'Hi! Could you tell me more about…', }); // TypeScript error: missing property 'message' submitContactForm({ email: 'ex@mple.com', }); ``` </details> - [`Readonly<T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#readonlytype) - Make all properties in `T` readonly. <details> <summary> Example </summary> [Playground](https://typescript-play.js.org/?target=6#code/AQ4UwOwVwW2AZA9gc3mAbmANsA3gKFCOAHkAzMgGkOJABEwAjKZa2kAUQCcvEu32AMQCGAF2FYBIAL4BufDRABLCKLBcywgMZgEKZOoDCiCGSXI8i4hGEwwALmABnUVxXJ57YFgzZHSVF8sT1BpBSItLGEnJz1kAy5LLy0TM2RHACUwYQATEywATwAeAITjU3MAPnkrCJMXLigtUT4AClxgGztKbyDgaX99I1TzAEokr1BRAAslJwA6FIqLAF48TtswHp9MHDla9hJGACswZvmyLjAwAC8wVpm5xZHkUZDaMKIwqyWXYCW0oN4sNlsA1h0ug5gAByACyBQAggAHJHQ7ZBIFoXbzBjMCz7OoQP5YIaJNYQMAAdziCVaALGNSIAHomcAACoFJFgADKWjcSNEwG4vC4ji0wggEEQguiTnMEGALWAV1yAFp8gVgEjeFyuKICvMrCTgVxnst5jtsGC4ljsPNhXxGaAWcAAOq6YRXYDCRg+RWIcA5JSC+kWdCepQ+v3RYCU3RInzRMCGwlpC19NYBW1Ye08R1AA) ```ts enum LogLevel { Off, Debug, Error, Fatal }; interface LoggerConfig { name: string; level: LogLevel; } class Logger { config: Readonly<LoggerConfig>; constructor({name, level}: LoggerConfig) { this.config = {name, level}; Object.freeze(this.config); } } const config: LoggerConfig = { name: 'MyApp', level: LogLevel.Debug }; const logger = new Logger(config); // TypeScript Error: cannot assign to read-only property. logger.config.level = LogLevel.Error; // We are able to edit config variable as we please. config.level = LogLevel.Error; ``` </details> - [`Pick<T, K>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#picktype-keys) - From `T`, pick a set of properties whose keys are in the union `K`. <details> <summary> Example </summary> [Playground](https://typescript-play.js.org/?target=6#code/AQ4SwOwFwUwJwGYEMDGNgEE5TCgNugN4BQoZwOUBAXMAM5RyQDmA3KeSFABYCuAtgCMISMHloMmENh04oA9tBjQJjFuzIBfYrOAB6PcADCcGElh1gEGAHcKATwAO6ebyjB5CTNlwFwSxFR0BX5HeToYABNgBDh5fm8cfBg6AHIKG3ldA2BHOOcfFNpUygJ0pAhokr4hETFUgDpswywkggAFUwA3MFtgAF5gQgowKhhVKTYKGuFRcXo1aVZgbTIoJ3RW3xhOmB6+wfbcAGsAHi3kgBpgEtGy4AAfG54BWfqAPnZm4AAlZUj4MAkMA8GAGB4vEgfMlLLw6CwPBA8PYRmMgZVgAC6CgmI4cIommQELwICh8RBgKZKvALh1ur0bHQABR5PYMui0Wk7em2ADaAF0AJS0AASABUALIAGQAogR+Mp3CROCAFBBwVC2ikBpj5CgBIqGjizLA5TAFdAmalImAuqlBRoVQh5HBgEy1eDWfs7J5cjzGYKhroVfpDEhHM4MV6GRR5NN0JrtnRg6BVirTFBeHAKYmYY6QNpdB73LmCJZBlSAXAubtvczeSmQMNSuMbmKNgBlHFgPEUNwusBIPAAQlS1xetTmxT0SDoESgdD0C4aACtHMwxytLrohawgA) ```ts interface Article { title: string; thumbnail: string; content: string; } // Creates new type out of the `Article` interface composed // from the Articles' two properties: `title` and `thumbnail`. // `ArticlePreview = {title: string; thumbnail: string}` type ArticlePreview = Pick<Article, 'title' | 'thumbnail'>; // Render a list of articles using only title and description. function renderArticlePreviews(previews: ArticlePreview[]): HTMLElement { const articles = document.createElement('div'); for (const preview of previews) { // Append preview to the articles. } return articles; } const articles = renderArticlePreviews([ { title: 'TypeScript tutorial!', thumbnail: '/assets/ts.jpg' } ]); ``` </details> - [`Record<K, T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type) - Construct a type with a set of properties `K` of type `T`. <details> <summary> Example </summary> [Playground](https://typescript-play.js.org/?target=6#code/AQ4ejYAUHsGcCWAXBMB2dgwGbAKYC2ADgDYwCeeemCaWArgE7ADGMxAhmuQHQBQoYEnJE8wALKEARnkaxEKdMAC8wAOS0kstGuAAfdQBM8ANzxlRjXQbVaWACwC0JPB0NqA3HwGgIwAJJoWozYHCxixnAsjAhStADmwESMMJYo1Fi4HMCIaPEu+MRklHj8gpqyoeHAAKJFFFTAAN4+giDYCIxwSAByHAR4AFw5SDF5Xm2gJBzdfQPD3WPxE5PAlBxdAPLYNQAelgh4aOHDaPQEMowrIAC+3oJ+AMKMrlrAXFhSAFZ4LEhC9g4-0BmA4JBISXgiCkBQABpILrJ5MhUGhYcATGD6Bk4Hh-jNgABrPDkOBlXyQAAq9ngYmJpOAAHcEOCRjAXqwYODfoo6DhakUSph+Uh7GI4P0xER4Cj0OSQGwMP8tP1hgAlX7swwAHgRl2RvIANALSA08ABtAC6AD4VM1Wm0Kow0MMrYaHYJjGYLLJXZb3at1HYnC43Go-QHQDcvA6-JsmEJXARgCDgMYWAhjIYhDAU+YiMAAFIwex0ZmilMITCGF79TLAGRsAgJYAAZRwSEZGzEABFTOZUrJ5Yn+jwnWgeER6HB7AAKJrADpdXqS4ZqYultTG6azVfqHswPBbtauLY7fayQ7HIbAAAMwBuAEoYw9IBq2Ixs9h2eFMOQYPQObALQKJgggABeYhghCIpikkKRpOQRIknAsZUiIeCttECBEP8NSMCkjDDAARMGziuIYxHwYOjDCMBmDNnAuTxA6irdCOBB1Lh5Dqpqn66tISIykawBnOCtqqC0gbjqc9DgpGkxegOliyfJDrRkAA) ```ts // Positions of employees in our company. type MemberPosition = 'intern' | 'developer' | 'tech-lead'; // Interface describing properties of a single employee. interface Employee { firstName: string; lastName: string; yearsOfExperience: number; } // Create an object that has all possible `MemberPosition` values set as keys. // Those keys will store a collection of Employees of the same position. const team: Record<MemberPosition, Employee[]> = { intern: [], developer: [], 'tech-lead': [], }; // Our team has decided to help John with his dream of becoming Software Developer. team.intern.push({ firstName: 'John', lastName: 'Doe', yearsOfExperience: 0 }); // `Record` forces you to initialize all of the property keys. // TypeScript Error: "tech-lead" property is missing const teamEmpty: Record<MemberPosition, null> = { intern: null, developer: null, }; ``` </details> - [`Exclude<T, U>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#excludetype-excludedunion) - Exclude from `T` those types that are assignable to `U`. <details> <summary> Example </summary> [Playground](https://typescript-play.js.org/?target=6#code/JYOwLgpgTgZghgYwgAgMrQG7QMIHsQzADmyA3gFDLIAOuUYAXMiAK4A2byAPsgM5hRQJHqwC2AI2gBucgF9y5MAE9qKAEoQAjiwj8AEnBAATNtGQBeZAAooWphu26wAGmS3e93bRC8IASgsAPmRDJRlyAHoI5ABRAA8ENhYjFFYOZGVVZBgoXFFkAAM0zh5+QRBhZhYJaAKAOkjogEkQZAQ4X2QAdwALCFbaemRgXmQtFjhOMFwq9K6ULuB0lk6U+HYwZAxJnQaYFhAEMGB8ZCIIMAAFOjAANR2IK0HGWISklIAedCgsKDwCYgAbQA5M9gQBdVzFQJ+JhiSRQMiUYYwayZCC4VHPCzmSzAspCYEBWxgFhQAZwKC+FpgJ43VwARgADH4ZFQSWSBjcZPJyPtDsdTvxKWBvr8rD1DCZoJ5HPopaYoK4EPhCEQmGKcKriLCtrhgEYkVQVT5Nr4fmZLLZtMBbFZgT0wGBqES6ghbHBIJqoBKFdBWQpjfh+DQbhY2tqiHVsbjLMVkAB+ZAAZiZaeQTHOVxu9ySjxNaujNwDVHNvzqbBGkBAdPoAfkQA) ```ts interface ServerConfig { port: null | string | number; } type RequestHandler = (request: Request, response: Response) => void; // Exclude `null` type from `null | string | number`. // In case the port is equal to `null`, we will use default value. function getPortValue(port: Exclude<ServerConfig['port'], null>): number { if (typeof port === 'string') { return parseInt(port, 10); } return port; } function startServer(handler: RequestHandler, config: ServerConfig): void { const server = require('http').createServer(handler); const port = config.port === null ? 3000 : getPortValue(config.port); server.listen(port); } ``` </details> - [`Extract<T, U>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#extracttype-union) - Extract from `T` those types that are assignable to `U`. <details> <summary> Example </summary> [Playground](https://typescript-play.js.org/?target=6#code/CYUwxgNghgTiAEAzArgOzAFwJYHtXzSwEdkQBJYACgEoAueVZAWwCMQYBuAKDDwGcM8MgBF4AXngBlAJ6scESgHIRi6ty5ZUGdoihgEABXZ888AN5d48ANoiAuvUat23K6ihMQ9ATE0BzV3goPy8GZjZOLgBfLi4Aejj4AEEICBwAdz54MAALKFQQ+BxEeAAHY1NgKAwoIKy0grr4DByEUpgccpgMaXgAaxBerCzi+B9-ZulygDouFHRsU1z8kKMYE1RhaqgAHkt4AHkWACt4EAAPbVRgLLWNgBp9gGlBs8uQa6yAUUuYPQwdgNpKM7nh7mMML4CgA+R5WABqUAgpDeVxuhxO1he0jsXGh8EoOBO9COx3BQPo2PBADckaR6IjkSA6PBqTgsMBzPsicdrEC7OJWXSQNwYvFEgAVTS9JLXODpeDpKBZFg4GCoWa8VACIJykAKiQWKy2YQOAioYikCg0OEMDyhRSy4DyxS24KhAAMjyi6gS8AAwjh5OD0iBFHAkJoEOksC1mnkMJq8gUQKDNttKPlnfrwYp3J5XfBHXqoKpfYkAOI4ansTxaeDADmoRSCCBYAbxhC6TDx6rwYHIRX5bScjA4bLJwoDmDwDkfbA9JMrVMVdM1TN69LgkTgwgkchUahqIA) ```ts declare function uniqueId(): number; const ID = Symbol('ID'); interface Person { [ID]: number; name: string; age: number; } // Allows changing the person data as long as the property key is of string type. function changePersonData< Obj extends Person, Key extends Extract<keyof Person, string>, Value extends Obj[Key] > (obj: Obj, key: Key, value: Value): void { obj[key] = value; } // Tiny Andrew was born. const andrew = { [ID]: uniqueId(), name: 'Andrew', age: 0, }; // Cool, we're fine with that. changePersonData(andrew, 'name', 'Pony'); // Goverment didn't like the fact that you wanted to change your identity. changePersonData(andrew, ID, uniqueId()); ``` </details> - [`NonNullable<T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#nonnullabletype) - Exclude `null` and `undefined` from `T`. <details> <summary> Example </summary> Works with <a href="https://www.typescriptlang.org/tsconfig#strictNullChecks"><code>strictNullChecks</code></a> set to <code>true</code>. [Playground](https://typescript-play.js.org/?target=6#code/C4TwDgpgBACg9gJ2AOQK4FsBGEFQLxQDOwCAlgHYDmUAPlORtrnQwDasDcAUFwPQBU-WAEMkUOADMowqAGNWwwoSgATCBIqlgpOOSjAAFsOBRSy1IQgr9cKJlSlW1mZYQA3HFH68u8xcoBlHA8EACEHJ08Aby4oKDBUTFZSWXjEFEYcAEIALihkXTR2YSSIAB54JDQsHAA+blj4xOTUsHSACkMzPKD3HHDHNQQAGjSkPMqMmoQASh7g-oihqBi4uNIpdraxPAI2VhmVxrX9AzMAOm2ppnwoAA4ABifuE4BfKAhWSyOTuK7CS7pao3AhXF5rV48E4ICDAVAIPT-cGQyG+XTEIgLMJLTx7CAAdygvRCA0iCHaMwarhJOIQjUBSHaACJHk8mYdeLwxtdcVAAOSsh58+lXdr7Dlcq7A3n3J4PEUdADMcspUE53OluAIUGVTx46oAKuAIAFZGQwCYAKIIBCILjUxaDHAMnla+iodjcIA) ```ts type PortNumber = string | number | null; /** Part of a class definition that is used to build a server */ class ServerBuilder { portNumber!: NonNullable<PortNumber>; port(this: ServerBuilder, port: PortNumber): ServerBuilder { if (port == null) { this.portNumber = 8000; } else { this.portNumber = port; } return this; } } const serverBuilder = new ServerBuilder(); serverBuilder .port('8000') // portNumber = '8000' .port(null) // portNumber = 8000 .port(3000); // portNumber = 3000 // TypeScript error serverBuilder.portNumber = null; ``` </details> - [`Parameters<T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#parameterstype) - Obtain the parameters of a function type in a tuple. <details> <summary> Example </summary> [Playground](https://typescript-play.js.org/?target=6#code/GYVwdgxgLglg9mABAZwBYmMANgUwBQxgAOIUAXIgIZgCeA2gLoCUFAbnDACaIDeAUIkQB6IYgCypSlBxUATrMo1ECsJzgBbLEoipqAc0J7EMKMgDkiHLnU4wp46pwAPHMgB0fAL58+oSLARECEosLAA5ABUYG2QAHgAxJGdpVWREPDdMylk9ZApqemZEAF4APipacrw-CApEgBogkKwAYThwckQwEHUAIxxZJl4BYVEImiIZKF0oZRwiWVdbeygJmThgOYgcGFYcbhqApCJsyhtpWXcR1cnEePBoeDAABVPzgbTixFeFd8uEsClADcIxGiygIFkSEOT3SmTc2VydQeRx+ZxwF2QQ34gkEwDgsnSuFmMBKiAADEDjIhYk1Qm0OlSYABqZnYka4xA1DJZHJYkGc7yCbyeRA+CAIZCzNAYbA4CIAdxg2zJwVCkWirjwMswuEaACYmCCgA) ```ts function shuffle(input: any[]): void { // Mutate array randomly changing its' elements indexes. } function callNTimes<Fn extends (...args: any[]) => any> (func: Fn, callCount: number) { // Type that represents the type of the received function parameters. type FunctionParameters = Parameters<Fn>; return function (...args: FunctionParameters) { for (let i = 0; i < callCount; i++) { func(...args); } } } const shuffleTwice = callNTimes(shuffle, 2); ``` </details> - [`ConstructorParameters<T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#constructorparameterstype) - Obtain the parameters of a constructor function type in a tuple. <details> <summary> Example </summary> [Playground](https://typescript-play.js.org/?target=6#code/MYGwhgzhAECCBOAXAlqApgWQPYBM0mgG8AoaaFRENALmgkXmQDsBzAblOmCycTV4D8teo1YdO3JiICuwRFngAKClWENmLAJRFOZRAAtkEAHQq00ALzlklNBzIBfYk+KhIMAJJTEYJsDQAwmDA+mgAPAAq0GgAHnxMODCKTGgA7tCKxllg8CwQtL4AngDaALraFgB80EWa1SRkAA6MAG5gfNAB4FABPDJyCrQR9tDNyG0dwMGhtBhgjWEiGgA00F70vv4RhY3hEZXVVinpc42KmuJkkv3y8Bly8EPaDWTkhiZd7r3e8LK3llwGCMXGQWGhEOsfH5zJlsrl8p0+gw-goAAo5MAAW3BaHgEEilU0tEhmzQ212BJ0ry4SOg+kg+gBBiMximIGA0nAfAQLGk2N4EAAEgzYcYcnkLsRdDTvNEYkYUKwSdCme9WdM0MYwYhFPSIPpJdTkAAzDKxBUaZX+aAAQgsVmkCTQxuYaBw2ng4Ok8CYcotSu8pMur09iG9vuObxZnx6SN+AyUWTF8MN0CcZE4Ywm5jZHK5aB5fP4iCFIqT4oRRTKRLo6lYVNeAHpG50wOzOe1zHr9NLQ+HoABybsD4HOKXXRA1JCoKhBELmI5pNaB6Fz0KKBAodDYPAgSUTmqYsAALx4m5nC6nW9nGq14KtaEUA9gR9PvuNCjQ9BgACNvcwNBtAcLiAA) ```ts class ArticleModel { title: string; content?: string; constructor(title: string) { this.title = title; } } class InstanceCache<T extends (new (...args: any[]) => any)> { private ClassConstructor: T; private cache: Map<string, InstanceType<T>> = new Map(); constructor (ctr: T) { this.ClassConstructor = ctr; } getInstance (...args: ConstructorParameters<T>): InstanceType<T> { const hash = this.calculateArgumentsHash(...args); const existingInstance = this.cache.get(hash); if (existingInstance !== undefined) { return existingInstance; } return new this.ClassConstructor(...args); } private calculateArgumentsHash(...args: any[]): string { // Calculate hash. return 'hash'; } } const articleCache = new InstanceCache(ArticleModel); const amazonArticle = articleCache.getInstance('Amazon forests burining!'); ``` </details> - [`ReturnType<T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#returntypetype) - Obtain the return type of a function type. <details> <summary> Example </summary> [Playground](https://typescript-play.js.org/?target=6#code/MYGwhgzhAECSAmICmBlJAnAbgS2E6A3gFDTTwD2AcuQC4AW2AdgOYAUAlAFzSbnbyEAvkWFFQkGJSQB3GMVI1sNZNwg10TZgG4S0YOUY0kh1es07d+xmvQBXYDXLpWi5UlMaWAGj0GjJ6BtNdkJdBQYIADpXZGgAXmgYpB1ScOwoq38aeN9DYxoU6GFRKzVoJjUwRjwAYXJbPPRuAFkwAAcAHgAxBodsAx9GWwBbACMMAD4cxhloVraOCyYjdAAzMDxoOut1e0d0UNIZ6WhWSPOwdGYIbiqATwBtAF0uaHudUQB6ACpv6ABpJBINqJdAbADW0Do5BOw3u5R2VTwMHIq2gAANtjZ0bkbHsnFCwJh8ONjHp0EgwEZ4JFoN9PkRVr1FAZoMwkDRYIjqkgOrosepoEgAB7+eAwAV2BxOLy6ACCVxgIrFEoMeOl6AACpcwMMORgIB1JRMiBNWKVdhruJKfOdIpdrtwFddXlzKjyACp3Nq842HaDIbL6BrZBIVGhIpB1EMYSLsmjmtWW-YhAA+qegAAYLKQLQj3ZsEsdccmnGcLor2Dn8xGedHGpEIBzEzspfsfMHDNAANTQACMVaIljV5GQkRA5DYmIpVKQAgAJARO9le33BDXIyi0YuLW2nJFGLqkOvxFB0YPdBSaLZ0IwNzyPkO8-xkGgsLh8Al427a3hWAhXwwHA8EHT5PmgAB1bAQBAANJ24adKWpft72RaBUTgRBUCAj89HAM8xCTaBjggABRQx0DuHJv25P9dCkWRZVIAAiBjoFImpmjlFBgA0NpsjadByDacgIDAEAIAAQmYpjoGYgAZSBsmGPw6DtZiiFA8CoJguDmAQmoZ2QvtUKQLdoAYmBTwgdEiCAA) ```ts /** Provides every element of the iterable `iter` into the `callback` function and stores the results in an array. */ function mapIter< Elem, Func extends (elem: Elem) => any, Ret extends ReturnType<Func> >(iter: Iterable<Elem>, callback: Func): Ret[] { const mapped: Ret[] = []; for (const elem of iter) { mapped.push(callback(elem)); } return mapped; } const setObject: Set<string> = new Set(); const mapObject: Map<number, string> = new Map(); mapIter(setObject, (value: string) => value.indexOf('Foo')); // number[] mapIter(mapObject, ([key, value]: [number, string]) => { return key % 2 === 0 ? value : 'Odd'; }); // string[] ``` </details> - [`InstanceType<T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#instancetypetype) - Obtain the instance type of a constructor function type. <details> <summary> Example </summary> [Playground](https://typescript-play.js.org/?target=6#code/MYGwhgzhAECSAmICmBlJAnAbgS2E6A3gFDTTwD2AcuQC4AW2AdgOYAUAlAFzSbnbyEAvkWFFQkGJSQB3GMVI1sNZNwg10TZgG4S0YOUY0kh1es07d+xmvQBXYDXLpWi5UlMaWAGj0GjJ6BtNdkJdBQYIADpXZGgAXmgYpB1ScOwoq38aeN9DYxoU6GFRKzVoJjUwRjwAYXJbPPRuAFkwAAcAHgAxBodsAx9GWwBbACMMAD4cxhloVraOCyYjdAAzMDxoOut1e0d0UNIZ6WhWSPOwdGYIbiqATwBtAF0uaHudUQB6ACpv6ABpJBINqJdAbADW0Do5BOw3u5R2VTwMHIq2gAANtjZ0bkbHsnFCwJh8ONjHp0EgwEZ4JFoN9PkRVr1FAZoMwkDRYIjqkgOrosepoEgAB7+eAwAV2BxOLy6ACCVxgIrFEoMeOl6AACpcwMMORgIB1JRMiBNWKVdhruJKfOdIpdrtwFddXlzKjyACp3Nq842HaDIbL6BrZBIVGhIpB1EMYSLsmjmtWW-YhAA+qegAAYLKQLQj3ZsEsdccmnGcLor2Dn8xGedHGpEIBzEzspfsfMHDNAANTQACMVaIljV5GQkRA5DYmIpVKQAgAJARO9le33BDXIyi0YuLW2nJFGLqkOvxFB0YPdBSaLZ0IwNzyPkO8-xkGgsLh8Al427a3hWAhXwwHA8EHT5PmgAB1bAQBAANJ24adKWpft72RaBUTgRBUCAj89HAM8xCTaBjggABRQx0DuHJv25P9dCkWRZVIAAiBjoFImpmjlFBgA0NpsjadByDacgIDAEAIAAQmYpjoGYgAZSBsmGPw6DtZiiFA8CoJguDmAQmoZ2QvtUKQLdoAYmBTwgdEiCAA) ```ts class IdleService { doNothing (): void {} } class News { title: string; content: string; constructor(title: string, content: string) { this.title = title; this.content = content; } } const instanceCounter: Map<Function, number> = new Map(); interface Constructor { new(...args: any[]): any; } // Keep track how many instances of `Constr` constructor have been created. function getInstance< Constr extends Constructor, Args extends ConstructorParameters<Constr> >(constructor: Constr, ...args: Args): InstanceType<Constr> { let count = instanceCounter.get(constructor) || 0; const instance = new constructor(...args); instanceCounter.set(constructor, count + 1); console.log(`Created ${count + 1} instances of ${Constr.name} class`); return instance; } const idleService = getInstance(IdleService); // Will log: `Created 1 instances of IdleService class` const newsEntry = getInstance(News, 'New ECMAScript proposals!', 'Last month...'); // Will log: `Created 1 instances of News class` ``` </details> - [`Omit<T, K>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#omittype-keys) - Constructs a type by picking all properties from T and then removing K. <details> <summary> Example </summary> [Playground](https://typescript-play.js.org/?target=6#code/JYOwLgpgTgZghgYwgAgIImAWzgG2QbwChlks4BzCAVShwC5kBnMKUcgbmKYAcIFgIjBs1YgOXMpSFMWbANoBdTiW5woFddwAW0kfKWEAvoUIB6U8gDCUCHEiNkICAHdkYAJ69kz4GC3JcPG4oAHteKDABBxCYNAxsPFBIWEQUCAAPJG4wZABySUFcgJAAEzMLXNV1ck0dIuCw6EjBADpy5AB1FAQ4EGQAV0YUP2AHDy8wEOQbUugmBLwtEIA3OcmQnEjuZBgQqE7gAGtgZAhwKHdkHFGwNvGUdDIcAGUliIBJEF3kAF5kAHlML4ADyPBIAGjyBUYRQAPnkqho4NoYQA+TiEGD9EAISIhPozErQMG4AASK2gn2+AApek9pCSXm8wFSQooAJQMUkAFQAsgAZACiOAgmDOOSIJAQ+OYyGl4DgoDmf2QJRCCH6YvALQQNjsEGFovF1NyJWAy1y7OUyHMyE+yRAuFImG4Iq1YDswHxbRINjA-SgfXlHqVUE4xiAA) ```ts interface Animal { imageUrl: string; species: string; images: string[]; paragraphs: string[]; } // Creates new type with all properties of the `Animal` interface // except 'images' and 'paragraphs' properties. We can use this // type to render small hover tooltip for a wiki entry list. type AnimalShortInfo = Omit<Animal, 'images' | 'paragraphs'>; function renderAnimalHoverInfo (animals: AnimalShortInfo[]): HTMLElement { const container = document.createElement('div'); // Internal implementation. return container; } ``` </details> - [`Uppercase<S extends string>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#uppercasestringtype) - Transforms every character in a string into uppercase. <details> <summary> Example </summary> ```ts type T = Uppercase<'hello'>; // 'HELLO' type T2 = Uppercase<'foo' | 'bar'>; // 'FOO' | 'BAR' type T3<S extends string> = Uppercase<`aB${S}`>; type T4 = T3<'xYz'>; // 'ABXYZ' type T5 = Uppercase<string>; // string type T6 = Uppercase<any>; // any type T7 = Uppercase<never>; // never type T8 = Uppercase<42>; // Error, type 'number' does not satisfy the constraint 'string' ``` </details> - [`Lowercase<S extends string>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#lowercasestringtype) - Transforms every character in a string into lowercase. <details> <summary> Example </summary> ```ts type T = Lowercase<'HELLO'>; // 'hello' type T2 = Lowercase<'FOO' | 'BAR'>; // 'foo' | 'bar' type T3<S extends string> = Lowercase<`aB${S}`>; type T4 = T3<'xYz'>; // 'abxyz' type T5 = Lowercase<string>; // string type T6 = Lowercase<any>; // any type T7 = Lowercase<never>; // never type T8 = Lowercase<42>; // Error, type 'number' does not satisfy the constraint 'string' ``` </details> - [`Capitalize<S extends string>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#capitalizestringtype) - Transforms the first character in a string into uppercase. <details> <summary> Example </summary> ```ts type T = Capitalize<'hello'>; // 'Hello' type T2 = Capitalize<'foo' | 'bar'>; // 'Foo' | 'Bar' type T3<S extends string> = Capitalize<`aB${S}`>; type T4 = T3<'xYz'>; // 'ABxYz' type T5 = Capitalize<string>; // string type T6 = Capitalize<any>; // any type T7 = Capitalize<never>; // never type T8 = Capitalize<42>; // Error, type 'number' does not satisfy the constraint 'string' ``` </details> - [`Uncapitalize<S extends string>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#uncapitalizestringtype) - Transforms the first character in a string into lowercase. <details> <summary> Example </summary> ```ts type T = Uncapitalize<'Hello'>; // 'hello' type T2 = Uncapitalize<'Foo' | 'Bar'>; // 'foo' | 'bar' type T3<S extends string> = Uncapitalize<`AB${S}`>; type T4 = T3<'xYz'>; // 'aBxYz' type T5 = Uncapitalize<string>; // string type T6 = Uncapitalize<any>; // any type T7 = Uncapitalize<never>; // never type T8 = Uncapitalize<42>; // Error, type 'number' does not satisfy the constraint 'string' ``` </details> You can find some examples in the [TypeScript docs](https://www.typescriptlang.org/docs/handbook/utility-types.html). ## Maintainers - [Sindre Sorhus](https://github.com/sindresorhus) - [Jarek Radosz](https://github.com/CvX) - [Dimitri Benin](https://github.com/BendingBender) - [Pelle Wessman](https://github.com/voxpelli) ## License SPDX-License-Identifier: (MIT OR CC0-1.0) --- <div align="center"> <b> <a href="https://tidelift.com/subscription/pkg/npm-type-fest?utm_source=npm-type-fest&utm_medium=referral&utm_campaign=readme">Get professional support for this package with a Tidelift subscription</a> </b> <br> <sub> Tidelift helps make open source sustainable for maintainers while giving companies<br>assurances about security, maintenance, and licensing for their dependencies. </sub> </div> ----------- 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 package may be included in this product: - tzdata@1.0.43 This package contains the following license and notice below: The MIT License (MIT) [OSI Approved License] The MIT License (MIT) Copyright (c) 2016 Rogier Schouten <https://github.com/rogierschouten> 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: - undici-types@6.20.0 This package contains the following license and notice below: MIT License Copyright (c) Matteo Collina and Undici 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: - 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: - ws@8.18.0 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: - yaml@1.10.2 This package contains the following license and notice below: Copyright 2018 Eemeli Aro <eemeli@gmail.com> 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: - yjs@13.6.23 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
keywords jupyter jupyterlab jupyterlab-extension
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # scheduler_jupyter_plugin

A JupyterLab extension.

This extension is composed of a Python package named `scheduler_jupyter_plugin`
for the server extension and a NPM package named `scheduler-jupyter-plugin`
for the frontend extension.

## Requirements

- JupyterLab >= 4.0.0

## Install

To install the extension, execute:

```bash
pip install scheduler_jupyter_plugin
```

## Uninstall

To remove the extension, execute:

```bash
pip uninstall scheduler_jupyter_plugin
```

## Troubleshoot

If you are seeing the frontend extension, but it is not working, check
that the server extension is enabled:

```bash
jupyter server extension list
```

If the server extension is installed and enabled, but you are not seeing
the frontend extension, check the frontend extension is installed:

```bash
jupyter labextension list
```

## Contributing

### Development install

Note: You will need NodeJS to build the extension package.

The `jlpm` command is JupyterLab's pinned version of
[yarn](https://yarnpkg.com/) that is installed with JupyterLab. You may use
`yarn` or `npm` in lieu of `jlpm` below.

```bash
# Clone the repo to your local environment
# Change directory to the scheduler_jupyter_plugin directory
# Install package in development mode
pip install -e ".[test]"
# Link your development version of the extension with JupyterLab
jupyter labextension develop . --overwrite
# Server extension must be manually installed in develop mode
jupyter server extension enable scheduler_jupyter_plugin
# Rebuild extension Typescript source after making changes
jlpm build
```

You can watch the source directory and run JupyterLab at the same time in different terminals to watch for changes in the extension's source and automatically rebuild the extension.

```bash
# Watch the source directory in one terminal, automatically rebuilding when needed
jlpm watch
# Run JupyterLab in another terminal
jupyter lab
```

With the watch command running, every saved change will immediately be built locally and available in your running JupyterLab. Refresh JupyterLab to load the change in your browser (you may need to wait several seconds for the extension to be rebuilt).

By default, the `jlpm build` command generates the source maps for this extension to make it easier to debug using the browser dev tools. To also generate source maps for the JupyterLab core extensions, you can run the following command:

```bash
jupyter lab build --minimize=False
```

### Development uninstall

```bash
# Server extension must be manually disabled in develop mode
jupyter server extension disable scheduler_jupyter_plugin
pip uninstall scheduler_jupyter_plugin
```

In development mode, you will also need to remove the symlink created by `jupyter labextension develop`
command. To find its location, you can run `jupyter labextension list` to figure out where the `labextensions`
folder is located. Then you can remove the symlink named `scheduler-jupyter-plugin` within that folder.

### 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]"
# Each time you install the Python package, you need to restore the front-end extension link
jupyter labextension develop . --overwrite
```

To execute them, run:

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

#### Frontend tests

This extension is using [Jest](https://jestjs.io/) for JavaScript code testing.

To execute them, execute:

```sh
jlpm
jlpm test
```

#### Integration tests

This extension uses [Playwright](https://playwright.dev/docs/intro) for the integration tests (aka user level tests).
More precisely, the JupyterLab helper [Galata](https://github.com/jupyterlab/jupyterlab/tree/master/galata) is used to handle testing the extension in JupyterLab.

More information are provided within the [ui-tests](./ui-tests/README.md) README.

### Packaging the extension

See [RELEASE](RELEASE.md)

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "scheduler-jupyter-plugin",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "jupyter, jupyterlab, jupyterlab-extension",
    "author": null,
    "author_email": "Google <scheduler-plugins@google.com>",
    "download_url": "https://files.pythonhosted.org/packages/8c/0d/6bbde60e9ac094540b43d7efd973275a3c4e6fa259a0de54bd454ab4e767/scheduler_jupyter_plugin-0.1.0.tar.gz",
    "platform": null,
    "description": "# scheduler_jupyter_plugin\n\nA JupyterLab extension.\n\nThis extension is composed of a Python package named `scheduler_jupyter_plugin`\nfor the server extension and a NPM package named `scheduler-jupyter-plugin`\nfor the frontend extension.\n\n## Requirements\n\n- JupyterLab >= 4.0.0\n\n## Install\n\nTo install the extension, execute:\n\n```bash\npip install scheduler_jupyter_plugin\n```\n\n## Uninstall\n\nTo remove the extension, execute:\n\n```bash\npip uninstall scheduler_jupyter_plugin\n```\n\n## Troubleshoot\n\nIf you are seeing the frontend extension, but it is not working, check\nthat the server extension is enabled:\n\n```bash\njupyter server extension list\n```\n\nIf the server extension is installed and enabled, but you are not seeing\nthe frontend extension, check the frontend extension is installed:\n\n```bash\njupyter labextension list\n```\n\n## Contributing\n\n### Development install\n\nNote: You will need NodeJS to build the extension package.\n\nThe `jlpm` command is JupyterLab's pinned version of\n[yarn](https://yarnpkg.com/) that is installed with JupyterLab. You may use\n`yarn` or `npm` in lieu of `jlpm` below.\n\n```bash\n# Clone the repo to your local environment\n# Change directory to the scheduler_jupyter_plugin directory\n# Install package in development mode\npip install -e \".[test]\"\n# Link your development version of the extension with JupyterLab\njupyter labextension develop . --overwrite\n# Server extension must be manually installed in develop mode\njupyter server extension enable scheduler_jupyter_plugin\n# Rebuild extension Typescript source after making changes\njlpm build\n```\n\nYou can watch the source directory and run JupyterLab at the same time in different terminals to watch for changes in the extension's source and automatically rebuild the extension.\n\n```bash\n# Watch the source directory in one terminal, automatically rebuilding when needed\njlpm watch\n# Run JupyterLab in another terminal\njupyter lab\n```\n\nWith the watch command running, every saved change will immediately be built locally and available in your running JupyterLab. Refresh JupyterLab to load the change in your browser (you may need to wait several seconds for the extension to be rebuilt).\n\nBy default, the `jlpm build` command generates the source maps for this extension to make it easier to debug using the browser dev tools. To also generate source maps for the JupyterLab core extensions, you can run the following command:\n\n```bash\njupyter lab build --minimize=False\n```\n\n### Development uninstall\n\n```bash\n# Server extension must be manually disabled in develop mode\njupyter server extension disable scheduler_jupyter_plugin\npip uninstall scheduler_jupyter_plugin\n```\n\nIn development mode, you will also need to remove the symlink created by `jupyter labextension develop`\ncommand. To find its location, you can run `jupyter labextension list` to figure out where the `labextensions`\nfolder is located. Then you can remove the symlink named `scheduler-jupyter-plugin` within that folder.\n\n### Testing the extension\n\n#### Server tests\n\nThis extension is using [Pytest](https://docs.pytest.org/) for Python code testing.\n\nInstall test dependencies (needed only once):\n\n```sh\npip install -e \".[test]\"\n# Each time you install the Python package, you need to restore the front-end extension link\njupyter labextension develop . --overwrite\n```\n\nTo execute them, run:\n\n```sh\npytest -vv -r ap --cov scheduler_jupyter_plugin\n```\n\n#### Frontend tests\n\nThis extension is using [Jest](https://jestjs.io/) for JavaScript code testing.\n\nTo execute them, execute:\n\n```sh\njlpm\njlpm test\n```\n\n#### Integration tests\n\nThis extension uses [Playwright](https://playwright.dev/docs/intro) for the integration tests (aka user level tests).\nMore precisely, the JupyterLab helper [Galata](https://github.com/jupyterlab/jupyterlab/tree/master/galata) is used to handle testing the extension in JupyterLab.\n\nMore information are provided within the [ui-tests](./ui-tests/README.md) README.\n\n### Packaging the extension\n\nSee [RELEASE](RELEASE.md)\n",
    "bugtrack_url": null,
    "license": "This file was generated with the generate-license-file npm package!\n        https://www.npmjs.com/package/generate-license-file\n        \n        The following npm packages may be included in this product:\n        \n         - @ant-design/colors@7.2.0\n         - @ant-design/icons@5.6.0\n        \n        These packages each contain the following license and notice below:\n        \n        MIT LICENSE\n        \n        Copyright (c) 2018-present Ant UED, https://xtech.antfin.com/\n        \n        Permission is hereby granted, free of charge, to any person obtaining\n        a copy of this software and associated documentation files (the\n        \"Software\"), to deal in the Software without restriction, including\n        without limitation the rights to use, copy, modify, merge, publish,\n        distribute, sublicense, and/or sell copies of the Software, and to\n        permit persons to whom the Software is furnished to do so, subject to\n        the following conditions:\n        \n        The above copyright notice and this permission notice shall be\n        included in all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n        EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\n        MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n        NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE\n        LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION\n        OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION\n        WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - @ant-design/cssinjs-utils@1.1.3\n         - @ant-design/fast-color@2.0.6\n         - @rc-component/qrcode@1.0.0\n         - @rc-component/trigger@2.2.6\n         - rc-dropdown@4.2.1\n         - rc-slider@11.1.8\n        \n        These packages each contain the following license and notice below:\n        \n        The MIT License (MIT)\n        Copyright (c) 2015-present Alipay.com, https://www.alipay.com/\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS \n        OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF \n        MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. \n        IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY \n        CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, \n        TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE \n        SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - @ant-design/cssinjs@1.23.0\n         - rc-input@1.7.2\n         - rc-motion@2.9.5\n         - rc-overflow@1.4.1\n         - rc-picker@4.9.2\n         - rc-resize-observer@1.4.3\n         - rc-segmented@2.7.0\n         - rc-textarea@1.9.0\n        \n        These packages each contain the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2019-present afc163\n        \n        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:\n        \n        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n        \n        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.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @ant-design/icons-svg@4.4.2\n        \n        This package contains the following license and notice below:\n        \n        <h1 align=\"center\">\n        Ant Design Icons\n        </h1>\n        \n        <p align=\"center\">\n        \u2b50 The abstract node of the Ant Design SVG icons.\n        </p>\n        \n        <div align=\"center\">\n        \n        [![NPM version](https://img.shields.io/npm/v/@ant-design/icons-svg.svg?style=flat)](https://npmjs.org/package/@ant-design/icons-svg)\n        [![NPM downloads](http://img.shields.io/npm/dm/@ant-design/icons-svg.svg?style=flat)](https://npmjs.org/package/@ant-design/icons-svg)\n        \n        </div>\n        \n        Check [all icons list](https://github.com/ant-design/ant-design-icons/issues/227).\n        \n        ## Install\n        \n        ```bash\n        # use yarn\n        $ yarn add @ant-design/icons-svg\n        \n        # or use npm\n        $ npm install @ant-design/icons-svg --save\n        ```\n        \n        ## Use Library Adapter\n        \n        - React: See [@ant-design/icons](../icons-react) to learn about detail usage.\n        \n        ## Contribution Guide \u8d21\u732e\u6307\u5357\n        \n        See contribution guide. [English](./docs/ContributionGuide.md) \uff5c [\u4e2d\u6587](./docs/ContributionGuide.zh-CN.md)\n        \n        ## Get started\n        \n        ```ts\n        import { AccountBookOutlined } from '@ant-design/icons-svg';\n        // or\n        // import AccountBookOutlined from '@ant-design/icons-svg/es/asn/AccountBookOutlined';\n        \n        console.log(AccountBookOutlined);\n        // ==>\n        // {\n        //   name: 'account-book',\n        //   theme: 'outlined',\n        //   icon: {\n        //     tag: 'svg',\n        //     attrs: {\n        //       viewBox: '64 64 896 896',\n        //       focusable: 'false'\n        //     },\n        //     children: [\n        //       {\n        //         tag: 'path',\n        //         attrs: {\n        //           d:\n        //             'M880 184H712v-64c0-4.4-3.6-8-8-8h- ...'\n        //         }\n        //       }\n        //     ]\n        //   }\n        // };\n        ```\n        \n        - Interfaces\n        \n        This library export all SVG files as `IconDefinition`.\n        \n        ```ts\n        // types.d.ts\n        export declare type ThemeType = 'filled' | 'outlined' | 'twotone';\n        \n        export interface AbstractNode {\n          tag: string;\n          attrs: {\n            [key: string]: string;\n          };\n          children?: AbstractNode[];\n        }\n        \n        export interface IconDefinition {\n          name: string; // kebab-case-style\n          theme: ThemeType;\n          icon:\n            | ((primaryColor: string, secondaryColor: string) => AbstractNode)\n            | AbstractNode;\n        }\n        ```\n        \n        ## Render Helpers\n        \n        ```ts\n        import { AccountBookFilled } from '@ant-design/icons-svg';\n        import { renderIconDefinitionToSVGElement } from '@ant-design/icons-svg/es/helpers';\n        \n        const svgHTMLString = renderIconDefinitionToSVGElement(AccountBookFilled, {\n          extraSVGAttrs: { width: '1em', height: '1em', fill: 'currentColor' }\n        });\n        \n        console.log(svgHTMLString);\n        // ==>\n        // '<svg viewBox=\"64 64 896 896\" width=\"1em\" height=\"1em\" fill=\"currentColor\"><path d=\"M880 184H712v-64c0-4.4-3.6-8-8-8h-56c-4.4 0-8 3.6-8 8v64H384v-64c0-4.4-3.6-8-8-8h-56c-4.4 0-8 3.6-8 8v64H144c-17.7 0-32 14.3-32 32v664c0 17.7 14.3 32 32 32h736c17.7 0 32-14.3 32-32V216c0-17.7-14.3-32-32-32zM648.3 426.8l-87.7 161.1h45.7c5.5 0 10 4.5 10 10v21.3c0 5.5-4.5 10-10 10h-63.4v29.7h63.4c5.5 0 10 4.5 10 10v21.3c0 5.5-4.5 10-10 10h-63.4V752c0 5.5-4.5 10-10 10h-41.3c-5.5 0-10-4.5-10-10v-51.8h-63.1c-5.5 0-10-4.5-10-10v-21.3c0-5.5 4.5-10 10-10h63.1v-29.7h-63.1c-5.5 0-10-4.5-10-10v-21.3c0-5.5 4.5-10 10-10h45.2l-88-161.1c-2.6-4.8-.9-10.9 4-13.6 1.5-.8 3.1-1.2 4.8-1.2h46c3.8 0 7.2 2.1 8.9 5.5l72.9 144.3 73.2-144.3a10 10 0 0 1 8.9-5.5h45c5.5 0 10 4.5 10 10 .1 1.7-.3 3.3-1.1 4.8z\" /></svg>'\n        ```\n        \n        - Interfaces\n        \n        ```ts\n        declare function renderIconDefinitionToSVGElement(\n          icon: IconDefinition,\n          options?: HelperRenderOptions\n        ): string;\n        \n        interface HelperRenderOptions {\n          placeholders?: {\n            primaryColor?: string; // default #333\n            secondaryColor?: string; // default #E6E6E6\n          };\n          extraSVGAttrs?: {\n            [key: string]: string;\n          };\n        }\n        ```\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - @ant-design/react-slick@1.1.2\n         - json2mq@0.2.0\n        \n        These packages each contain the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2014 Kiran Abburi\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - @babel/code-frame@7.26.2\n         - @babel/generator@7.26.5\n         - @babel/helper-module-imports@7.25.9\n         - @babel/helper-string-parser@7.25.9\n         - @babel/helper-validator-identifier@7.25.9\n         - @babel/runtime@7.26.7\n         - @babel/template@7.25.9\n         - @babel/traverse@7.26.7\n         - @babel/types@7.26.7\n        \n        These packages each contain the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2014-present Sebastian McKenzie and other contributors\n        \n        Permission is hereby granted, free of charge, to any person obtaining\n        a copy of this software and associated documentation files (the\n        \"Software\"), to deal in the Software without restriction, including\n        without limitation the rights to use, copy, modify, merge, publish,\n        distribute, sublicense, and/or sell copies of the Software, and to\n        permit persons to whom the Software is furnished to do so, subject to\n        the following conditions:\n        \n        The above copyright notice and this permission notice shall be\n        included in all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n        EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\n        MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n        NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE\n        LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION\n        OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION\n        WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @babel/parser@7.26.7\n        \n        This package contains the following license and notice below:\n        \n        Copyright (C) 2012-2014 by various contributors (see AUTHORS)\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n        THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @codemirror/state@6.5.1\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (C) 2018-2021 by Marijn Haverbeke <marijn@haverbeke.berlin> and others\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n        THE SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - @emotion/babel-plugin@11.13.5\n         - @emotion/cache@11.14.0\n         - @emotion/hash@0.8.0\n         - @emotion/hash@0.9.2\n         - @emotion/is-prop-valid@1.3.1\n         - @emotion/memoize@0.9.0\n         - @emotion/react@11.14.0\n         - @emotion/serialize@1.3.3\n         - @emotion/sheet@1.4.0\n         - @emotion/styled@11.14.0\n         - @emotion/unitless@0.10.0\n         - @emotion/unitless@0.7.5\n         - @emotion/use-insertion-effect-with-fallbacks@1.2.0\n         - @emotion/utils@1.4.2\n         - @emotion/weak-memoize@0.4.0\n        \n        These packages each contain the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) Emotion team and other contributors\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - @floating-ui/core@1.6.9\n         - @floating-ui/dom@1.6.13\n         - @floating-ui/react-dom@2.1.2\n         - @floating-ui/utils@0.2.9\n        \n        These packages each contain the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2021-present Floating UI contributors\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy of\n        this software and associated documentation files (the \"Software\"), to deal in\n        the Software without restriction, including without limitation the rights to\n        use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\n        the Software, and to permit persons to whom the Software is furnished to do so,\n        subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\n        FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\n        COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\n        IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\n        CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @fortawesome/fontawesome-free@5.15.4\n        \n        This package contains the following license and notice below:\n        \n        Font Awesome Free License\n        -------------------------\n        \n        Font Awesome Free is free, open source, and GPL friendly. You can use it for\n        commercial projects, open source projects, or really almost whatever you want.\n        Full Font Awesome Free license: https://fontawesome.com/license/free.\n        \n        # Icons: CC BY 4.0 License (https://creativecommons.org/licenses/by/4.0/)\n        In the Font Awesome Free download, the CC BY 4.0 license applies to all icons\n        packaged as SVG and JS file types.\n        \n        # Fonts: SIL OFL 1.1 License (https://scripts.sil.org/OFL)\n        In the Font Awesome Free download, the SIL OFL license applies to all icons\n        packaged as web and desktop font files.\n        \n        # Code: MIT License (https://opensource.org/licenses/MIT)\n        In the Font Awesome Free download, the MIT license applies to all non-font and\n        non-icon files.\n        \n        # Attribution\n        Attribution is required by MIT, SIL OFL, and CC BY licenses. Downloaded Font\n        Awesome Free files already contain embedded comments with sufficient\n        attribution, so you shouldn't need to do anything additional when using these\n        files normally.\n        \n        We've kept attribution comments terse, so we ask that you do not actively work\n        to remove them from files, especially code. They're a great way for folks to\n        learn about Font Awesome.\n        \n        # Brand Icons\n        All brand icons are trademarks of their respective owners. The use of these\n        trademarks does not indicate endorsement of the trademark holder by Font\n        Awesome, nor vice versa. **Please do not use brand logos for any purpose except\n        to represent the company, product, or service to which they refer.**\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - @jridgewell/gen-mapping@0.3.8\n         - @jridgewell/set-array@1.2.1\n        \n        These packages each contain the following license and notice below:\n        \n        Copyright 2022 Justin Ridgewell <jridgewell@google.com>\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @jridgewell/resolve-uri@3.1.2\n        \n        This package contains the following license and notice below:\n        \n        Copyright 2019 Justin Ridgewell <jridgewell@google.com>\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @jridgewell/sourcemap-codec@1.5.0\n        \n        This package contains the following license and notice below:\n        \n        The MIT License\n        \n        Copyright (c) 2015 Rich Harris\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n        THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @jridgewell/trace-mapping@0.3.25\n        \n        This package contains the following license and notice below:\n        \n        Copyright 2022 Justin Ridgewell <justin@ridgewell.name>\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - @jupyter/react-components@0.16.7\n         - @jupyter/web-components@0.16.7\n        \n        These packages each contain the following license and notice below:\n        \n        # UI Toolkit for Jupyter\n        \n        **WIP this is early work in progress.** But don't hesitate to open issues and PRs if you want to\n        help.\n        \n        [![Extension status](https://img.shields.io/badge/status-ready-success 'The package is ready to be used')](https://jupyterlab-contrib.github.io/)\n        [![NPM Version](https://img.shields.io/npm/v/@jupyter/web-components?color=blue)](https://www.npmjs.com/package/@jupyter/web-components)\n        [![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)\n        [![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/)\n        [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/jupyterlab-contrib/jupyter-ui-toolkit/main)\n        \n        ![Toolkit for Jupyter Artwork](https://raw.githubusercontent.com/jupyterlab-contrib/jupyter-ui-toolkit/main/packages/components/docs/assets/toolkit-artwork.png)\n        \n        [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)\n        \n        ## Introduction\n        \n        The UI Toolkit is a component library for building web interfaces in Jupyter ecosystem (JupyterHub,\n        Jupyter Widgets, JupyterLab,...).\n        \n        Features of the library include:\n        \n        - **Implements the Jupyter design language:** All components follow the design language of Jupyter\n          \u2013 enabling developers to create extensions that have a consistent look and feel with the rest of\n          the ecosystem.\n        - **Automatic support for color themes:** All components are designed with theming in mind and will\n          automatically display the current application theme.\n        - **Use any tech stack:** The library ships as a set of web components, meaning developers can use\n          the toolkit no matter what tech stack (React, Vue, Svelte, etc.) their extension is built with.\n        - **Accessible out of the box:** All components ship with web standard compliant ARIA labels and\n          keyboard navigation.\n        \n        This repository contains three packages:\n        \n        - [`@jupyter/web-components`](https://github.com/jupyterlab-contrib/jupyter-ui-toolkit/tree/main/packages/components/):\n          The main package defining the web components.\n        - [`@jupyter/react-components`](https://github.com/jupyterlab-contrib/jupyter-ui-toolkit/tree/main/packages/react-components):\n          Wrapped the web components to use them with [React](https://reactjs.org).\n        - [`jupyter-ui-demo`](https://github.com/jupyterlab-contrib/jupyter-ui-toolkit/tree/main/packages/lab-example):\n          Unpublished JupyterLab extension to demonstrate the integration of the toolkit.\n        \n        Those features are brought through the [Fast Design](https://www.fast.design/). And it is inspired\n        by the [WebView toolkit for Visual Studio Code](https://github.com/microsoft/vscode-webview-ui-toolkit)\n        as example for creating a customized toolkit.\n        \n        ## Release\n        \n        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).\n        Styles and API are not guarantee between minor versions prior to v1.0.0.\n        \n        ## Getting started\n        \n        You will need to install `yarn` (for example with `npm install --global yarn`).\n        \n        To build the components packages, execute:\n        \n        ```sh\n        yarn install\n        yarn build\n        ```\n        \n        Then to interactively test or develop web components:\n        \n        ```sh\n        cd packages/components\n        yarn start\n        ```\n        \n        ### JupyterLab demo extension\n        \n        To test locally the JupyterLab demo extension, using `conda` package manager:\n        \n        ```sh\n        conda create -n jupyter-toolkit -c conda-forge -y nodejs yarn jupyterlab=3\n        conda activate jupyter-toolkit\n        yarn install\n        yarn build\n        pip install -e .\n        jupyter labextension develop --overwrite .\n        ```\n        \n        ## Documentation\n        \n        Further documentation can be found in the following places:\n        \n        - [Component Docs](https://github.com/jupyterlab-contrib/jupyter-ui-toolkit/tree/main/packages/components/docs/components.md)\n        - [Storybook (Interactive Component Sandbox)](https://jupyterlab-contrib.github.io/jupyter-ui-toolkit/)\n        - [Toolkit Extension Samples](https://github.com/jupyterlab-contrib/jupyter-ui-toolkit/tree/main/packages/lab-example):\n          [Try online](https://mybinder.org/v2/gh/jupyterlab-contrib/jupyter-ui-toolkit/main)\n        \n        ## Contributing\n        \n        See the [contributing](https://github.com/jupyterlab-contrib/jupyter-ui-toolkit/tree/main/CONTRIBUTING.md) documentation.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @jupyter/ydoc@3.0.2\n        \n        This package contains the following license and notice below:\n        \n        # @jupyter/ydoc\n        \n        `@jupyter/ydoc` provides [Yjs](https://github.com/yjs/yjs)-based data structures for various\n        documents used in the Jupyter ecosystem. Built-in documents include:\n        - `YFile`: a generic text document.\n        - `YNotebook`: a Jupyter notebook document.\n        \n        The API documentation is available [there](https://jupyter-ydoc.readthedocs.io/en/latest/api/index.html).\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @jupyterlab/application@4.3.4\n        \n        This package contains the following license and notice below:\n        \n        # @jupyterlab/application\n        \n        A JupyterLab package that provides the top-level application object,\n        with which JupyterLab plugins may be registered.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @jupyterlab/apputils@4.4.4\n        \n        This package contains the following license and notice below:\n        \n        # @jupyterlab/apputils\n        \n        A JupyterLab package which provides a collection of utilities and UI elements for building an application and manipulating the DOM.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @jupyterlab/codeeditor@4.3.4\n        \n        This package contains the following license and notice below:\n        \n        # @jupyterlab/codeeditor\n        \n        A JupyterLab package which defines an abstract interface to a code editor,\n        which is used in many places in the application, including [cells](../cells)\n        and the [file editor](../fileeditor).\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @jupyterlab/coreutils@6.3.4\n        \n        This package contains the following license and notice below:\n        \n        # @jupyterlab/coreutils\n        \n        A JupyterLab package which provides utility functions that are widely used\n        across many of the `@jupyterlab` packages. This includes (among other things)\n        functions for manipulating paths, urls, and the notebook format.\n        \n        This package is intended for use within both Node.js and browser environments.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @jupyterlab/docregistry@4.3.4\n        \n        This package contains the following license and notice below:\n        \n        # @jupyterlab/docregistry\n        \n        A JupyterLab package which tracks the different types of documents that the application is able to interact with.\n        This includes notebooks, text files, and base64 encoded documents.\n        \n        Extensions may register new document types with the document registry to allow them to be opened with JupyterLab.\n        An example of this may be found in the [@jupyterlab/notebook](../notebook) package.\n        \n        The document registry is a singleton on the [application](../application).\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @jupyterlab/launcher@4.3.4\n        \n        This package contains the following license and notice below:\n        \n        # @jupyterlab/launcher\n        \n        A JupyterLab package that provides a launcher for various activities,\n        including notebooks, consoles, text editors, and terminals.\n        \n        JupyterLab extensions may register themselves with the launcher in order to show up as an activity when the application starts.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @jupyterlab/mainmenu@4.3.4\n        \n        This package contains the following license and notice below:\n        \n        # @jupyterlab/mainmenu\n        \n        A JupyterLab extension which provides the application menubar.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - @jupyterlab/nbformat@4.3.4\n         - @jupyterlab/settingregistry@4.3.4\n         - @jupyterlab/statedb@4.3.4\n         - @jupyterlab/statusbar@4.3.4\n         - @lumino/algorithm@2.0.2\n         - @lumino/application@2.4.1\n         - @lumino/collections@2.0.2\n         - @lumino/commands@2.3.1\n         - @lumino/coreutils@2.2.0\n         - @lumino/disposable@2.1.3\n         - @lumino/domutils@2.0.2\n         - @lumino/dragdrop@2.1.5\n         - @lumino/keyboard@2.0.2\n         - @lumino/messaging@2.0.2\n         - @lumino/properties@2.0.2\n         - @lumino/signaling@2.1.3\n         - @lumino/virtualdom@2.0.2\n         - @lumino/widgets@2.5.0\n        \n        These packages each contain the following license and notice below:\n        \n        (BSD-3-Clause)\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @jupyterlab/observables@5.3.4\n        \n        This package contains the following license and notice below:\n        \n        # @jupyterlab/observables\n        \n        A JupyterLab package which provides data structures (such as strings, lists, and maps), which can be listened to for changes.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @jupyterlab/rendermime-interfaces@3.11.4\n        \n        This package contains the following license and notice below:\n        \n        # @jupyterlab/rendermime-interfaces\n        \n        A package for JupyterLab which provides interfaces for implementing mime renderer extensions.\n        \n        A general JupyterLab plugin involves a certain amount of boilerplate code\n        that can be annoying for authors of relatively extensions.\n        The interfaces in this package are meant to give an easier way for extension authors\n        to provide a plugin that renders mime bundles and documents of a specific mime type.\n        \n        When using these interfaces, extensions only need to provide some metadata about\n        what kind of mime bundle they are able to render, and a `Widget` with\n        a `renderModel` method that renders the mime bundle.\n        \n        Examples can be found in [@jupyterlab/vega5-extension](../vega5-extension) and [@jupyterlab/pdf-extension](../pdf-extension).\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @jupyterlab/rendermime@4.3.4\n        \n        This package contains the following license and notice below:\n        \n        # @jupyterlab/rendermime\n        \n        A JupyterLab package which manages mime bundle renderers for the application,\n        and provides default renderers for a number of formats, such as markdown,\n        HTML, images, and LaTeX.\n        \n        A simplified interface for adding new mime renderers to the application\n        can be found in [@jupyterlab/rendermime-interfaces](../rendermime-interfaces).\n        \n        The rendermime is a singleton on the [application](../application).\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @jupyterlab/services@7.3.4\n        \n        This package contains the following license and notice below:\n        \n        # JupyterLab Services\n        \n        Javascript client for the Jupyter services REST APIs\n        \n        [API Docs](https://jupyterlab.readthedocs.io/en/stable/api/)\n        \n        [REST API Docs](https://petstore.swagger.io/?url=https://raw.githubusercontent.com/jupyter-server/jupyter_server/main/jupyter_server/services/api/api.yaml)\n        \n        Note: All functions and classes using the REST API allow a `serverSettings`\n        parameter to configure requests.\n        \n        Requests are made using the `fetch` API, which is available in modern browsers or in Node 18+.\n        \n        ## Package Install\n        \n        **Prerequisites**\n        \n        - [node](http://nodejs.org/)\n        - Python, e.g. via [conda](https://www.anaconda.com/download)\n        \n        ```bash\n        npm install --save @jupyterlab/services\n        conda install jupyter-server # jupyter-server 2.0+ is recommended\n        # or `pip install jupyter-server`\n        ```\n        \n        ## Source Build\n        \n        **Prerequisites**\n        \n        See the [building instructions for JupyterLab](../../CONTRIBUTING.md), which\n        will build this module as part of the build process.\n        \n        **Rebuild**\n        \n        ```bash\n        yarn run clean\n        yarn run build\n        ```\n        \n        ## Run Tests\n        \n        Follow the source build instructions first.\n        \n        ```bash\n        yarn run test\n        ```\n        \n        ## Build Docs\n        \n        Follow the source build instructions first.\n        \n        ```bash\n        yarn run docs\n        ```\n        \n        Navigate to `docs/index.html`.\n        \n        ## Supported Runtimes\n        \n        The runtime versions which should work are listed below. Earlier versions may\n        also work, but come with no guarantees.\n        \n        - Node 10\n        - Firefox 52+\n        - Chrome 55+\n        \n        Note: \"requirejs\" may need be included in a global context for `Comm` targets\n        using the a `target_module` (in the classic Notebook).\n        This can be as a `<script>` tag in the browser or by using the `requirejs`\n        package in node (`npm install requirejs` and setting\n        `global.requirejs = require('requirejs');`).\n        \n        ## Starting the Jupyter Server\n        \n        Follow the package install instructions first.\n        \n        The library requires a running Jupyter Server, launched as:\n        \n        ```bash\n        jupyter server\n        ```\n        \n        or\n        \n        ```bash\n        jupyter lab\n        ```\n        \n        ## Bundling for the Browser\n        \n        Follow the package install instructions first.\n        \n        See `examples/browser` for an example of using Webpack to bundle the library.\n        \n        ## Usage from Node.js\n        \n        Follow the package install instructions first.\n        \n        See `examples/node` for an example of using an ES5 node script.\n        \n        ## Usage Examples\n        \n        **Note:** This package is compiled to ES2018 JavaScript syntax from\n        TypeScript. Here are some examples of using parts of this package. See the\n        other `examples` subdirectories for more examples.\n        \n        - [Comms](./examples/browser/src/comm.ts)\n        - [Config](./examples/browser/src/config.ts)\n        - [Contents](./examples/browser/src/contents.ts)\n        - [Kernel](./examples/browser/src/kernel.ts)\n        - [Session](./examples/browser/src/session.ts)\n        - [Terminal](./examples/browser/src/terminal.ts)\n        \n        ## Overview\n        \n        This package introduces a number of concepts, such as session context, etc.\n        Here we give a brief overview of some of the top-level concepts in this\n        package.\n        \n        ### Clients\n        \n        A _client_ is a single entity connected to a kernel. Since kernel messages\n        include the client id, it is easy for a client to filter kernel messages for\n        just messages between it and the kernel. In JupyterLab, different activities\n        (such as a console and a notebook) are usually considered separate clients when\n        connected to the same kernel.\n        \n        ### Kernel specs\n        \n        A _kernel spec_ is the data about an available kernel on the system. We can\n        retrieve a current list of kernel specs from the server.\n        \n        ### Kernels\n        \n        A _kernel_ represents a running process on the server that implements the\n        Jupyter kernel messaging protocol.\n        \n        #### Kernel model\n        \n        A _kernel model_ mirrors the server kernel models, and represents a single\n        running kernel on the server. A kernel can be created, restarted, shut down,\n        etc., through calls to the server. A kernel model's lifecycle mirrors the\n        server kernel model's lifecycle, and it will be disposed when the server\n        kernel is shut down.\n        \n        #### Kernel connection\n        \n        A _kernel connection_ represents a single client connecting to a kernel over a\n        websocket. Typically only one kernel connection handles comms for any given\n        kernel. The kernel connection is disposed when the client no longer has a need\n        for the connection. Disposing a kernel connection does not cause the kernel to\n        shut down. However, if a kernel is shut down, (eventually) all of its kernel\n        connections should be disposed if they were initiated from a kernel manager.\n        If the kernel connections were instantiated outside of a manager, you are\n        responsible for cleaning them up.\n        \n        A kernel connection has a number of signals, such as kernel status, kernel\n        connection status, etc.\n        \n        #### Kernel manager\n        \n        A _kernel manager_ is an object that maintains a list of kernel models by\n        regular polling. The kernel manager can instantiate a kernel connection and\n        will manage its lifecycle (e.g., when the kernel is shut down, the connections\n        will be disposed). The manager provides some minimal bookkeeping around\n        kernels and their connections. Generally, it is easiest to interact with\n        kernels on a server through a manager.\n        \n        ### Sessions\n        \n        A _session_ is a mapping on the server from an identifying string (the\n        session's `path`) to a kernel. A session has a few other pieces of information\n        to allow for easy categorization and searching of sessions.\n        \n        The primary usecase of a session is to enable persisting a connection to a\n        kernel. For example, a notebook viewer may start a session with session path\n        of the notebook's file path. When a browser is refreshed, the notebook viewer\n        can connect to the same kernel by asking the server for the session\n        corresponding with the notebook file path.\n        \n        #### Session model\n        \n        A _session model_ mirrors a server session. The session models can be\n        refreshed from the server, created, changed (including creating a new session\n        kernel), and shut down (which implies that the kernel will be shut down). A\n        session model's lifecycle mirrors the server session's lifecycle, and it will\n        be disposed when the server session is shut down.\n        \n        #### Session connection\n        \n        A _session connection_ represents a single client connected to a session's\n        kernel. A session's kernel connection can change and may be null to signify no\n        current kernel connection. A session connection owns the kernel connection,\n        meaning the kernel connection is created and disposed by the session\n        connection as needed. The session connection proxies signals from the kernel\n        connection for convenience (e.g., you can listen to the session's status\n        signal to get status changes for whatever the current kernel is, without\n        having to disconnect and reconnect your signal handlers every time the session\n        kernel changes). The session connection can be disposed when the client no\n        longer is connected to that session's kernel, and disposal will not cause the\n        session model to be deleted.\n        \n        #### Session manager\n        \n        A _session manager_ is an object that maintains a list of session models by\n        regular polling. The session manager can instantiate a session connection and\n        will manage its lifecycle (e.g., when the session is shut down, the connections\n        will be disposed). The manager provides some minimal bookkeeping around\n        sessions and their connections. Generally, it is easiest to interact with\n        sessions on a server through a manager.\n        \n        ### Session Context\n        \n        A _session context_ is an object which has the same lifecycle as the client.\n        The session context owns a session connection (which may be null if the client\n        is not currently associated with a session). The session context proxies the\n        current session connection's signals for convenience. The session context\n        primarily serves as a stable object for a client to keep track of the current\n        session connection. The session context also contains some convenience\n        functionality, such as preferences for whether a kernel should be started and\n        a user-friendly kernel name and status.\n        \n        Here is a diagram that provides an overview of the different components:\n        \n        ![architecture-diagram](./architecture.png)\n        \n        _The diagram can be edited on [diagrams.net](https://diagrams.net) by importing the [source](./architecture.xml)_.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @jupyterlab/translation@4.3.4\n        \n        This package contains the following license and notice below:\n        \n        # @jupyterlab/translation\n        \n        Translation utilities.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @jupyterlab/ui-components@4.3.4\n        \n        This package contains the following license and notice below:\n        \n        <!--\n        THIS FILE IS AUTOGENERATED, DO NOT EDIT\n        \n        Instead, make changes to docs sources in `packages/ui-components/docs`,\n        then run \"jlpm docs:init\" to refresh the built docs\n        -->\n        \n        # @jupyterlab/ui-components\n        \n        The\n        [@jupyterlab/ui-components](https://jupyterlab.github.io/jupyterlab/modules/_ui_components_src_index_.html)\n        package provides UI elements that are widely used in JupyterLab core,\n        and that can be reused in your own extensions.\n        \n        For example, all of the icons in JupyterLab core can be reused via\n        `LabIcon`. You can also use `LabIcon` to create your own custom icons\n        that will be able to automatically change color to match the current\n        JupyterLab theme.\n        \n        # `LabIcon` - set up and render icons\n        \n        `LabIcon` is the icon class used by JupyterLab, and is part of the new\n        icon system introduced in JupyterLab v2.0.\n        \n        ## How JupyterLab handles icons\n        \n        The @jupyterlab/ui-components package provides icons to the rest of\n        JupyterLab, in the form of a set of `LabIcon` instances (currently about\n        80). All of the icons in the core JupyterLab packages are rendered using\n        one of these `LabIcon` instances.\n        \n        ## Using the icons in your own code\n        \n        You can use any of JupyterLab icons in your own code via an `import`\n        statement. For example, to use `jupyterIcon` you would first do:\n        \n        ```typescript\n        import { jupyterIcon } from '@jupyterlab/ui-components';\n        ```\n        \n        ## How to render an icon into a DOM node\n        \n        Icons can be added as children to any `div` or `span` nodes using the\n        `icon.element(...)` method (where `icon` is any instance of `LabIcon`).\n        For example, to render the Jupyter icon you could do:\n        \n        ```typescript\n        jupyterIcon.element({\n          container: elem,\n          height: '16px',\n          width: '16px',\n          marginLeft: '2px'\n        });\n        ```\n        \n        where `elem` is any `HTMLElement` with a `div` or `span` tag. As shown\n        in the above example, the icon can be styled by passing CSS parameters\n        into `.element(...)`. Any valid CSS parameter can be used (one catch:\n        snake case params do have to be converted to camel case: instead of\n        `foo-bar: '8px'`, you\u2019d need to use `fooBar: '8px'`.\n        \n        ## How to render an icon as a React component\n        \n        Icons can also be rendered using React. The `icon.react` parameter holds\n        a standard React component that will display the icon on render. Like\n        any React component, `icon.react` can be used in various ways.\n        \n        For example, here is how you would add the Jupyter icon to the render\n        tree of another React component:\n        \n        ```jsx\n        public render() {\n          return (\n            <div className=\"outer\">\n              <div className=\"inner\">\n                <jupyterIcon.react tag=\"span\" right=\"7px\" top=\"5px\" />\n                \"and here's a text node\"\n              </div>\n            </div>\n          );\n        }\n        ```\n        \n        Alternatively, you can just render the icon directly into any existing\n        DOM node `elem` by using the `ReactDOM` module:\n        \n        ```typescript\n        const root = createRoot(elem);\n        root.render(jupyterIcon.react);\n        ```\n        \n        If do you use `ReactDOM` to render, and if the `elem` node is ever\n        removed from the DOM, you\u2019ll first need to clean it up:\n        \n        ```typescript\n        root.unmount();\n        ```\n        \n        This cleanup step is not a special property of `LabIcon`, but is instead\n        needed for any React component that is rendered directly at the top\n        level by `ReactDOM`.\n        \n        ## How to create your own custom `LabIcon`\n        \n        You can create your own custom icon by constructing a new instance of\n        `LabIcon`:\n        \n        ```typescript\n        export const fooIcon = new LabIcon({\n          name: 'barpkg:foo',\n          svgstr: '<svg>...</svg>'\n        });\n        ```\n        \n        where `name` should be of the form \u201cyour-pkg:icon-name\u201d, and `svgstr` is\n        the raw contents of your icon\u2019s svg file.\n        \n        ## How to create a new `LabIcon` from an external svg file\n        \n        Although you can copy-and-paste an svg directly into the `LabIcon`\n        constructor, the best practice is to keep the svg for each of your icons\n        in its own separate svg file. You will need to have an `svg.d.ts` file\n        at the root of your project\u2019s `src` directory:\n        \n        ```typescript\n        // svg.d.ts\n        \n        declare module '*.svg' {\n          const value: string;\n          export default value;\n        }\n        ```\n        \n        You can then `import` the contents of an svg file:\n        \n        ```typescript\n        import fooSvgstr from 'path-to-your/foo.svg';\n        \n        export const fooIcon = new LabIcon({\n          name: 'barpkg:foo',\n          svgstr: fooSvgstr\n        });\n        ```\n        \n        ## Sync icon color to JupyterLab theme\n        \n        <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>\n        \n        You can ensure that the colors of your custom `LabIcon` sync up to the\n        colors of the current JupyterLab theme by adding appropriate `class`\n        annotations to each colored element of your icon's svg.\n        \n        In other words, each element of your svg that a `fill=\"...\"` or a\n        `stroke=\"...\"` property should also have a `class=\"jp-icon<whatever>\"`\n        property.\n        \n        ### Available icon classes\n        \n        <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>\n        \n        All colors shown are for the standard light/dark theme, mouse over for\n        hex values.\n        \n        #### `jp-iconX`: contrast to theme background\n        \n        <ul>\n        <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>\n        <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>\n        <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>\n        <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>\n        <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>\n        </ul>\n        \n        Most one-color icons in JupyterLab (including the sidebar and toolbar\n        icons) are colored using the `jp-icon3` class.\n        \n        For light/dark themes, `jp-icon0` corresponds to the darkest/lightest\n        background color, while `jp-icon1` is somewhat lighter/darker, and so\n        forth.\n        \n        #### `jp-icon-accentX`: match to theme background\n        \n        <ul>\n        <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>\n        <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>\n        <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>\n        <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>\n        <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>\n        </ul>\n        \n        For light/dark themes, `jp-icon-accent0` corresponds to the\n        lightest/darkest background color, while `jp-icon-accent1` is somewhat\n        darker/lighter, and so forth.\n        \n        ### Adding classes to a one-color icon\n        \n        For most simple, one-color icons, it is desirable for the icon's color\n        to strongly contrast with that of the application's background. You can\n        achieve this using one of the `jp-iconX` classes.\n        \n        **Example: check icon**\n        \n        _svg source:_\n        \n        ```html\n        <svg xmlns=\"http://www.w3.org/2000/svg\" width=\"100\" viewBox=\"0 0 24 24\">\n          <path\n            class=\"jp-icon3\"\n            fill=\"#616161\"\n            d=\"M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z\"\n          />\n        </svg>\n        ```\n        \n        _rendered icon:_\n        \n        <svg xmlns=\"http://www.w3.org/2000/svg\" width=\"100\" viewBox=\"0 0 24 24\">\n          <path class=\"jp-icon3\" fill=\"#616161\" d=\"M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z\"/>\n        </svg>\n        \n        ### Adding classes to a multi-colored icon\n        \n        For more complex icons, each element that needs to match the background\n        should be annotated with a `jp-icon-accentX` class, while each element\n        that needs to contrast with the background should be annotated with a\n        `jp-iconX` class.\n        \n        **Example: close-circle icon**\n        \n        _svg source:_\n        \n        ```html\n        <svg xmlns=\"http://www.w3.org/2000/svg\" width=\"100\" viewBox=\"0 0 24 24\">\n          <circle class=\"jp-icon3\" fill=\"#616161\" cx=\"12\" cy=\"12\" r=\"11\" />\n          <rect\n            class=\"jp-icon-accent0\"\n            fill=\"#fff\"\n            height=\"18\"\n            width=\"2\"\n            x=\"11\"\n            y=\"3\"\n            transform=\"rotate(315, 12, 12)\"\n          />\n          <rect\n            class=\"jp-icon-accent0\"\n            fill=\"#fff\"\n            height=\"18\"\n            width=\"2\"\n            x=\"11\"\n            y=\"3\"\n            transform=\"rotate(45, 12, 12)\"\n          />\n        </svg>\n        ```\n        \n        _rendered icon:_\n        \n        <svg xmlns=\"http://www.w3.org/2000/svg\" width=\"100\" viewBox=\"0 0 24 24\">\n          <circle class=\"jp-icon3\" fill=\"#616161\" cx=\"12\" cy=\"12\" r=\"11\"/>\n          <rect class=\"jp-icon-accent0\" fill=\"#fff\" height=\"18\" width=\"2\" x=\"11\" y=\"3\" transform=\"rotate(315, 12, 12)\"/>\n          <rect class=\"jp-icon-accent0\" fill=\"#fff\" height=\"18\" width=\"2\" x=\"11\" y=\"3\" transform=\"rotate(45, 12, 12)\"/>\n        </svg>\n        \n        ## Background\n        \n        ### Icon handling in Jupyterlab\n        \n        Pre JupyterLab 2.0, most icons were created using the\n        icons-as-css-background pattern:\n        \n        - Set up the icon\u2019s svg as a `background-image` in CSS:\n        \n          ```css\n          /* CSS */\n        \n          .jp-FooIcon {\n            background-image: url('path-to-your/foo.svg');\n          }\n          ```\n        \n        - Add the icon to the DOM by constructing an otherwise empty DOM node\n          with the appropriate class:\n        \n          ```typescript\n          // typescript\n        \n          const e = document.createElement('div');\n          e.className = 'jp-FooIcon';\n          document.body.append(e);\n          ```\n        \n        What you end up with is a single DOM node that has the \u201cfoo\u201d icon as a\n        background image.\n        \n        Post JupyterLab 2.0, nearly all icons in core are now created using\n        [LabIcon](https://github.com/jupyterlab/jupyterlab/blob/f0153e0258b32674c9aec106383ddf7b618cebab/packages/ui-components/src/icon/labicon.tsx)\n        and the icons-as-inline-svg pattern:\n        \n        - Construct a new instance of LabIcon from the icon\u2019s name and svg:\n        \n          ```typescript\n          // typescript\n        \n          // svgstr is the raw contents of an icon's svg file\n          export const fooIcon = new LabIcon({\n            name: 'barpkg:foo',\n            svgstr: '<svg>...</svg>'\n          });\n          ```\n        \n        - Add the icon to the DOM using the appropriate property of your\n          LabIcon instance (either LabIcon.element() to directly create a DOM\n          node, or LabIcon.react to get the icon as a react component):\n        \n          ```typescript\n          // typescript\n        \n          const e = fooIcon.element();\n          document.body.append(e);\n          ```\n        \n        What you end up with is a DOM node (by default a \u2018div\u2019) that has an\n        inline svg node as a child.\n        \n        ### `background-image` vs inline svg\n        \n        The big limitation of the old icon-as-css-background pattern is that svg\n        images rendered as `background-image` are invisible to CSS. On the other\n        hand, an icon rendered as an inline svg node is fully exposed to the\n        CSS. This allows us to dynamically change icon styling as needed simply by\n        modifying our CSS. Most importantly, this allows us to recolor icons\n        according to Jupyterlab\u2019s current theme.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @lumino/polling@2.1.3\n        \n        This package contains the following license and notice below:\n        \n        # @lumino/polling\n        \n        This package provides a class for generic polling functionality (`Poll`). It\n        also provides rate limiters (`Debouncer` and `Throttler`).\n        \n        The `Poll` class provides three different ways to \"subscribe\" to poll ticks:\n        \n        - [`@lumino/signaling`](../signaling/): `Poll#ticked` is a Lumino signal that\n          emits each time there is a poll tick.\n        - `Promise`-based: `Poll#tick` is a promise that resolves after every tick and\n          only rejects when the poll is disposed.\n        - `AsyncIterable`: `Poll#[`Symbol.asyncIterator`]` implements the async iterable\n          protocol that allows iteration using [`for-await...of`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/for-await...of) loops.\n        \n        ## Example usage\n        \n        These are examples from the unit tests for this package. They\n        demonstrate the three different ways polling is supported.\n        \n        ### Using `Poll#tick` promise\n        \n        Here, we set up the testing state variables and create a new `Poll` instance.\n        \n        ```typescript\n        const expected = 'started resolved resolved';\n        const ticker: IPoll.Phase<any>[] = [];\n        const tock = (poll: Poll) => {\n          ticker.push(poll.state.phase);\n          poll.tick.then(tock).catch(() => undefined);\n        };\n        const poll = new Poll({\n          auto: false,\n          factory: () => Promise.resolve(),\n          frequency: { interval: 100, backoff: false }\n        });\n        ```\n        \n        Next we assign the `tock` function to run after the poll ticks and\n        we start the poll.\n        \n        ```typescript\n        void poll.tick.then(tock);\n        void poll.start();\n        ```\n        \n        And we verify that the `ticker` did indeed get populated when `tock`\n        was called and the next promise was captured as well.\n        \n        ```typescript\n        await sleep(1000); // Sleep for longer than the interval.\n        expect(ticker.join(' ').startsWith(expected)).to.equal(true);\n        poll.dispose();\n        ```\n        \n        ### Using `Poll#ticked` signal\n        \n        Here, we set up the testing state variables and create a new `Poll` instance.\n        \n        ```typescript\n        const poll = new Poll<void, void>({\n          factory: () => Promise.resolve(),\n          frequency: { interval: 100, backoff: false }\n        });\n        ```\n        \n        Here we connect to the `ticked` signal and simply check that each\n        tick matches the poll `state` accessor's contents.\n        \n        ```typescript\n        poll.ticked.connect((_, tick) => {\n          expect(tick).to.equal(poll.state);\n        });\n        await sleep(1000); // Sleep for longer than the interval.\n        poll.dispose();\n        ```\n        \n        ### Using `Poll` as an `AsyncIterable`\n        \n        Here, we set up the testing state variables and create a new `Poll` instance.\n        \n        ```typescript\n        let poll: Poll;\n        let total = 2;\n        let i = 0;\n        \n        poll = new Poll({\n          auto: false,\n          factory: () => Promise.resolve(++i > total ? poll.dispose() : void 0),\n          frequency: { interval: Poll.IMMEDIATE }\n        });\n        \n        const expected = `started${' resolved'.repeat(total)}`;\n        const ticker: IPoll.Phase<any>[] = [];\n        ```\n        \n        Then the poll is started:\n        \n        ```typescript\n        void poll.start();\n        ```\n        \n        Instead of connecting to the `ticked` signal or awaiting the `tick` promise, we can now use a `for-await...of` loop:\n        \n        ```typescript\n        for await (const state of poll) {\n          ticker.push(state.phase);\n          if (poll.isDisposed) {\n            break;\n          }\n        }\n        ```\n        \n        And we check to make sure the results are as expected:\n        \n        ```typescript\n        // ticker and expected both equal:\n        // 'started resolved resolved disposed'\n        expect(ticker.join(' ')).to.equal(expected);\n        ```\n        \n        ### Note for consumers of async iterators\n        \n        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`.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @marijn/find-cluster-break@1.0.2\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (C) 2024 by Marijn Haverbeke <marijn@haverbeke.berlin>\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n        THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @microsoft/fast-colors@5.3.1\n        \n        This package contains the following license and notice below:\n        \n        # FAST Colors\n        \n        `@microsoft/fast-colors` includes a number of color classes and utilities designed to make parsing and manipulating colors easy, fast, and light-weight.\n        \n        ## Color classes\n        \n        There are a number of color classes exported for common color formats. These include:\n        \n        - `ColorHSL`\n        - `ColorHSV`\n        - `ColorLAB`\n        - `ColorLCH`\n        - `ColorRGBA64` (note each channel is a number from 0-1)\n        - `ColorXYZ`\n        \n        ```ts\n        const myColor: new ColorRGBA64(0, 0, 0, 1);\n        \n        myColor.toStringHexRGB() // \"#000000\"\n        ```\n        \n        ## Color parsers\n        \n        A number of color parsers are also available to parse a variety of different color formats.\n        \n        - `parseColorHexRGB(raw: string): ColorRGBA64 | null` parses `#RGB` or `#RRGGBB` color strings\n        - `parseColorHexARGB(raw: string): ColorRGBA64 | null` parses `#ARGB` or `#AARRGGBB` color strings\n        - `parseColorHexRGBA(raw: string): ColorRGBA64 | null` parses `#RGBA` or `#RRGGBBAA` color strings\n        - `parseColorWebRGB(raw: string): ColorRGBA64 | null` parses `#rgb(R, G, B)` color strings\n        - `parseColorWebRGBA(raw: string): ColorRGBA64 | null` parses `#rgb(R, G, B, A)` color strings\n        - `parseColorNamned(raw: string): ColorRGBA64 | null` parses [named color strings](https://www.w3schools.com/colors/colors_names.asp)\n        \n        ## Color Palette\n        \n        A utility for creating a palette of colors from a source color and configuration options:\n        \n        - `baseColor?: ColorRGBA64`\n        - `steps?: number`\n        - `interpolationMode?: ColorInterpolationSpace`\n        - `scaleColorLight?: ColorRGBA64`\n        - `scaleColorDark?: ColorRGBA64`\n        - `clipLight?: number`\n        - `clipDark?: number`\n        - `saturationAdjustmentCutoff?: number`\n        - `saturationLight?: number`\n        - `saturationDark?: number`\n        - `overlayLight?: number`\n        - `overlayDark?: number`\n        - `multiplyLight?: number`\n        - `multiplyDark?: number`\n        \n        Example:\n        \n        ```ts\n        const palette: ColorPalette = new ColorPalette({\n            baseColor: new ColorRGBA64(.4, .4, .7, 1),\n            steps: 99,\n            interpolationMode: ColorInterpolationSpace.RGB\n        })\n        ```\n        \n        ## Color converters\n        \n        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:\n        \n        - `hslToRGB`\n        - `rgbToHSL`\n        - `rgbToHSV`\n        - `hsvToRGB`\n        - `lchToLAB`\n        - `labToLCH`\n        - `labToXYZ`\n        - `xyzToLAB`\n        - `rgbToXYZ`\n        - `xyzToRGB`\n        - `rgbToLAB`\n        - `labToRGB`\n        - `rgbToLCH`\n        - `lchToRGB`\n        \n        ```ts\n        const rgb: ColorRGBA64 = new ColorRGBA64(.5, .5, .5, 1);\n        const hsl: ColorHSL = rgbToHSL(rgb);\n        ```\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @microsoft/fast-element@1.14.0\n        \n        This package contains the following license and notice below:\n        \n        # FAST Element\n        \n        [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n        [![npm version](https://badge.fury.io/js/%40microsoft%2Ffast-element.svg)](https://badge.fury.io/js/%40microsoft%2Ffast-element)\n        \n        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.\n        \n        ## Installation\n        \n        ### From NPM\n        \n        To install the `fast-element` library, use either `npm` or `yarn` as follows:\n        \n        ```shell\n        npm install --save @microsoft/fast-element\n        ```\n        \n        ```shell\n        yarn add @microsoft/fast-element\n        ```\n        \n        Within your JavaScript or TypeScript code, you can then import library APIs like this:\n        \n        ```ts\n        import { FASTElement } from '@microsoft/fast-element';\n        ```\n        \n        :::tip\n        Looking for a setup that integrates with a particular front-end framework or bundler? Check out [our integration docs](../integrations/introduction.md).\n        :::\n        \n        ### From CDN\n        \n        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.\n        \n        ```html\n        <!DOCTYPE html>\n        <html lang=\"en\">\n            <head>\n                <script type=\"module\">\n                  import { FASTElement } from \"https://cdn.jsdelivr.net/npm/@microsoft/fast-element/dist/fast-element.min.js\";\n        \n                  // your code here\n                </script>\n            </head>\n            <!-- ... -->\n        </html>\n        ```\n        \n        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:\n        \n        ```html\n        <script type=\"module\" src=\"https://cdn.jsdelivr.net/npm/@microsoft/fast-element@1.6.2/dist/fast-element.min.js\"></script>\n        ```\n        \n        :::note\n        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.\n        :::\n        \n        :::tip\n        Looking for a quick guide on building components?  Check out [our Cheat Sheet](../resources/cheat-sheet.md#building-components).\n        :::\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @microsoft/fast-foundation@2.50.0\n        \n        This package contains the following license and notice below:\n        \n        # FAST Foundation\n        \n        [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n        [![npm version](https://badge.fury.io/js/%40microsoft%2Ffast-foundation.svg)](https://badge.fury.io/js/%40microsoft%2Ffast-foundation)\n        \n        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.\n        \n        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.\n        \n        ## Installation\n        \n        ### From NPM\n        \n        To install the `fast-foundation` library, use either `npm` or `yarn` as follows:\n        \n        ```shell\n        npm install --save @microsoft/fast-foundation\n        ```\n        \n        ```shell\n        yarn add @microsoft/fast-foundation\n        ```\n        \n        Within your JavaScript or TypeScript code, you can then import library APIs like this:\n        \n        ```ts\n        import { Anchor } from '@microsoft/fast-foundation';\n        ```\n        \n        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).\n        \n        ### From CDN\n        \n        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.\n        \n        ```html\n        <!DOCTYPE html>\n        <html lang=\"en\">\n            <head>\n                <script type=\"module\">\n                  import { Anchor } from \"https://cdn.jsdelivr.net/npm/@microsoft/fast-foundation/dist/fast-foundation.min.js\";\n        \n                  // your code here\n                </script>\n            </head>\n            <!-- ... -->\n        </html>\n        ```\n        \n        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:\n        \n        ```html\n        <script type=\"module\" src=\"https://cdn.jsdelivr.net/npm/@microsoft/fast-foundation@2.26.2/dist/fast-foundation.min.js\"></script>\n        ```\n        \n        :::note\n        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.\n        :::\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @microsoft/fast-web-utilities@5.4.1\n        \n        This package contains the following license and notice below:\n        \n        # FAST Web utilities\n        \n        This package is a collection of utilities intended to be used for web projects.\n        \n        ## Installation\n        \n        `npm i --save @microsoft/fast-web-utilities`\n        \n        ## Usage\n        \n        ### DOM utilities\n        \n        #### getKeyCode\n        \n        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.\n        \n        ```js\n        import { getKeyCode } from \"@microsoft/fast-web-utilities\";\n        \n        handleKeyPress = (e) => {\n            let keyCode = getKeyCode(e);\n        \n            // Do something based on keyCode value\n        }\n        ```\n        \n        ### HTML utilities\n        \n        #### getClientRectWithMargin\n        \n        The `getClientRectWithMargin` function gets the client bounding rectangle including any margins of an element.\n        \n        ```js\n        import { getClientRectWithMargin } from \"@microsoft/fast-web-utilities\";\n        \n        const itemWidth = getClientRectWithMargin(item).width;\n        const itemHeight = getClientRectWithMargin(item).height;\n        ```\n        \n        #### convertStylePropertyPixelsToNumber\n        \n        The `convertStylePropertyPixelsToNumber` function will convert a property value from an elements computed style from pixels to a number value.\n        \n        ```js\n        import { convertStylePropertyPixelsToNumber } from \"@microsoft/fast-web-utilities\";\n        \n        const elementTopMargin = convertStylePropertyPixelsToNumber(style, \"margin-top\");\n        ```\n        \n        ### Key utilities\n        \n        #### Key strings\n        \n        Commonly used `event.key` values are available as individual exports. Additional `key` values will be added as needed.  \n        \n        ```js\n        import { keyEnter, keySpace } from \"@microsoft/fast-web-utilities\";\n        \n        handleKeyPress = (e) => {\n            switch (e.key) {\n                case keySpace:\n                case keyEnter:\n                    // Do something if key matches\n                    break;\n            }\n        }\n        ```\n        \n        #### KeyCodes (enum)\n        \n        Keycodes are deprecated and their use should be avoided. Use the individual string `key` values instead.\n        \n        ### Localization utilities\n        \n        #### Typescript enum\n        \n        The `Direction` enum contains the `ltr` and `rtl` enum for use in a Typescript project.\n        \n        ```typescript\n        import { Direction } from \"@microsoft/fast-web-utilities\";\n        \n        let direction: Direction = Direction.ltr;\n        ```\n        \n        ### Number utilities\n        \n        #### Limit\n        \n        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.\n        \n        ```js\n        import { limit } from \"@microsoft/fast-web-utilities\";\n        const incomingNumber; // 11 \n        const setNumberByLimit = limit(0, 10, incomingNumber); // returns 10\n        ```\n        \n        #### wrapInBounds\n        \n        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.\n        \n        ```js\n        import { wrapInBounds } from \"@microsoft/fast-web-utilities\";\n        const slides; // 5\n        const index; // 5\n        const activeIndex = wrapInBounds(0, this.slides.length - 1, index) // returns 0\n        ```\n        \n        ### String utilities\n        \n        #### Format\n        \n        The `format` function builds a string from a format specifier and replacement parameters.\n        \n        ```js\n        import { format } from \"@microsoft/fast-web-utilities\";\n        \n        const formatterString = \"View {0} {1}\";\n        \n        const newString = format(formatterString, \"page\", \"4\")); // \"View page 4\"\n        ```\n        \n        #### startsWith\n        \n        The `startsWith` function checks to see if one string starts with another. The function is case sensitive.\n        \n        ```js\n        import { startsWith } from \"@microsoft/fast-web-utilities\";\n        \n        const matchIsFalse = startsWith(\"HelloWorld\", \"World\"); // false\n        const matchIsTrue = startsWith(\"HelloWorld\", \"Hello\"); // true\n        ```\n        \n        #### isNullOrWhiteSpace\n        \n        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.\n        \n        ```js\n        import { isNullOrWhiteSpace } from \"@microsoft/fast-web-utilities\";\n        \n        const myAnchor = document.querySelector(\"#id\");\n        const checkWhitespace = isNullOrWhiteSpace(myAnchor.href);\n        ```\n        \n        #### pascalCase\n        \n        The `pascalCase` function converts a string to Pascal Case\n        \n        ```js\n        import { pascalCase } from \"@microsoft/fast-web-utilities\";\n        \n        const hyphenatedToPascal = pascalCase(\"my-string\");\n        const uppercaseToPascal = pascalCase(\"MY STRING\");\n        const whitespaceToPascal = pascalCase(\" my string \");\n        ```\n        \n        #### classNames\n        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.\n        \n        ```js\n        import { classNames } from \"@microsoft/fast-web-utilities\";\n        \n        // evaluates to \"classOne classTwo classThree classFive\"\n        const myJoinedClassNames = classNames(\n            \"classOne\",\n            () => \"classTwo\",\n            [\"classThree\", true],\n            [\"classFour\", false]\n            [() => \"classFive\", true],\n            [() => \"classSix\", false]\n        )\n        ```\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - @mui/base@5.0.0-dev.20240529-082515-213b5e33ab\n         - @mui/core-downloads-tracker@5.16.14\n         - @mui/icons-material@5.16.14\n         - @mui/material@5.16.14\n         - @mui/private-theming@5.16.14\n         - @mui/styled-engine@5.16.14\n         - @mui/system@5.16.14\n         - @mui/types@7.2.21\n         - @mui/utils@5.16.14\n         - @mui/utils@6.4.1\n        \n        These packages each contain the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2014 Call-Em-All\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @mui/x-date-pickers@6.20.2\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2020 Material-UI SAS\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @popperjs/core@2.11.8\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2019 Federico Zivolo\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy of\n        this software and associated documentation files (the \"Software\"), to deal in\n        the Software without restriction, including without limitation the rights to\n        use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\n        the Software, and to permit persons to whom the Software is furnished to do so,\n        subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\n        FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\n        COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\n        IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\n        CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - @rc-component/async-validator@5.0.4\n         - @rc-component/context@1.4.0\n         - rc-collapse@3.9.0\n         - rc-dialog@9.6.0\n         - rc-input-number@9.4.0\n         - rc-menu@9.16.0\n         - rc-notification@5.6.2\n         - rc-pagination@5.0.0\n         - rc-progress@4.0.0\n         - rc-rate@2.13.0\n         - rc-steps@6.0.1\n         - rc-switch@4.1.0\n         - rc-tabs@15.5.0\n        \n        These packages each contain the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2014-present yiminghe\n        \n        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:\n        \n        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n        \n        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.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - @rc-component/color-picker@2.0.1\n         - rc-mentions@2.19.1\n        \n        These packages each contain the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2019-present alipay.com\n        \n        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:\n        \n        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n        \n        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.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - @rc-component/mini-decimal@1.1.0\n         - @rc-component/mutate-observer@1.1.0\n         - @rc-component/portal@1.1.2\n         - @rc-component/tour@1.15.1\n         - rc-field-form@2.7.0\n        \n        These packages each contain the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2019-present react-component\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @react-dnd/asap@4.0.1\n        \n        This package contains the following license and notice below:\n        \n        Copyright 2009\u20132014 Contributors. All rights reserved.\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to\n        deal in the Software without restriction, including without limitation the\n        rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n        sell copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n        FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n        IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - @react-dnd/invariant@2.0.0\n         - prop-types@15.8.1\n        \n        These packages each contain the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2013-present, Facebook, Inc.\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - @react-dnd/shallowequal@2.0.0\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2017 Alberto Leal <mailforalberto@gmail.com> (github.com/dashed)\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - @rjsf/core@5.24.1\n         - @rjsf/utils@5.24.1\n        \n        These packages each contain the following license and notice below:\n        \n        Apache License\n                                   Version 2.0, January 2004\n                                http://www.apache.org/licenses/\n        \n        TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION\n        \n        1.  Definitions.\n        \n            \"License\" shall mean the terms and conditions for use, reproduction,\n            and distribution as defined by Sections 1 through 9 of this document.\n        \n            \"Licensor\" shall mean the copyright owner or entity authorized by\n            the copyright owner that is granting the License.\n        \n            \"Legal Entity\" shall mean the union of the acting entity and all\n            other entities that control, are controlled by, or are under common\n            control with that entity. For the purposes of this definition,\n            \"control\" means (i) the power, direct or indirect, to cause the\n            direction or management of such entity, whether by contract or\n            otherwise, or (ii) ownership of fifty percent (50%) or more of the\n            outstanding shares, or (iii) beneficial ownership of such entity.\n        \n            \"You\" (or \"Your\") shall mean an individual or Legal Entity\n            exercising permissions granted by this License.\n        \n            \"Source\" form shall mean the preferred form for making modifications,\n            including but not limited to software source code, documentation\n            source, and configuration files.\n        \n            \"Object\" form shall mean any form resulting from mechanical\n            transformation or translation of a Source form, including but\n            not limited to compiled object code, generated documentation,\n            and conversions to other media types.\n        \n            \"Work\" shall mean the work of authorship, whether in Source or\n            Object form, made available under the License, as indicated by a\n            copyright notice that is included in or attached to the work\n            (an example is provided in the Appendix below).\n        \n            \"Derivative Works\" shall mean any work, whether in Source or Object\n            form, that is based on (or derived from) the Work and for which the\n            editorial revisions, annotations, elaborations, or other modifications\n            represent, as a whole, an original work of authorship. For the purposes\n            of this License, Derivative Works shall not include works that remain\n            separable from, or merely link (or bind by name) to the interfaces of,\n            the Work and Derivative Works thereof.\n        \n            \"Contribution\" shall mean any work of authorship, including\n            the original version of the Work and any modifications or additions\n            to that Work or Derivative Works thereof, that is intentionally\n            submitted to Licensor for inclusion in the Work by the copyright owner\n            or by an individual or Legal Entity authorized to submit on behalf of\n            the copyright owner. For the purposes of this definition, \"submitted\"\n            means any form of electronic, verbal, or written communication sent\n            to the Licensor or its representatives, including but not limited to\n            communication on electronic mailing lists, source code control systems,\n            and issue tracking systems that are managed by, or on behalf of, the\n            Licensor for the purpose of discussing and improving the Work, but\n            excluding communication that is conspicuously marked or otherwise\n            designated in writing by the copyright owner as \"Not a Contribution.\"\n        \n            \"Contributor\" shall mean Licensor and any individual or Legal Entity\n            on behalf of whom a Contribution has been received by Licensor and\n            subsequently incorporated within the Work.\n        \n        2.  Grant of Copyright License. Subject to the terms and conditions of\n            this License, each Contributor hereby grants to You a perpetual,\n            worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n            copyright license to reproduce, prepare Derivative Works of,\n            publicly display, publicly perform, sublicense, and distribute the\n            Work and such Derivative Works in Source or Object form.\n        \n        3.  Grant of Patent License. Subject to the terms and conditions of\n            this License, each Contributor hereby grants to You a perpetual,\n            worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n            (except as stated in this section) patent license to make, have made,\n            use, offer to sell, sell, import, and otherwise transfer the Work,\n            where such license applies only to those patent claims licensable\n            by such Contributor that are necessarily infringed by their\n            Contribution(s) alone or by combination of their Contribution(s)\n            with the Work to which such Contribution(s) was submitted. If You\n            institute patent litigation against any entity (including a\n            cross-claim or counterclaim in a lawsuit) alleging that the Work\n            or a Contribution incorporated within the Work constitutes direct\n            or contributory patent infringement, then any patent licenses\n            granted to You under this License for that Work shall terminate\n            as of the date such litigation is filed.\n        \n        4.  Redistribution. You may reproduce and distribute copies of the\n            Work or Derivative Works thereof in any medium, with or without\n            modifications, and in Source or Object form, provided that You\n            meet the following conditions:\n        \n            (a) You must give any other recipients of the Work or\n            Derivative Works a copy of this License; and\n        \n            (b) You must cause any modified files to carry prominent notices\n            stating that You changed the files; and\n        \n            (c) You must retain, in the Source form of any Derivative Works\n            that You distribute, all copyright, patent, trademark, and\n            attribution notices from the Source form of the Work,\n            excluding those notices that do not pertain to any part of\n            the Derivative Works; and\n        \n            (d) If the Work includes a \"NOTICE\" text file as part of its\n            distribution, then any Derivative Works that You distribute must\n            include a readable copy of the attribution notices contained\n            within such NOTICE file, excluding those notices that do not\n            pertain to any part of the Derivative Works, in at least one\n            of the following places: within a NOTICE text file distributed\n            as part of the Derivative Works; within the Source form or\n            documentation, if provided along with the Derivative Works; or,\n            within a display generated by the Derivative Works, if and\n            wherever such third-party notices normally appear. The contents\n            of the NOTICE file are for informational purposes only and\n            do not modify the License. You may add Your own attribution\n            notices within Derivative Works that You distribute, alongside\n            or as an addendum to the NOTICE text from the Work, provided\n            that such additional attribution notices cannot be construed\n            as modifying the License.\n        \n            You may add Your own copyright statement to Your modifications and\n            may provide additional or different license terms and conditions\n            for use, reproduction, or distribution of Your modifications, or\n            for any such Derivative Works as a whole, provided Your use,\n            reproduction, and distribution of the Work otherwise complies with\n            the conditions stated in this License.\n        \n        5.  Submission of Contributions. Unless You explicitly state otherwise,\n            any Contribution intentionally submitted for inclusion in the Work\n            by You to the Licensor shall be under the terms and conditions of\n            this License, without any additional terms or conditions.\n            Notwithstanding the above, nothing herein shall supersede or modify\n            the terms of any separate license agreement you may have executed\n            with Licensor regarding such Contributions.\n        \n        6.  Trademarks. This License does not grant permission to use the trade\n            names, trademarks, service marks, or product names of the Licensor,\n            except as required for reasonable and customary use in describing the\n            origin of the Work and reproducing the content of the NOTICE file.\n        \n        7.  Disclaimer of Warranty. Unless required by applicable law or\n            agreed to in writing, Licensor provides the Work (and each\n            Contributor provides its Contributions) on an \"AS IS\" BASIS,\n            WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or\n            implied, including, without limitation, any warranties or conditions\n            of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A\n            PARTICULAR PURPOSE. You are solely responsible for determining the\n            appropriateness of using or redistributing the Work and assume any\n            risks associated with Your exercise of permissions under this License.\n        \n        8.  Limitation of Liability. In no event and under no legal theory,\n            whether in tort (including negligence), contract, or otherwise,\n            unless required by applicable law (such as deliberate and grossly\n            negligent acts) or agreed to in writing, shall any Contributor be\n            liable to You for damages, including any direct, indirect, special,\n            incidental, or consequential damages of any character arising as a\n            result of this License or out of the use or inability to use the\n            Work (including but not limited to damages for loss of goodwill,\n            work stoppage, computer failure or malfunction, or any and all\n            other commercial damages or losses), even if such Contributor\n            has been advised of the possibility of such damages.\n        \n        9.  Accepting Warranty or Additional Liability. While redistributing\n            the Work or Derivative Works thereof, You may choose to offer,\n            and charge a fee for, acceptance of support, warranty, indemnity,\n            or other liability obligations and/or rights consistent with this\n            License. However, in accepting such obligations, You may act only\n            on Your own behalf and on Your sole responsibility, not on behalf\n            of any other Contributor, and only if You agree to indemnify,\n            defend, and hold each Contributor harmless for any liability\n            incurred by, or claims asserted against, such Contributor by reason\n            of your accepting any such warranty or additional liability.\n        \n        END OF TERMS AND CONDITIONS\n        \n        APPENDIX: How to apply the Apache License to your work.\n        \n              To apply the Apache License to your work, attach the following\n              boilerplate notice, with the fields enclosed by brackets \"[]\"\n              replaced with your own identifying information. (Don't include\n              the brackets!)  The text should be enclosed in the appropriate\n              comment syntax for the file format. We also recommend that a\n              file or class name and description of purpose be included on the\n              same \"printed page\" as the copyright notice for easier\n              identification within third-party archives.\n        \n        Copyright 2015-2024 rjsf-team\n        \n        Licensed under the Apache License, Version 2.0 (the \"License\");\n        you may not use this file except in compliance with the License.\n        You may obtain a copy of the License at\n        \n               http://www.apache.org/licenses/LICENSE-2.0\n        \n        Unless required by applicable law or agreed to in writing, software\n        distributed under the License is distributed on an \"AS IS\" BASIS,\n        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n        See the License for the specific language governing permissions and\n        limitations under the License.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - @types/hoist-non-react-statics@3.3.6\n         - @types/node@22.10.10\n         - @types/parse-json@4.0.2\n         - @types/prop-types@15.7.14\n         - @types/react-transition-group@4.4.12\n         - @types/react@18.3.18\n         - @types/react@19.0.8\n         - @types/uuid@9.0.8\n        \n        These packages each contain the following license and notice below:\n        \n        MIT License\n        \n            Copyright (c) Microsoft Corporation.\n        \n            Permission is hereby granted, free of charge, to any person obtaining a copy\n            of this software and associated documentation files (the \"Software\"), to deal\n            in the Software without restriction, including without limitation the rights\n            to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n            copies of the Software, and to permit persons to whom the Software is\n            furnished to do so, subject to the following conditions:\n        \n            The above copyright notice and this permission notice shall be included in all\n            copies or substantial portions of the Software.\n        \n            THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n            IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n            FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n            AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n            LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n            OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n            SOFTWARE\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - ajv@8.17.1\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2015-2021 Evgeny Poberezkin\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - antd@5.23.2\n        \n        This package contains the following license and notice below:\n        \n        MIT LICENSE\n        \n        Copyright (c) 2015-present Ant UED, https://xtech.antfin.com/\n        \n        Permission is hereby granted, free of charge, to any person obtaining\n        a copy of this software and associated documentation files (the\n        \"Software\"), to deal in the Software without restriction, including\n        without limitation the rights to use, copy, modify, merge, publish,\n        distribute, sublicense, and/or sell copies of the Software, and to\n        permit persons to whom the Software is furnished to do so, subject to\n        the following conditions:\n        \n        The above copyright notice and this permission notice shall be\n        included in all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n        EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\n        MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n        NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE\n        LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION\n        OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION\n        WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - babel-plugin-macros@3.1.0\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        Copyright (c) 2020 Kent C. Dodds\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - callsites@3.1.0\n         - globals@11.12.0\n         - parent-module@1.0.1\n         - path-type@4.0.0\n         - resolve-from@4.0.0\n        \n        These packages each contain the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)\n        \n        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:\n        \n        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n        \n        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.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - classnames@2.5.1\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2018 Jed Watson\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - clsx@1.2.1\n         - clsx@2.1.1\n        \n        These packages each contain the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) Luke Edwards <luke.edwards05@gmail.com> (lukeed.com)\n        \n        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:\n        \n        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n        \n        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.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - compute-gcd@1.2.1\n         - compute-lcm@1.1.2\n         - validate.io-array@1.0.6\n        \n        These packages each contain the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2014-2015 Athan Reines.\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - compute-scroll-into-view@3.1.1\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2025 Cody Olsen\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - convert-source-map@1.9.0\n        \n        This package contains the following license and notice below:\n        \n        Copyright 2013 Thorsten Lorenz. \n        All rights reserved.\n        \n        Permission is hereby granted, free of charge, to any person\n        obtaining a copy of this software and associated documentation\n        files (the \"Software\"), to deal in the Software without\n        restriction, including without limitation the rights to use,\n        copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the\n        Software is furnished to do so, subject to the following\n        conditions:\n        \n        The above copyright notice and this permission notice shall be\n        included in all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n        EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES\n        OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n        NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\n        HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\n        WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n        FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\n        OTHER DEALINGS IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - copy-to-clipboard@3.3.3\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2017 sudodoki <smd.deluzion@gmail.com>\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - cosmiconfig@7.1.0\n         - tabbable@5.3.3\n        \n        These packages each contain the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2015 David Clark\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - csstype@3.0.10\n        \n        This package contains the following license and notice below:\n        \n        Copyright (c) 2017-2018 Fredrik Nicol\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - csstype@3.1.3\n        \n        This package contains the following license and notice below:\n        \n        Copyright (c) 2017-2018 Fredrik Nicol\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - dayjs@1.11.13\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2018-present, iamkun\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - debug@4.4.0\n        \n        This package contains the following license and notice below:\n        \n        (The MIT License)\n        \n        Copyright (c) 2014-2017 TJ Holowaychuk <tj@vision-media.ca>\n        Copyright (c) 2018-2021 Josh Junon\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy of this software\n        and associated documentation files (the 'Software'), to deal in the Software without restriction,\n        including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense,\n        and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so,\n        subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all copies or substantial\n        portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT\n        LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.\n        IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\n        WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE\n        SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - deepmerge@4.3.1\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2012 James Halliday, Josh Duff, and other contributors\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n        THE SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - dnd-core@14.0.1\n         - react-dnd-html5-backend@14.1.0\n        \n        These packages each contain the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2015 Dan Abramov\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - dom-helpers@5.2.1\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2015 Jason Quense\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - dom-serializer@2.0.0\n        \n        This package contains the following license and notice below:\n        \n        License\n        \n        (The MIT License)\n        \n        Copyright (c) 2014 The cheeriojs contributors\n        \n        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:\n        \n        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n        \n        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.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - domelementtype@2.3.0\n         - domhandler@5.0.3\n         - domutils@3.2.2\n         - entities@4.5.0\n        \n        These packages each contain the following license and notice below:\n        \n        Copyright (c) Felix B\u00f6hm\n        All rights reserved.\n        \n        Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:\n        \n        Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.\n        \n        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.\n        \n        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,\n        EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - error-ex@1.3.2\n         - is-arrayish@0.2.1\n        \n        These packages each contain the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2015 JD Ballard\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n        THE SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - escape-string-regexp@4.0.0\n         - import-fresh@3.3.0\n         - parse-json@5.2.0\n        \n        These packages each contain the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)\n        \n        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:\n        \n        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n        \n        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.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - exenv-es6@1.1.1\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2018 Chris Holt\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - fast-deep-equal@3.1.3\n         - json-schema-traverse@1.0.0\n        \n        These packages each contain the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2017 Evgeny Poberezkin\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - fast-uri@3.0.6\n        \n        This package contains the following license and notice below:\n        \n        Copyright (c) 2021 The Fastify Team\n        Copyright (c) 2011-2021, Gary Court until https://github.com/garycourt/uri-js/commit/a1acf730b4bba3f1097c9f52e7d9d3aba8cdcaae\n        All rights reserved.\n        \n        Redistribution and use in source and binary forms, with or without\n        modification, are permitted provided that the following conditions are met:\n            * Redistributions of source code must retain the above copyright\n              notice, this list of conditions and the following disclaimer.\n            * Redistributions in binary form must reproduce the above copyright\n              notice, this list of conditions and the following disclaimer in the\n              documentation and/or other materials provided with the distribution.\n            * The names of any contributors may not be used to endorse or promote\n              products derived from this software without specific prior written\n              permission.\n        \n        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND\n        ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED\n        WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\n        DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE LIABLE FOR ANY\n        DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\n        (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\n        LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND\n        ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n        (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS\n        SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n        \n                                          *   *   *\n        \n        The complete list of contributors can be found at:\n        - https://github.com/garycourt/uri-js/graphs/contributors\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - find-root@1.1.0\n        \n        This package contains the following license and notice below:\n        \n        Copyright \u00a9 2017 jsdnxx\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \u201cSoftware\u201d), 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:\n        \n        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \u201cAS IS\u201d, 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.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - free-style@3.1.0\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2014 Blake Embrey (hello@blakeembrey.com)\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n        THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - function-bind@1.1.2\n        \n        This package contains the following license and notice below:\n        \n        Copyright (c) 2013 Raynos.\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n        THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - hasown@2.0.2\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) Jordan Harband and contributors\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - hoist-non-react-statics@3.3.2\n        \n        This package contains the following license and notice below:\n        \n        Software License Agreement (BSD License)\n        ========================================\n        \n        Copyright (c) 2015, Yahoo! Inc. All rights reserved.\n        ----------------------------------------------------\n        \n        Redistribution and use of this software in source and binary forms, with or\n        without modification, are permitted provided that the following conditions are\n        met:\n        \n          * Redistributions of source code must retain the above copyright notice, this\n            list of conditions and the following disclaimer.\n          * Redistributions in binary form must reproduce the above copyright notice,\n            this list of conditions and the following disclaimer in the documentation\n            and/or other materials provided with the distribution.\n          * Neither the name of Yahoo! Inc. nor the names of YUI's contributors may be\n            used to endorse or promote products derived from this software without\n            specific prior written permission of Yahoo! Inc.\n        \n        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND\n        ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED\n        WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\n        DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR\n        ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\n        (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\n        LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON\n        ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n        (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS\n        SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - htmlparser2@8.0.2\n        \n        This package contains the following license and notice below:\n        \n        Copyright 2010, 2011, Chris Winberry <chris@winberry.net>. All rights reserved.\n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to\n        deal in the Software without restriction, including without limitation the\n        rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n        sell copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n         \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n         \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n        FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n        IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - is-core-module@2.16.1\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2014 Dave Justice\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy of\n        this software and associated documentation files (the \"Software\"), to deal in\n        the Software without restriction, including without limitation the rights to\n        use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\n        the Software, and to permit persons to whom the Software is furnished to do so,\n        subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\n        FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\n        COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\n        IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\n        CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - is-plain-object@5.0.0\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2014-2017, Jon Schlinkert.\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n        THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - isomorphic.js@0.2.5\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2020 Kevin Jahns <kevin.jahns@protonmail.com>.\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - js-tokens@4.0.0\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2014, 2015, 2016, 2017, 2018 Simon Lydell\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n        THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - jsesc@3.1.0\n        \n        This package contains the following license and notice below:\n        \n        Copyright Mathias Bynens <https://mathiasbynens.be/>\n        \n        Permission is hereby granted, free of charge, to any person obtaining\n        a copy of this software and associated documentation files (the\n        \"Software\"), to deal in the Software without restriction, including\n        without limitation the rights to use, copy, modify, merge, publish,\n        distribute, sublicense, and/or sell copies of the Software, and to\n        permit persons to whom the Software is furnished to do so, subject to\n        the following conditions:\n        \n        The above copyright notice and this permission notice shall be\n        included in all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n        EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\n        MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n        NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE\n        LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION\n        OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION\n        WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - json-parse-even-better-errors@2.3.1\n        \n        This package contains the following license and notice below:\n        \n        Copyright 2017 Kat March\u00e1n\n        Copyright npm, Inc.\n        \n        Permission is hereby granted, free of charge, to any person obtaining a\n        copy of this software and associated documentation files (the \"Software\"),\n        to deal in the Software without restriction, including without limitation\n        the rights to use, copy, modify, merge, publish, distribute, sublicense,\n        and/or sell copies of the Software, and to permit persons to whom the\n        Software is furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n        FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER\n        DEALINGS IN THE SOFTWARE.\n        \n        ---\n        \n        This library is a fork of 'better-json-errors' by Kat March\u00e1n, extended and\n        distributed under the terms of the MIT license above.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - json-schema-compare@0.2.2\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2017 Martin Hansen\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - json-schema-merge-allof@0.8.1\n        \n        This package contains the following license and notice below:\n        \n        # 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)\n        \n        > Merge schemas combined using allOf into a more readable composed schema free from allOf.\n        \n        ```bash\n        npm install json-schema-merge-allof --save\n        ```\n        \n        ## Features\n        \n        - **Real** and **safe** merging of schemas combined with **allOf**\n        - Takes away all allOf found in the whole schema\n        - Lossless in terms of validation rules, merged schema does not validate more or less than the original schema\n        - Results in a more readable root schema\n        - Removes almost all logical impossibilities\n        - Throws if no logical intersection is found (your schema would not validate anything from the start)\n        - Validates in a way not possible by regular simple meta validators\n        - Correctly considers additionalProperties, patternProperties and properties as a part of an whole when merging schemas containing those\n        - Correctly considers items and additionalItems as a whole when merging schemas containing those\n        - Supports merging schemas with items as array and direct schema\n        - Supports merging dependencies when mixed array and schema\n        - Supports all JSON schema core/validation keywords (v6, use custom resolvers to support other keywords)\n        - Option to override common impossibility like adding properties when using **additionalProperties: false**\n        - Pluggable keyword resolvers\n        \n        ## How\n        \n        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:\n        \n        ```js\n        {\n          type: ['object', 'null'],\n          additionalProperties: {\n            type: 'string',\n            minLength: 5\n          },\n          allOf: [{\n            type: ['array', 'object'],\n            additionalProperties: {\n              type: 'string',\n              minLength: 10,\n              maxLength: 20\n            }\n          }]\n        }\n        ```\n        \n        This result in the schema :\n        ```js\n        {\n          type: 'object',\n          additionalProperties: {\n            type: 'string',\n            minLength: 10,\n            maxLength: 20\n          }\n        }\n        ```\n        \n        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.\n        \n        For other keywords other methods are used, here are some simple examples:\n        \n        - minLength, minimum, minItems etc chooses the **highest** value of the conflicting values.\n        - maxLength, maximum, maxItems etc chooses the **lowest** value of the conflicting values.\n        - uniqueItems is true if **any** of the conflicting values are true\n        \n        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.\n        \n        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:\n        \n        ### not\n        \n        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.\n        \n        ## Options\n        **ignoreAdditionalProperties** default **false**\n        \n        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.\n        \n        **deep** boolean, default *true*\n        If false, resolves only the top-level `allOf` keyword in the schema.\n        \n        If true, resolves all `allOf` keywords in the schema.\n        \n        \n        **resolvers** Object\n        Override any default resolver like this:\n        \n        ```js\n        mergeAllOf(schema, {\n          resolvers: {\n            title: function(values, path, mergeSchemas, options) {\n              // choose what title you want to be used based on the conflicting values\n              // resolvers MUST return a value other than undefined\n            }\n          }\n        })\n        ```\n        \n        The function is passed:\n        \n        - **values** an array of the conflicting values that need to be resolved\n        - **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)\n        - **mergeSchemas** a function you can call that merges an array of schemas\n        - **options** the options mergeAllOf was called with\n        \n        \n        ### Combined resolvers\n        Some keyword are dependant on other keywords, like properties, patternProperties, additionalProperties. To create a resolver for these the resolver requires this structure:\n        \n        ```js\n        mergeAllOf(schema, {\n          resolvers: {\n            properties:\n              keywords: ['properties', 'patternProperties', 'additionalProperties'],\n              resolver(values, parents, mergers, options) {\n        \n              }\n            }\n          }\n        })\n        ```\n        \n        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:\n        \n        ```js\n        {\n            properties: ...,\n            patternProperties: ...,\n            additionalProperties: ...,\n        }\n        ```\n        \n        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:\n        \n        ```js\n        const mergers = {\n            properties: function mergeSchemas(schemas, childSchemaName){...},\n            patternProperties: function mergeSchemas(schemas, childSchemaName){...},\n            additionalProperties: function mergeSchemas(schemas){...},\n        }\n        ```\n        \n        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.\n        \n        ### Default resolver\n        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:\n        \n        ```js\n        mergeJsonSchema({\n          ...\n        }, {\n          resolvers: {\n            defaultResolver: mergeJsonSchema.options.resolvers.title\n          }\n        })\n        ```\n        \n        \n        ## Resolvers\n        \n        Resolvers are called whenever multiple conflicting values are found on the same position in the schemas.\n        \n        You can override a resolver by supplying it in the options.\n        \n        ### Lossy vs lossless\n        \n        All built in reducers for validation keywords are lossless, meaning that they don't remove or add anything in terms of validation.\n        \n        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.\n        \n        \n        ## $ref\n        \n        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.\n        \n        \n        ## Other libraries\n        \n        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.\n        \n        \n        ## Restrictions\n        \n        We cannot merge schemas that are a logical impossibility, like:\n        \n        ```js\n        {\n          type: 'object',\n          allOf: [{\n            type: 'array'\n          }]\n        }\n        ```\n        \n        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.\n        \n        \n        ## Roadmap\n        \n        - [x] Treat the interdependent validations like properties and additionalProperties as one resolver (and items additionalItems)\n        - [ ] Extract repeating validators from anyOf/oneOf and merge them with parent schema\n        - [ ] After extraction of validators from anyOf/oneOf, compare them and remove duplicates.\n        - [ ] If left with only one in anyOf/oneOf then merge it to the parent schema.\n        - [ ] Expose seperate tools for validation, extraction\n        - [ ] Consider adding even more logical validation (like minLength <= maxLength)\n        \n        ## Contributing\n        \n        Create tests for new functionality and follow the eslint rules.\n        \n        ## License\n        \n        MIT \u00a9 [Martin Hansen](http://martinhansen.com)\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - json5@2.2.3\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2012-2018 Aseem Kishore, and [others].\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        [others]: https://github.com/json5/json5/contributors\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - jsonpointer@5.0.1\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2011-2015 Jan Lehnardt <jan@apache.org> & Marc Bachmann <https://github.com/marcbachmann> \n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n        THE SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - lib0@0.2.99\n         - y-protocols@1.0.6\n        \n        These packages each contain the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2019 Kevin Jahns <kevin.jahns@protonmail.com>.\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - lines-and-columns@1.2.4\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2015 Brian Donovan\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n        THE SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - lodash-es@4.17.21\n         - lodash@4.17.21\n        \n        These packages each contain the following license and notice below:\n        \n        Copyright OpenJS Foundation and other contributors <https://openjsf.org/>\n        \n        Based on Underscore.js, copyright Jeremy Ashkenas,\n        DocumentCloud and Investigative Reporters & Editors <http://underscorejs.org/>\n        \n        This software consists of voluntary contributions made by many\n        individuals. For exact contribution history, see the revision history\n        available at https://github.com/lodash/lodash\n        \n        The following license applies to all parts of this software except as\n        documented below:\n        \n        ====\n        \n        Permission is hereby granted, free of charge, to any person obtaining\n        a copy of this software and associated documentation files (the\n        \"Software\"), to deal in the Software without restriction, including\n        without limitation the rights to use, copy, modify, merge, publish,\n        distribute, sublicense, and/or sell copies of the Software, and to\n        permit persons to whom the Software is furnished to do so, subject to\n        the following conditions:\n        \n        The above copyright notice and this permission notice shall be\n        included in all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n        EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\n        MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n        NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE\n        LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION\n        OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION\n        WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n        \n        ====\n        \n        Copyright and related rights for sample code are waived via CC0. Sample\n        code is defined as all source code displayed within the prose of the\n        documentation.\n        \n        CC0: http://creativecommons.org/publicdomain/zero/1.0/\n        \n        ====\n        \n        Files located in the node_modules and vendor directories are externally\n        maintained libraries used by this software which have their own\n        licenses; we recommend you read them, as their terms may differ from the\n        terms above.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - lodash.escape@4.0.1\n        \n        This package contains the following license and notice below:\n        \n        Copyright jQuery Foundation and other contributors <https://jquery.org/>\n        \n        Based on Underscore.js, copyright Jeremy Ashkenas,\n        DocumentCloud and Investigative Reporters & Editors <http://underscorejs.org/>\n        \n        This software consists of voluntary contributions made by many\n        individuals. For exact contribution history, see the revision history\n        available at https://github.com/lodash/lodash\n        \n        The following license applies to all parts of this software except as\n        documented below:\n        \n        ====\n        \n        Permission is hereby granted, free of charge, to any person obtaining\n        a copy of this software and associated documentation files (the\n        \"Software\"), to deal in the Software without restriction, including\n        without limitation the rights to use, copy, modify, merge, publish,\n        distribute, sublicense, and/or sell copies of the Software, and to\n        permit persons to whom the Software is furnished to do so, subject to\n        the following conditions:\n        \n        The above copyright notice and this permission notice shall be\n        included in all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n        EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\n        MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n        NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE\n        LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION\n        OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION\n        WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n        \n        ====\n        \n        Copyright and related rights for sample code are waived via CC0. Sample\n        code is defined as all source code displayed within the prose of the\n        documentation.\n        \n        CC0: http://creativecommons.org/publicdomain/zero/1.0/\n        \n        ====\n        \n        Files located in the node_modules and vendor directories are externally\n        maintained libraries used by this software which have their own\n        licenses; we recommend you read them, as their terms may differ from the\n        terms above.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - loose-envify@1.4.0\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2015 Andres Suarez <zertosh@gmail.com>\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n        THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - markdown-to-jsx@7.7.3\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2015-present Evan Jacobs\n        \n        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:\n        \n        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n        \n        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.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - memoize-one@5.2.1\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2019 Alexander Reardon\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - minimist@1.2.8\n        \n        This package contains the following license and notice below:\n        \n        This software is released under the MIT license:\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy of\n        this software and associated documentation files (the \"Software\"), to deal in\n        the Software without restriction, including without limitation the rights to\n        use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\n        the Software, and to permit persons to whom the Software is furnished to do so,\n        subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\n        FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\n        COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\n        IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\n        CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - ms@2.1.3\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2020 Vercel, Inc.\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - mui-chips-input@2.1.5\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2022 Victor de la Fouchardi\u00e8re\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - nanoid@3.3.8\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright 2017 Andrey Sitnik <andrey@sitnik.ru>\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy of\n        this software and associated documentation files (the \"Software\"), to deal in\n        the Software without restriction, including without limitation the rights to\n        use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\n        the Software, and to permit persons to whom the Software is furnished to do so,\n        subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\n        FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\n        COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\n        IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\n        CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - object-assign@4.1.1\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n        THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - parse-srcset@1.0.2\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2014 Alex Bell\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - path-browserify@1.0.1\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2013 James Halliday\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy of\n        this software and associated documentation files (the \"Software\"), to deal in\n        the Software without restriction, including without limitation the rights to\n        use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\n        the Software, and to permit persons to whom the Software is furnished to do so,\n        subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\n        FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\n        COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\n        IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\n        CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - path-parse@1.0.7\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2015 Javier Blanco\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - picocolors@1.1.1\n        \n        This package contains the following license and notice below:\n        \n        ISC License\n        \n        Copyright (c) 2021-2024 Oleksii Raspopov, Kostiantyn Denysov, Anton Verinov\n        \n        Permission to use, copy, modify, and/or distribute this software for any\n        purpose with or without fee is hereby granted, provided that the above\n        copyright notice and this permission notice appear in all copies.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES\n        WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF\n        MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR\n        ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES\n        WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN\n        ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF\n        OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - postcss@8.5.1\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright 2013 Andrey Sitnik <andrey@sitnik.ru>\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy of\n        this software and associated documentation files (the \"Software\"), to deal in\n        the Software without restriction, including without limitation the rights to\n        use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\n        the Software, and to permit persons to whom the Software is furnished to do so,\n        subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\n        FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\n        COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\n        IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\n        CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - property-expr@2.0.6\n         - yup@1.6.1\n        \n        These packages each contain the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2014 Jason Quense\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - querystringify@2.2.0\n         - requires-port@1.0.0\n         - url-parse@1.5.10\n        \n        These packages each contain the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2015 Unshift.io, Arnout Kazemier,  the Contributors.\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - rc-cascader@3.33.0\n         - rc-select@14.16.6\n        \n        These packages each contain the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2014-present alipay.com\n        \n        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:\n        \n        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n        \n        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.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - rc-checkbox@3.5.0\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT) Copyright (c) 2016 React Components\n        \n        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:\n        \n        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n        \n        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.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - rc-drawer@7.2.0\n         - rc-tree-select@5.27.0\n         - rc-tree@5.13.0\n        \n        These packages each contain the following license and notice below:\n        \n        MIT LICENSE\n        \n        Copyright (c) 2015-present Alipay.com, https://www.alipay.com/\n        \n        Permission is hereby granted, free of charge, to any person obtaining\n        a copy of this software and associated documentation files (the\n        \"Software\"), to deal in the Software without restriction, including\n        without limitation the rights to use, copy, modify, merge, publish,\n        distribute, sublicense, and/or sell copies of the Software, and to\n        permit persons to whom the Software is furnished to do so, subject to\n        the following conditions:\n        \n        The above copyright notice and this permission notice shall be\n        included in all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n        EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\n        MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n        NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE\n        LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION\n        OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION\n        WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - rc-image@7.11.0\n         - rc-table@7.50.2\n        \n        These packages each contain the following license and notice below:\n        \n        MIT LICENSE\n        \n        Copyright (c) 2015-present Alipay.com, https://www.alipay.com/\n        \n        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:\n        \n        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n        \n        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.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - rc-tooltip@6.3.2\n         - rc-virtual-list@3.18.1\n        \n        These packages each contain the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2015-present Alipay.com, https://www.alipay.com/\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS \n        OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF \n        MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. \n        IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY \n        CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, \n        TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE \n        SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - rc-upload@4.8.1\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2016-present react-component\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS \n        OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF \n        MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. \n        IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY \n        CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, \n        TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE \n        SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - rc-util@5.44.3\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2014-present yiminghe\n        Copyright (c) 2015-present Alipay.com, https://www.alipay.com/\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS \n        OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF \n        MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. \n        IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY \n        CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, \n        TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE \n        SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - react-arborist@3.4.0\n        \n        This package contains the following license and notice below:\n        \n        ![Logo](https://user-images.githubusercontent.com/3460638/161630636-3512fe81-41c2-4ee5-8f7e-adaad07033b6.svg)\n        \n        <h1>React Arborist</h1>\n        \n        [See the Demos](https://react-arborist.netlify.app/)\n        \n        The tree view is ubiquitous in software applications. This library provides the React ecosystem with a complete solution to build the equivalent of a VSCode sidebar, Mac Finder, Windows Explorer, or Sketch/Figma layers panel.\n        \n        Here is a Gmail sidebar clone built with react-arborist.\n        \n        <img src=\"https://user-images.githubusercontent.com/3460638/197306119-59fe59e6-50ae-4bc2-8cb9-3faa2bc52cd2.gif\" width=\"270px\" alt=\"Gmail sidebar clone built with react-arborist\" />\n        \n        ## Features\n        \n        - Drag and drop sorting\n        - Open/close folders\n        - Inline renaming\n        - Virtualized rendering\n        - Custom styling\n        - Keyboard navigation\n        - Aria attributes\n        - Tree filtering\n        - Selection synchronization\n        - Callbacks (onScroll, onActivate, onSelect)\n        - Controlled or uncontrolled trees\n        \n        ## Installation\n        \n        ```\n        yarn add react-arborist\n        ```\n        \n        ```\n        npm install react-arborist\n        ```\n        \n        ## Examples\n        \n        Assume our data is this:\n        \n        ```js\n        const data = [\n          { id: \"1\", name: \"Unread\" },\n          { id: \"2\", name: \"Threads\" },\n          {\n            id: \"3\",\n            name: \"Chat Rooms\",\n            children: [\n              { id: \"c1\", name: \"General\" },\n              { id: \"c2\", name: \"Random\" },\n              { id: \"c3\", name: \"Open Source Projects\" },\n            ],\n          },\n          {\n            id: \"4\",\n            name: \"Direct Messages\",\n            children: [\n              { id: \"d1\", name: \"Alice\" },\n              { id: \"d2\", name: \"Bob\" },\n              { id: \"d3\", name: \"Charlie\" },\n            ],\n          },\n        ];\n        ```\n        \n        ### The Simplest Tree\n        \n        Use all the defaults. The _initialData_ prop makes the tree an uncontrolled component. Create, move, rename, and delete will be handled internally.\n        \n        ```jsx\n        function App() {\n          return <Tree initialData={data} />;\n        }\n        ```\n        \n        <img width=\"214\" alt=\"image\" src=\"https://user-images.githubusercontent.com/3460638/198098015-d7dc6400-6391-4094-9f66-0f56a99433e9.png\">\n        \n        [Demo](https://codesandbox.io/s/the-simplest-tree-7tbedw)\n        \n        ### Customize the Appearance\n        \n        We provide our own dimensions and our own `Node` component.\n        \n        ```jsx\n        function App() {\n          return (\n            <Tree\n              initialData={data}\n              openByDefault={false}\n              width={600}\n              height={1000}\n              indent={24}\n              rowHeight={36}\n              overscanCount={1}\n              paddingTop={30}\n              paddingBottom={10}\n              padding={25 /* sets both */}\n            >\n              {Node}\n            </Tree>\n          );\n        }\n        \n        function Node({ node, style, dragHandle }) {\n          /* This node instance can do many things. See the API reference. */\n          return (\n            <div style={style} ref={dragHandle}>\n              {node.isLeaf ? \"\ud83c\udf41\" : \"\ud83d\uddc0\"}\n              {node.data.name}\n            </div>\n          );\n        }\n        ```\n        \n        <img width=\"166\" alt=\"image\" src=\"https://user-images.githubusercontent.com/3460638/198100281-594a492d-2ea0-4ff0-883d-1dd79dbb5acd.png\">\n        \n        [Demo](https://codesandbox.io/s/customize-appearance-f4g15v?file=/src/App.tsx)\n        \n        ### Control the Tree data\n        \n        Here we use the _data_ prop to make the tree a controlled component. We must handle all the data modifications ourselves using the props below.\n        \n        ```jsx\n        function App() {\n          /* Handle the data modifications outside the tree component */\n          const onCreate = ({ parentId, index, type }) => {};\n          const onRename = ({ id, name }) => {};\n          const onMove = ({ dragIds, parentId, index }) => {};\n          const onDelete = ({ ids }) => {};\n        \n          return (\n            <Tree\n              data={data}\n              onCreate={onCreate}\n              onRename={onRename}\n              onMove={onMove}\n              onDelete={onDelete}\n            />\n          );\n        }\n        ```\n        \n        ### Tree Filtering\n        \n        Providing a non-empty _searchTerm_ will only show nodes that match. If a child matches, all its parents also match. Internal nodes are opened when filtering. You can provide your own _searchMatch_ function, or use the default.\n        \n        ```jsx\n        function App() {\n          const term = useSearchTermString()\n          <Tree\n            data={data}\n            searchTerm={term}\n            searchMatch={\n              (node, term) => node.data.name.toLowerCase().includes(term.toLowerCase())\n            }\n          />\n        }\n        ```\n        \n        ### Sync the Selection\n        \n        It's common to open something elsewhere in the app, but have the tree reflect the new selection.\n        \n        Passing an id to the _selection_ prop will select and scroll to that node whenever that id changes.\n        \n        ```jsx\n        function App() {\n          const chatId = useCurrentChatId();\n        \n          /* \n            Whenever the currentChatRoomId changes, \n            the tree will automatically select it and scroll to it. \n          */\n        \n          return <Tree initialData={data} selection={chatId} />;\n        }\n        ```\n        \n        ### Use the Tree Api Instance\n        \n        You can access the Tree Api in the parent component by giving a ref to the tree.\n        \n        ```jsx\n        function App() {\n          const treeRef = useRef();\n        \n          useEffect(() => {\n            const tree = treeRef.current;\n            tree.selectAll();\n            /* See the Tree API reference for all you can do with it. */\n          }, []);\n        \n          return <Tree initialData={data} ref={treeRef} />;\n        }\n        ```\n        \n        ### Data with Different Property Names\n        \n        The _idAccessor_ and _childrenAccessor_ props allow you to specify the children and id fields in your data.\n        \n        ```jsx\n        function App() {\n          const data = [\n            {\n              category: \"Food\",\n              subCategories: [{ category: \"Restaurants\" }, { category: \"Groceries\" }],\n            },\n          ];\n          return (\n            <Tree\n              data={data}\n              /* An accessor can provide a string property name */\n              idAccessor=\"category\"\n              /* or a function with the data as the argument */\n              childrenAccessor={(d) => d.subCategories}\n            />\n          );\n        }\n        ```\n        \n        ### Custom Rendering\n        \n        Render every single piece of the tree yourself. See the API reference for the props passed to each renderer.\n        \n        ```jsx\n        function App() {\n          return (\n            <Tree\n              data={data}\n              /* The outer most element in the list */\n              renderRow={MyRow}\n              /* The \"ghost\" element that follows the mouse as you drag */\n              renderDragPreview={MyDragPreview}\n              /* The line that shows where an element will be dropped */\n              renderCursor={MyCursor}\n            >\n              {/* The inner element that shows the indentation and data */}\n              {MyNode}\n            </Tree>\n          );\n        }\n        ```\n        \n        ## API Reference\n        \n        - Components\n          - [Tree Component Props](#tree-component-props)\n          - [Row Component Props](#row-component-props)\n          - [Node Component Props](#node-component-props)\n          - [DragPreview Component Props](#dragpreview-component-props)\n          - [Cursor Component Props](#cursor-component-props)\n        - Interfaces\n          - [Node API](#node-api-reference)\n          - [Tree API](#tree-api-reference)\n        \n        ## Tree Component Props\n        \n        These are all the props you can pass to the Tree component.\n        \n        ```ts\n        interface TreeProps<T> {\n          /* Data Options */\n          data?: readonly T[];\n          initialData?: readonly T[];\n        \n          /* Data Handlers */\n          onCreate?: handlers.CreateHandler<T>;\n          onMove?: handlers.MoveHandler<T>;\n          onRename?: handlers.RenameHandler<T>;\n          onDelete?: handlers.DeleteHandler<T>;\n        \n          /* Renderers*/\n          children?: ElementType<renderers.NodeRendererProps<T>>;\n          renderRow?: ElementType<renderers.RowRendererProps<T>>;\n          renderDragPreview?: ElementType<renderers.DragPreviewProps>;\n          renderCursor?: ElementType<renderers.CursorProps>;\n          renderContainer?: ElementType<{}>;\n        \n          /* Sizes */\n          rowHeight?: number;\n          overscanCount?: number;\n          width?: number | string;\n          height?: number;\n          indent?: number;\n          paddingTop?: number;\n          paddingBottom?: number;\n          padding?: number;\n        \n          /* Config */\n          childrenAccessor?: string | ((d: T) => T[] | null);\n          idAccessor?: string | ((d: T) => string);\n          openByDefault?: boolean;\n          selectionFollowsFocus?: boolean;\n          disableMultiSelection?: boolean;\n          disableEdit?: string | boolean | BoolFunc<T>;\n          disableDrag?: string | boolean | BoolFunc<T>;\n          disableDrop?:\n            | string\n            | boolean\n            | ((args: {\n                parentNode: NodeApi<T>;\n                dragNodes: NodeApi<T>[];\n                index: number;\n              }) => boolean);\n        \n          /* Event Handlers */\n          onActivate?: (node: NodeApi<T>) => void;\n          onSelect?: (nodes: NodeApi<T>[]) => void;\n          onScroll?: (props: ListOnScrollProps) => void;\n          onToggle?: (id: string) => void;\n          onFocus?: (node: NodeApi<T>) => void;\n        \n          /* Selection */\n          selection?: string;\n        \n          /* Open State */\n          initialOpenState?: OpenMap;\n        \n          /* Search */\n          searchTerm?: string;\n          searchMatch?: (node: NodeApi<T>, searchTerm: string) => boolean;\n        \n          /* Extra */\n          className?: string | undefined;\n          rowClassName?: string | undefined;\n        \n          dndRootElement?: globalThis.Node | null;\n          onClick?: MouseEventHandler;\n          onContextMenu?: MouseEventHandler;\n          dndManager?: DragDropManager;\n        }\n        ```\n        \n        ## Row Component Props\n        \n        The _\\<RowRenderer\\>_ is responsible for attaching the drop ref, the row style (top, height) and the aria-attributes. The default should work fine for most use cases, but it can be replaced by your own component if you need. See the _renderRow_ prop in the _\\<Tree\\>_ component.\n        \n        ```ts\n        type RowRendererProps<T> = {\n          node: NodeApi<T>;\n          innerRef: (el: HTMLDivElement | null) => void;\n          attrs: HTMLAttributes<any>;\n          children: ReactElement;\n        };\n        ```\n        \n        ## Node Component Props\n        \n        The _\\<NodeRenderer\\>_ is responsible for attaching the drag ref, the node style (padding for indentation), the visual look of the node, the edit input of the node, and anything else you can dream up.\n        \n        There is a default renderer, but it's only there as a placeholder to get started. You'll want to create your own component for this. It is passed as the _\\<Tree\\>_ components only child.\n        \n        ```ts\n        export type NodeRendererProps<T> = {\n          style: CSSProperties;\n          node: NodeApi<T>;\n          tree: TreeApi<T>;\n          dragHandle?: (el: HTMLDivElement | null) => void;\n          preview?: boolean;\n        };\n        ```\n        \n        ## DragPreview Component Props\n        \n        The _\\<DragPreview\\>_ is responsible for showing a \"ghost\" version of the node being dragged. The default is a semi-transparent version of the NodeRenderer and should work fine for most people. To customize it, pass your new component to the _renderDragPreview_ prop.\n        \n        ```ts\n        type DragPreviewProps = {\n          offset: XYCoord | null;\n          mouse: XYCoord | null;\n          id: string | null;\n          dragIds: string[];\n          isDragging: boolean;\n        };\n        ```\n        \n        ## Cursor Component Props\n        \n        The _\\<Cursor\\>_ is responsible for showing a line that indicates where the node will move to when it's dropped. The default is a blue line with circle on the left side. You may want to customize this. Pass your own component to the _renderCursor_ prop.\n        \n        ```ts\n        export type CursorProps = {\n          top: number;\n          left: number;\n          indent: number;\n        };\n        ```\n        \n        ## Node API Reference\n        \n        ### State Properties\n        \n        All these properties on the node instance return booleans related to the state of the node.\n        \n        _node_.**isRoot**\n        \n        Returns true if this is the root node. The root node is added internally by react-arborist and not shown in the UI.\n        \n        _node_.**isLeaf**\n        \n        Returns true if the children property is not an array.\n        \n        _node_.**isInternal**\n        \n        Returns true if the children property is an array.\n        \n        _node_.**isOpen**\n        \n        Returns true if node is internal and in an open state.\n        \n        _node_.**isEditing**\n        \n        Returns true if this node is currently being edited. Use this property in the NodeRenderer to render the rename form.\n        \n        _node_.**isSelected**\n        \n        Returns true if node is selected.\n        \n        _node_.**isSelectedStart**\n        \n        Returns true if node is the first of a contiguous group of selected nodes. Useful for styling.\n        \n        _node_.**isSelectedEnd**\n        \n        Returns true if node is the last of a contiguous group of selected nodes. Useful for styling.\n        \n        _node_.**isOnlySelection**\n        \n        Returns true if node is the only node selected in the tree.\n        \n        _node_.**isFocused**\n        \n        Returns true if node is focused.\n        \n        _node_.**isDragging**\n        \n        Returns true if node is being dragged.\n        \n        _node_.**willReceiveDrop**\n        \n        Returns true if node is internal and the user is hovering a dragged node over it.\n        \n        _node_.**state**\n        \n        Returns an object with all the above properties as keys and boolean values. Useful for adding class names to an element with a library like [clsx](https://github.com/lukeed/clsx) or [classnames](https://github.com/JedWatson/classnames).\n        \n        ```ts\n        type NodeState = {\n          isEditing: boolean;\n          isDragging: boolean;\n          isSelected: boolean;\n          isSelectedStart: boolean;\n          isSelectedEnd: boolean;\n          isFocused: boolean;\n          isOpen: boolean;\n          isClosed: boolean;\n          isLeaf: boolean;\n          isInternal: boolean;\n          willReceiveDrop: boolean;\n        };\n        ```\n        \n        ### Accessors\n        \n        _node_.**childIndex**\n        \n        Returns the node's index in relation to its siblings.\n        \n        _node_.**next**\n        \n        Returns the next visible node. The node directly under this node in the tree component. Returns null if none exist.\n        \n        _node_.**prev**\n        \n        Returns the previous visible node. The node directly above this node in the tree component. Returns null if none exist.\n        \n        _node_.**nextSibling**\n        \n        Returns the next sibling in the data of this node. Returns null if none exist.\n        \n        ### Selection Methods\n        \n        _node_.**select**()\n        \n        Select only this node.\n        \n        _node_.**deselect**()\n        \n        Deselect this node. Other nodes may still be selected.\n        \n        _node_.**selectMulti**()\n        \n        Select this node while maintaining all other selections.\n        \n        _node_.**selectContiguous**()\n        \n        Deselect all nodes from the anchor node to the last selected node, the select all nodes from the anchor node to this node. The anchor changes to the focused node after calling _select()_ or _selectMulti()_.\n        \n        ### Activation Methods\n        \n        _node_.**activate**()\n        \n        Runs the Tree props' onActivate callback passing in this node.\n        \n        _node_.**focus**()\n        \n        Focus this node.\n        \n        ### Open/Close Methods\n        \n        _node_.**open**()\n        \n        Opens the node if it is an internal node.\n        \n        _node_.**close**()\n        \n        Closes the node if it is an internal node.\n        \n        _node_.**toggle**()\n        \n        Toggles the open/closed state of the node if it is an internal node.\n        \n        _node_.**openParents**()\n        \n        Opens all the parents of this node.\n        \n        _node_.**edit**()\n        \n        Moves this node into the editing state. Calling node._isEditing_ will return true.\n        \n        _node_.**submit**(_newName_)\n        \n        Submits _newName_ string to the _onRename_ handler. Moves this node out of the editing state.\n        \n        _node_.**reset**()\n        \n        Moves this node out of the editing state without submitting a new name.\n        \n        ### Event Handlers\n        \n        _node_.**handleClick**(_event_)\n        \n        Useful for using the standard selection methods when a node is clicked. If the meta key is down, call _multiSelect()_. If the shift key is down, call _selectContiguous()_. Otherwise, call _select()_ and _activate()_.\n        \n        ## Tree API Reference\n        \n        The tree api reference is stable across re-renders. It always has the most recent state and props.\n        \n        ### Node Accessors\n        \n        _tree_.**get**(_id_) : _NodeApi | null_\n        \n        Get node by id from the _visibleNodes_ array.\n        \n        _tree_.**at**(_index_) : _NodeApi | null_\n        \n        Get node by index from the _visibleNodes_ array.\n        \n        _tree_.**visibleNodes** : _NodeApi[]_\n        \n        Returns an array of the visible nodes.\n        \n        _tree_.**firstNode** : _NodeApi | null_\n        \n        The first node in the _visibleNodes_ array.\n        \n        _tree_.**lastNode** : _NodeApi | null_\n        \n        The last node in the _visibleNodes_ array.\n        \n        _tree_.**focusedNode** : _NodeApi | null_\n        \n        The currently focused node.\n        \n        _tree_.**mostRecentNode** : _NodeApi | null_\n        \n        The most recently selected node.\n        \n        _tree_.**nextNode** : _NodeApi | null_\n        \n        The node directly after the _focusedNode_ in the _visibleNodes_ array.\n        \n        _tree_.**prevNode** : _NodeApi | null_\n        \n        The node directly before the _focusedNode_ in the _visibleNodes_ array.\n        \n        ### Focus Methods\n        \n        _tree_.**hasFocus** : _boolean_\n        \n        Returns true if the the tree has focus somewhere within it.\n        \n        _tree_.**focus**(_id_)\n        \n        Focus on the node with _id_.\n        \n        _tree_.**isFocused**(_id_) : _boolean_\n        \n        Check if the node with _id_ is focused.\n        \n        _tree_.**pageUp**()\n        \n        Move focus up one page.\n        \n        _tree_.**pageDown**()\n        \n        Move focus down one page.\n        \n        ### Selection Methods\n        \n        _tree_.**selectedIds** : _Set\\<string\\>_\n        \n        Returns a set of ids that are selected.\n        \n        _tree_.**selectedNodes** : _NodeApi[]_\n        \n        Returns an array of nodes that are selected.\n        \n        _tree_.**hasNoSelection** : boolean\n        \n        Returns true if nothing is selected in the tree.\n        \n        _tree_.**hasSingleSelection** : boolean\n        \n        Returns true if there is only one selection.\n        \n        _tree_.**hasMultipleSelections** : boolean\n        \n        Returns true if there is more than one selection.\n        \n        _tree_.**isSelected**(_id_) : _boolean_\n        \n        Returns true if the node with _id_ is selected.\n        \n        _tree_.**select**(_id_)\n        \n        Select only the node with _id_.\n        \n        _tree_.**deselect**(_id_)\n        \n        Deselect the node with _id_.\n        \n        _tree_.**selectMulti**(_id_)\n        \n        Add to the selection the node with _id_.\n        \n        _tree_.**selectContiguous**(_id_)\n        \n        Deselected nodes between the anchor and the last selected node, then select the nodes between the anchor and the node with _id_.\n        \n        _tree_.**deselectAll**()\n        \n        Deselect all nodes.\n        \n        _tree_.**selectAll**()\n        \n        Select all nodes.\n        \n        ### Visibility\n        \n        _tree_.**open**(_id_)\n        \n        Open the node with _id_.\n        \n        _tree_.**close**(_id_)\n        \n        Close the node with _id_.\n        \n        _tree_.**toggle**(_id_)\n        \n        Toggle the open state of the node with _id_.\n        \n        _tree_.**openParents**(_id_)\n        \n        Open all parents of the node with _id_.\n        \n        _tree_.**openSiblings**(_id_)\n        \n        Open all siblings of the node with _id_.\n        \n        _tree_.**openAll**()\n        \n        Open all internal nodes.\n        \n        _tree_.**closeAll**()\n        \n        Close all internal nodes.\n        \n        _tree_.**isOpen**(_id_) : _boolean_\n        \n        Returns true if the node with _id_ is open.\n        \n        ### Drag and Drop\n        \n        _tree_.**isDragging**(_id_) : _boolean_\n        \n        Returns true if the node with _id_ is being dragged.\n        \n        _tree_.**willReceiveDrop**(_id_) : _boolean_\n        \n        Returns true if the node with _id_ is internal and is under the dragged node.\n        \n        ### Scrolling\n        \n        _tree_.**scrollTo**(_id_, _[align]_)\n        \n        Scroll to the node with _id_. If this node is not visible, this method will open all its parents. The align argument can be _\"auto\" | \"smart\" | \"center\" | \"end\" | \"start\"_.\n        \n        ### Properties\n        \n        _tree_.**isEditing** : _boolean_\n        \n        Returns true if the tree is editing a node.\n        \n        _tree_.**isFiltered** : _boolean_\n        \n        Returns true if the _searchTerm_ prop is not an empty string when trimmed.\n        \n        _tree_.**props** : _TreeProps_\n        \n        Returns all the props that were passed to the _\\<Tree\\>_ component.\n        \n        _tree_.**root** : _NodeApi_\n        \n        Returns the root _NodeApi_ instance. Its children are the Node representations of the _data_ prop array.\n        \n        ## Author\n        \n        [James Kerr](https://twitter.com/specialCaseDev) at [Brim Data](https://brimdata.io) for the [Zui desktop app](https://www.youtube.com/watch?v=I2y663n8d2A).\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - react-dnd@14.0.5\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2016 Dan Abramov\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - react-dom@18.3.1\n         - react-is@16.13.1\n         - react-is@18.3.1\n         - react@18.3.1\n         - scheduler@0.23.2\n        \n        These packages each contain the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) Facebook, Inc. and its affiliates.\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - react-is@19.0.0\n         - use-sync-external-store@1.4.0\n        \n        These packages each contain the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) Meta Platforms, Inc. and affiliates.\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - react-js-cron@5.0.1\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) Xavier Rutayisire\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy of\n        this software and associated documentation files (the \"Software\"), to deal in\n        the Software without restriction, including without limitation the rights to\n        use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\n        the Software, and to permit persons to whom the Software is furnished to do so,\n        subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\n        FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\n        COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\n        IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\n        CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - react-spinners@0.13.8\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2017 David Hu\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n        THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - react-table@7.8.0\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2016 Tanner Linsley\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - react-toastify@9.1.3\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2023 Fadi Khadra\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - react-transition-group@4.4.5\n        \n        This package contains the following license and notice below:\n        \n        BSD 3-Clause License\n        \n        Copyright (c) 2018, React Community\n        Forked from React (https://github.com/facebook/react) Copyright 2013-present, Facebook, Inc.\n        All rights reserved.\n        \n        Redistribution and use in source and binary forms, with or without\n        modification, are permitted provided that the following conditions are met:\n        \n        * Redistributions of source code must retain the above copyright notice, this\n          list of conditions and the following disclaimer.\n        \n        * Redistributions in binary form must reproduce the above copyright notice,\n          this list of conditions and the following disclaimer in the documentation\n          and/or other materials provided with the distribution.\n        \n        * Neither the name of the copyright holder nor the names of its\n          contributors may be used to endorse or promote products derived from\n          this software without specific prior written permission.\n        \n        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\"\n        AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\n        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\n        DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE\n        FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\n        DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR\n        SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER\n        CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,\n        OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\n        OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - react-window@1.8.11\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2018 Brian Vaughn\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - redux@4.2.1\n         - redux@5.0.1\n        \n        These packages each contain the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2015-present Dan Abramov\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - regenerator-runtime@0.14.1\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2014-present, Facebook, Inc.\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - require-from-string@2.0.2\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) Vsevolod Strukchinsky <floatdrop@gmail.com> (github.com/floatdrop)\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n        THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - resize-observer-polyfill@1.5.1\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2016 Denis Rul\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - resolve@1.22.10\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2012 James Halliday\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - sanitize-html@2.12.1\n        \n        This package contains the following license and notice below:\n        \n        Copyright (c) 2013, 2014, 2015 P'unk Avenue LLC\n        \n        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:\n        \n        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n        \n        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.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - scroll-into-view-if-needed@3.1.0\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2023 Cody Olsen\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - source-map-js@1.2.1\n         - source-map@0.5.7\n        \n        These packages each contain the following license and notice below:\n        \n        Copyright (c) 2009-2011, Mozilla Foundation and contributors\n        All rights reserved.\n        \n        Redistribution and use in source and binary forms, with or without\n        modification, are permitted provided that the following conditions are met:\n        \n        * Redistributions of source code must retain the above copyright notice, this\n          list of conditions and the following disclaimer.\n        \n        * Redistributions in binary form must reproduce the above copyright notice,\n          this list of conditions and the following disclaimer in the documentation\n          and/or other materials provided with the distribution.\n        \n        * Neither the names of the Mozilla Foundation nor the names of project\n          contributors may be used to endorse or promote products derived from this\n          software without specific prior written permission.\n        \n        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND\n        ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED\n        WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\n        DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE\n        FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\n        DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR\n        SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER\n        CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,\n        OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\n        OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - string-convert@0.2.1\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2014 Kiran Abburi\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - stylis@4.2.0\n         - stylis@4.3.5\n        \n        These packages each contain the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2016-present Sultan Tarimo\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - supports-preserve-symlinks-flag@1.0.0\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2022 Inspect JS\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - throttle-debounce@5.0.2\n        \n        This package contains the following license and notice below:\n        \n        Copyright (c) Ivan Nikoli\u0107 <http://ivannikolic.com>\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n        THE SOFTWARE.\n        \n        ---\n        \n        Copyright (c) 2010 \"Cowboy\" Ben Alman\n        \n        Permission is hereby granted, free of charge, to any person\n        obtaining a copy of this software and associated documentation\n        files (the \"Software\"), to deal in the Software without\n        restriction, including without limitation the rights to use,\n        copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the\n        Software is furnished to do so, subject to the following\n        conditions:\n        \n        The above copyright notice and this permission notice shall be\n        included in all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n        EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES\n        OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n        NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT\n        HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,\n        WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n        FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\n        OTHER DEALINGS IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - tiny-case@1.0.3\n        \n        This package contains the following license and notice below:\n        \n        # tiny-case\n        \n        Extremely minimal string casing utilities that mimic most of lodash's casing behavior, e.g.\n        numbers are considered seperate \"words\".\n        \n        ```sh\n        npm i tiny-case\n        ```\n        \n        ## Usage\n        \n        ```js\n        import {\n          camelCase,\n          pascalCase,\n          snakeCase,\n          kebabCase,\n          titleCase,\n          sentenceCase,\n          words,\n          upperFirst,\n        } from 'tiny-case'\n        \n        words('hi-there john') // ['hi', 'there', 'john']\n        words('   1ApplePlease  ') // ['1', 'Apple', 'Please']\n        ```\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - toggle-selection@1.0.6\n        \n        This package contains the following license and notice below:\n        \n        # Toggle Selection\n        \n        Simple module exposing function that deselects current browser selection and returns function that restores selection.\n        \n        ```\n        var deselect = require('toggle-selection');\n        var reselect = deselect(); // remove all selection\n        // \u2026 \n        // do something with current selection, text, etc;\n        // \u2026\n        reselect(); // restore selection\n        ```\n        \n        All credits go to [@shvaikalesh](https://github.com/shvaikalesh).\n        \n        # [Example](https://github.com/sudodoki/toggle-selection/blob/master/example)\n        \n        ![example recording](http://g.recordit.co/YPu6mHvcKe.gif)\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - toposort@2.0.2\n        \n        This package contains the following license and notice below:\n        \n        Toposort - Topological sorting for node.js\n        Copyright (c) 2012 by Marcel Klehr <mklehr@gmx.net>\n        MIT LICENSE\n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n        THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - tslib@1.14.1\n        \n        This package contains the following license and notice below:\n        \n        Copyright (c) Microsoft Corporation.\n        \n        Permission to use, copy, modify, and/or distribute this software for any\n        purpose with or without fee is hereby granted.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH\n        REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY\n        AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,\n        INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM\n        LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR\n        OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR\n        PERFORMANCE OF THIS SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - type-fest@2.19.0\n        \n        This package contains the following license and notice below:\n        \n        <div align=\"center\">\n        \t<br>\n        \t<br>\n        \t<img src=\"media/logo.svg\" alt=\"type-fest\" height=\"300\">\n        \t<br>\n        \t<br>\n        \t<b>A collection of essential TypeScript types</b>\n        \t<br>\n        \t<br>\n        \t<br>\n        \t<br>\n        \t<hr>\n        \t<div align=\"center\">\n        \t\t<p>\n        \t\t\t<p>\n        \t\t\t\t<sup>\n        \t\t\t\t\t<a href=\"https://github.com/sponsors/sindresorhus\">Sindre Sorhus' open source work is supported by the community</a>\n        \t\t\t\t</sup>\n        \t\t\t</p>\n        \t\t\t<sup>Special thanks to:</sup>\n        \t\t\t<br>\n        \t\t\t<br>\n        \t\t\t<a href=\"https://standardresume.co/tech\">\n        \t\t\t\t<img src=\"https://sindresorhus.com/assets/thanks/standard-resume-logo.svg\" width=\"180\"/>\n        \t\t\t</a>\n        \t\t\t<br>\n        \t\t\t<br>\n        \t\t\t<br>\n        \t\t\t<a href=\"https://workos.com/?utm_campaign=github_repo&utm_medium=referral&utm_content=type-fest&utm_source=github\">\n        \t\t\t\t<div>\n        \t\t\t\t\t<img src=\"https://sindresorhus.com/assets/thanks/workos-logo-white-bg.svg\" width=\"220\" alt=\"WorkOS\">\n        \t\t\t\t</div>\n        \t\t\t\t<b>Your app, enterprise-ready.</b>\n        \t\t\t\t<div>\n        \t\t\t\t\t<sub>Start selling to enterprise customers with just a few lines of code.</sub>\n        \t\t\t\t\t<br>\n        \t\t\t\t\t<sup>Add Single Sign-On (and more) in minutes instead of months.</sup>\n        \t\t\t\t</div>\n        \t\t\t</a>\n        \t\t\t<br>\n        \t\t\t<br>\n        \t\t\t<br>\n        \t\t\t<a href=\"https://www.useanvil.com/?utm_source=sindresorhus#gh-light-mode-only\">\n        \t\t\t\t<div>\n        \t\t\t\t\t<img src=\"https://sindresorhus.com/assets/thanks/anvil-logo-light.svg\" width=\"200\" alt=\"Anvil\">\n        \t\t\t\t</div>\n        \t\t\t\t<br>\n        \t\t\t\t<b>Paperwork that makes the data work.</b>\n        \t\t\t\t<div>\n        \t\t\t\t\t<sub>\n        \t\t\t\t\tEasy APIs for paperwork. PDF generation, e-signature and embeddable no-code webforms.\n        \t\t\t\t\t<br>\n        \t\t\t\t\tThe easiest way to build paperwork automation into your product.\n        \t\t\t\t\t</sub>\n        \t\t\t\t</div>\n        \t\t\t</a>\n        \t\t\t<a href=\"https://www.useanvil.com/?utm_source=sindresorhus#gh-dark-mode-only\">\n        \t\t\t\t<div>\n        \t\t\t\t\t<img src=\"https://sindresorhus.com/assets/thanks/anvil-logo-dark.svg\" width=\"200\" alt=\"Anvil\">\n        \t\t\t\t</div>\n        \t\t\t\t<br>\n        \t\t\t\t<b>Paperwork that makes the data work.</b>\n        \t\t\t\t<div>\n        \t\t\t\t\t<sub>\n        \t\t\t\t\tEasy APIs for paperwork. PDF generation, e-signature and embeddable no-code webforms.\n        \t\t\t\t\t<br>\n        \t\t\t\t\tThe easiest way to build paperwork automation into your product.\n        \t\t\t\t\t</sub>\n        \t\t\t\t</div>\n        \t\t\t</a>\n        \t\t</p>\n        \t</div>\n        \t<br>\n        \t<hr>\n        </div>\n        <br>\n        <br>\n        \n        [![](https://img.shields.io/badge/unicorn-approved-ff69b4.svg)](https://giphy.com/gifs/illustration-rainbow-unicorn-26AHG5KGFxSkUWw1i)\n        [![npm dependents](https://badgen.net/npm/dependents/type-fest)](https://www.npmjs.com/package/type-fest?activeTab=dependents)\n        [![npm downloads](https://badgen.net/npm/dt/type-fest)](https://www.npmjs.com/package/type-fest)\n        [![Docs](https://paka.dev/badges/v0/cute.svg)](https://paka.dev/npm/type-fest)\n        \n        Many of the types here should have been built-in. You can help by suggesting some of them to the [TypeScript project](https://github.com/Microsoft/TypeScript/blob/main/CONTRIBUTING.md).\n        \n        Either add this package as a dependency or copy-paste the needed types. No credit required. \ud83d\udc4c\n        \n        PR welcome for additional commonly needed types and docs improvements. Read the [contributing guidelines](.github/contributing.md) first.\n        \n        **Help wanted with reviewing [proposals](https://github.com/sindresorhus/type-fest/issues) and [pull requests](https://github.com/sindresorhus/type-fest/pulls).**\n        \n        ## Install\n        \n        ```sh\n        npm install type-fest\n        ```\n        \n        *Requires TypeScript >=4.2*\n        \n        ## Usage\n        \n        ```ts\n        import type {Except} from 'type-fest';\n        \n        type Foo = {\n        \tunicorn: string;\n        \trainbow: boolean;\n        };\n        \n        type FooWithoutRainbow = Except<Foo, 'rainbow'>;\n        //=> {unicorn: string}\n        ```\n        \n        ## API\n        \n        Click the type names for complete docs.\n        \n        ### Basic\n        \n        - [`Primitive`](source/primitive.d.ts) - Matches any [primitive value](https://developer.mozilla.org/en-US/docs/Glossary/Primitive).\n        - [`Class`](source/basic.d.ts) - Matches a [`class`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes).\n        - [`Constructor`](source/basic.d.ts) - Matches a [`class` constructor](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes).\n        - [`TypedArray`](source/typed-array.d.ts) - Matches any [typed array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray), like `Uint8Array` or `Float64Array`.\n        - [`ObservableLike`](source/observable-like.d.ts) - Matches a value that is like an [Observable](https://github.com/tc39/proposal-observable).\n        \n        ### Utilities\n        \n        - [`Except`](source/except.d.ts) - Create a type from an object type without certain keys. This is a stricter version of [`Omit`](https://www.typescriptlang.org/docs/handbook/utility-types.html#omittype-keys).\n        - [`Writable`](source/writable.d.ts) - Create a type that strips `readonly` from all or some of an object's keys. The inverse of `Readonly<T>`. Formerly named `Mutable`.\n        - [`Merge`](source/merge.d.ts) - Merge two types into a new type. Keys of the second type overrides keys of the first type.\n        - [`MergeExclusive`](source/merge-exclusive.d.ts) - Create a type that has mutually exclusive keys.\n        - [`RequireAtLeastOne`](source/require-at-least-one.d.ts) - Create a type that requires at least one of the given keys.\n        - [`RequireExactlyOne`](source/require-exactly-one.d.ts) - Create a type that requires exactly a single key of the given keys and disallows more.\n        - [`RequireAllOrNone`](source/require-all-or-none.d.ts) - Create a type that requires all of the given keys or none of the given keys.\n        - [`RemoveIndexSignature`](source/remove-index-signature.d.ts) - Create a type that only has explicitly defined properties, absent of any index signatures.\n        - [`PartialDeep`](source/partial-deep.d.ts) - Create a deeply optional version of another type. Use [`Partial<T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#partialtype) if you only need one level deep.\n        - [`PartialOnUndefinedDeep`](source/partial-on-undefined-deep.d.ts) - Create a deep version of another type where all keys accepting `undefined` type are set to optional.\n        - [`ReadonlyDeep`](source/readonly-deep.d.ts) - Create a deeply immutable version of an `object`/`Map`/`Set`/`Array` type. Use [`Readonly<T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#readonlytype) if you only need one level deep.\n        - [`LiteralUnion`](source/literal-union.d.ts) - Create a union type by combining primitive types and literal types without sacrificing auto-completion in IDEs for the literal type part of the union. Workaround for [Microsoft/TypeScript#29729](https://github.com/Microsoft/TypeScript/issues/29729).\n        - [`Opaque`](source/opaque.d.ts) - Create an [opaque type](https://codemix.com/opaque-types-in-javascript/).\n        - [`UnwrapOpaque`](source/opaque.d.ts) - Revert an [opaque type](https://codemix.com/opaque-types-in-javascript/) back to its original type.\n        - [`InvariantOf`](source/invariant-of.d.ts) - Create an [invariant type](https://basarat.gitbook.io/typescript/type-system/type-compatibility#footnote-invariance), which is a type that does not accept supertypes and subtypes.\n        - [`SetOptional`](source/set-optional.d.ts) - Create a type that makes the given keys optional.\n        - [`SetRequired`](source/set-required.d.ts) - Create a type that makes the given keys required.\n        - [`SetNonNullable`](source/set-non-nullable.d.ts) - Create a type that makes the given keys non-nullable.\n        - [`ValueOf`](source/value-of.d.ts) - Create a union of the given object's values, and optionally specify which keys to get the values from.\n        - [`ConditionalKeys`](source/conditional-keys.d.ts) - Extract keys from a shape where values extend the given `Condition` type.\n        - [`ConditionalPick`](source/conditional-pick.d.ts) - Like `Pick` except it selects properties from a shape where the values extend the given `Condition` type.\n        - [`ConditionalExcept`](source/conditional-except.d.ts) - Like `Omit` except it removes properties from a shape where the values extend the given `Condition` type.\n        - [`UnionToIntersection`](source/union-to-intersection.d.ts) - Convert a union type to an intersection type.\n        - [`LiteralToPrimitive`](source/literal-to-primitive.d.ts) - Convert a [literal type](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#literal-types) to the [primitive type](source/primitive.d.ts) it belongs to.\n        - [`Stringified`](source/stringified.d.ts) - Create a type with the keys of the given type changed to `string` type.\n        - [`IterableElement`](source/iterable-element.d.ts) - Get the element type of an `Iterable`/`AsyncIterable`. For example, an array or a generator.\n        - [`Entry`](source/entry.d.ts) - Create a type that represents the type of an entry of a collection.\n        - [`Entries`](source/entries.d.ts) - Create a type that represents the type of the entries of a collection.\n        - [`SetReturnType`](source/set-return-type.d.ts) - Create a function type with a return type of your choice and the same parameters as the given function type.\n        - [`Simplify`](source/simplify.d.ts) - Useful to flatten the type output to improve type hints shown in editors. And also to transform an interface into a type to aide with assignability.\n        - [`Get`](source/get.d.ts) - Get a deeply-nested property from an object using a key path, like [Lodash's `.get()`](https://lodash.com/docs/latest#get) function.\n        - [`StringKeyOf`](source/string-key-of.d.ts) - Get keys of the given type as strings.\n        - [`Schema`](source/schema.d.ts) - Create a deep version of another object type where property values are recursively replaced into a given value type.\n        - [`Exact`](source/exact.d.ts) - Create a type that does not allow extra properties.\n        - [`OptionalKeysOf`](source/optional-keys-of.d.ts) - Extract all optional keys from the given type.\n        - [`HasOptionalKeys`](source/has-optional-keys.d.ts) - Create a `true`/`false` type depending on whether the given type has any optional fields.\n        - [`RequiredKeysOf`](source/required-keys-of.d.ts) - Extract all required keys from the given type.\n        - [`HasRequiredKeys`](source/has-required-keys.d.ts) - Create a `true`/`false` type depending on whether the given type has any required fields.\n        - [`Spread`](source/spread.d.ts) - Mimic the type inferred by TypeScript when merging two objects or two arrays/tuples using the spread syntax.\n        \n        ### JSON\n        \n        - [`Jsonify`](source/jsonify.d.ts) - Transform a type to one that is assignable to the `JsonValue` type.\n        - [`JsonPrimitive`](source/basic.d.ts) - Matches a JSON primitive.\n        - [`JsonObject`](source/basic.d.ts) - Matches a JSON object.\n        - [`JsonArray`](source/basic.d.ts) - Matches a JSON array.\n        - [`JsonValue`](source/basic.d.ts) - Matches any valid JSON value.\n        \n        ### Async\n        \n        - [`Promisable`](source/promisable.d.ts) - Create a type that represents either the value or the value wrapped in `PromiseLike`.\n        - [`AsyncReturnType`](source/async-return-type.d.ts) - Unwrap the return type of a function that returns a `Promise`.\n        - [`Asyncify`](source/asyncify.d.ts) - Create an async version of the given function type.\n        \n        ### String\n        \n        - [`Trim`](source/trim.d.ts) - Remove leading and trailing spaces from a string.\n        - [`Split`](source/split.d.ts) - Represents an array of strings split using a given character or character set.\n        - [`Replace`](source/replace.d.ts) - Represents a string with some or all matches replaced by a replacement.\n        \n        ### Array\n        \n        - [`Includes`](source/includes.d.ts) - Returns a boolean for whether the given array includes the given item.\n        - [`Join`](source/join.d.ts) - Join an array of strings and/or numbers using the given string as a delimiter.\n        - [`LastArrayElement`](source/last-array-element.d.ts) - Extracts the type of the last element of an array.\n        - [`FixedLengthArray`](source/fixed-length-array.d.ts) - Create a type that represents an array of the given type and length.\n        - [`MultidimensionalArray`](source/multidimensional-array.d.ts) - Create a type that represents a multidimensional array of the given type and dimensions.\n        - [`MultidimensionalReadonlyArray`](source/multidimensional-readonly-array.d.ts) - Create a type that represents a multidimensional readonly array of the given type and dimensions.\n        - [`ReadonlyTuple`](source/readonly-tuple.d.ts) - Create a type that represents a read-only tuple of the given type and length.\n        \n        ### Numeric\n        \n        - [`PositiveInfinity`](source/numeric.d.ts) - Matches the hidden `Infinity` type.\n        - [`NegativeInfinity`](source/numeric.d.ts) - Matches the hidden `-Infinity` type.\n        - [`Finite`](source/numeric.d.ts) - A finite `number`.\n        - [`Integer`](source/numeric.d.ts) - A `number` that is an integer.\n        - [`Float`](source/numeric.d.ts) - A `number` that is not an integer.\n        - [`NegativeFloat`](source/numeric.d.ts) - A negative (`-\u221e < x < 0`) `number` that is not an integer.\n        - [`Negative`](source/numeric.d.ts) - A negative `number`/`bigint` (`-\u221e < x < 0`)\n        - [`NonNegative`](source/numeric.d.ts) - A non-negative `number`/`bigint` (`0 <= x < \u221e`).\n        - [`NegativeInteger`](source/numeric.d.ts) - A negative (`-\u221e < x < 0`) `number` that is an integer.\n        - [`NonNegativeInteger`](source/numeric.d.ts) - A non-negative (`0 <= x < \u221e`) `number` that is an integer.\n        \n        ### Change case\n        \n        - [`CamelCase`](source/camel-case.d.ts) - Convert a string literal to camel-case (`fooBar`).\n        - [`CamelCasedProperties`](source/camel-cased-properties.d.ts) - Convert object properties to camel-case (`fooBar`).\n        - [`CamelCasedPropertiesDeep`](source/camel-cased-properties-deep.d.ts) - Convert object properties to camel-case recursively (`fooBar`).\n        - [`KebabCase`](source/kebab-case.d.ts) - Convert a string literal to kebab-case (`foo-bar`).\n        - [`KebabCasedProperties`](source/kebab-cased-properties.d.ts) - Convert a object properties to kebab-case recursively (`foo-bar`).\n        - [`KebabCasedPropertiesDeep`](source/kebab-cased-properties-deep.d.ts) - Convert object properties to kebab-case (`foo-bar`).\n        - [`PascalCase`](source/pascal-case.d.ts) - Converts a string literal to pascal-case (`FooBar`)\n        - [`PascalCasedProperties`](source/pascal-cased-properties.d.ts) - Converts object properties to pascal-case (`FooBar`)\n        - [`PascalCasedPropertiesDeep`](source/pascal-cased-properties-deep.d.ts) - Converts object properties to pascal-case (`FooBar`)\n        - [`SnakeCase`](source/snake-case.d.ts) - Convert a string literal to snake-case (`foo_bar`).\n        - [`SnakeCasedProperties`](source/snake-cased-properties-deep.d.ts) - Convert object properties to snake-case (`foo_bar`).\n        - [`SnakeCasedPropertiesDeep`](source/snake-cased-properties-deep.d.ts) - Convert object properties to snake-case recursively (`foo_bar`).\n        - [`ScreamingSnakeCase`](source/screaming-snake-case.d.ts) - Convert a string literal to screaming-snake-case (`FOO_BAR`).\n        - [`DelimiterCase`](source/delimiter-case.d.ts) - Convert a string literal to a custom string delimiter casing.\n        - [`DelimiterCasedProperties`](source/delimiter-cased-properties.d.ts) - Convert object properties to a custom string delimiter casing.\n        - [`DelimiterCasedPropertiesDeep`](source/delimiter-cased-properties-deep.d.ts) - Convert object properties to a custom string delimiter casing recursively.\n        \n        ### Miscellaneous\n        \n        - [`PackageJson`](source/package-json.d.ts) - Type for [npm's `package.json` file](https://docs.npmjs.com/creating-a-package-json-file). It also includes support for [TypeScript Declaration Files](https://www.typescriptlang.org/docs/handbook/declaration-files/publishing.html) and [Yarn Workspaces](https://classic.yarnpkg.com/lang/en/docs/workspaces/).\n        - [`TsConfigJson`](source/tsconfig-json.d.ts) - Type for [TypeScript's `tsconfig.json` file](https://www.typescriptlang.org/docs/handbook/tsconfig-json.html) (TypeScript 4.4).\n        \n        ## Declined types\n        \n        *If we decline a type addition, we will make sure to document the better solution here.*\n        \n        - [`Diff` and `Spread`](https://github.com/sindresorhus/type-fest/pull/7) - The pull request author didn't provide any real-world use-cases and the PR went stale. If you think this type is useful, provide some real-world use-cases and we might reconsider.\n        - [`Dictionary`](https://github.com/sindresorhus/type-fest/issues/33) - You only save a few characters (`Dictionary<number>` vs `Record<string, number>`) from [`Record`](https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type), which is more flexible and well-known. Also, you shouldn't use an object as a dictionary. We have `Map` in JavaScript now.\n        - [`ExtractProperties` and `ExtractMethods`](https://github.com/sindresorhus/type-fest/pull/4) - The types violate the single responsibility principle. Instead, refine your types into more granular type hierarchies.\n        - [`Url2Json`](https://github.com/sindresorhus/type-fest/pull/262) - Inferring search parameters from a URL string is a cute idea, but not very useful in practice, since search parameters are usually dynamic and defined separately.\n        - [`Nullish`](https://github.com/sindresorhus/type-fest/pull/318) - The type only saves a couple of characters, not everyone knows what \"nullish\" means, and I'm also trying to [get away from `null`](https://github.com/sindresorhus/meta/discussions/7).\n        - [`TitleCase`](https://github.com/sindresorhus/type-fest/pull/303) - It's not solving a common need and is a better fit for a separate package.\n        - [`ExtendOr` and `ExtendAnd`](https://github.com/sindresorhus/type-fest/pull/247) - The benefits don't outweigh having to learn what they mean.\n        - [`PackageJsonExtras`](https://github.com/sindresorhus/type-fest/issues/371) - There are too many possible configurations that can be put into `package.json`. If you would like to extend `PackageJson` to support an additional configuration in your project, please see the *Extending existing types* section below.\n        \n        ## Alternative type names\n        \n        *If you know one of our types by a different name, add it here for discovery.*\n        \n        - `PartialBy` - See [`SetOptional`](https://github.com/sindresorhus/type-fest/blob/main/source/set-optional.d.ts)\n        - `RecordDeep`- See [`Schema`](https://github.com/sindresorhus/type-fest/blob/main/source/schema.d.ts)\n        \n        ## Tips\n        \n        ### Extending existing types\n        \n        - [`PackageJson`](source/package-json.d.ts) - There are a lot of tools that place extra configurations inside the `package.json` file. You can extend `PackageJson` to support these additional configurations.\n        \t<details>\n        \t<summary>\n        \t\t\tExample\n        \t</summary>\n        \n        \t[Playground](https://www.typescriptlang.org/play?#code/JYWwDg9gTgLgBDAnmApnA3gBQIYGMDW2A5igFIDOEAdnNuXAEJ0o4HFmVUC+cAZlBBBwA5ElQBaXinIxhAbgCwAKFCRYCZGnQAZYFRgooPfoJHSANntmKlysWlaESFanAC8jZo-YuaAMgwLKwBhal5gIgB+AC44XX1DADpQqnCiLhsgA)\n        \n        \t```ts\n        \timport type {PackageJson as BasePackageJson} from 'type-fest';\n        \timport type {Linter} from 'eslint';\n        \n        \ttype PackageJson = BasePackageJson & {eslintConfig?: Linter.Config};\n        \t```\n        \t</details>\n        \n        ### Related\n        \n        - [typed-query-selector](https://github.com/g-plane/typed-query-selector) - Enhances `document.querySelector` and `document.querySelectorAll` with a template literal type that matches element types returned from an HTML element query selector.\n        - [`Linter.Config`](https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/eslint/index.d.ts) - Definitions for the [ESLint configuration schema](https://eslint.org/docs/user-guide/configuring/language-options).\n        \n        ### Built-in types\n        \n        There are many advanced types most users don't know about.\n        \n        - [`Partial<T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#partialtype) - Make all properties in `T` optional.\n        \t<details>\n        \t<summary>\n        \t\t\tExample\n        \t</summary>\n        \n        \t[Playground](https://www.typescriptlang.org/play/#code/JYOwLgpgTgZghgYwgAgHIHsAmEDC6QzADmyA3gLABQyycADnanALYQBcyAzmFKEQNxUaddFDAcQAV2YAjaIMoBfKlQQAbOJ05osEAIIMAQpOBrsUMkOR1eANziRkCfISKSoD4Pg4ZseAsTIALyW1DS0DEysHADkvvoMMQA0VsKi4sgAzAAMuVaKClY2wPaOknSYDrguADwA0sgQAB6QIJjaANYQAJ7oMDp+LsQAfAAUXd0cdUnI9mo+uv6uANp1ALoAlKHhyGAAFsCcAHTOAW4eYF4gyxNrwbNwago0ypRWp66jH8QcAApwYmAjxq8SWIy2FDCNDA3ToKFBQyIdR69wmfQG1TOhShyBgomQX3w3GQE2Q6IA8jIAFYQBBgI4TTiEs5bTQYsFInrLTbbHZOIlgZDlSqQABqj0kKBC3yINx6a2xfOQwH6o2FVXFaklwSCIUkbQghBAEEwENSfNOlykEGefNe5uhB2O6sgS3GPRmLogmslG1tLxUOKgEDA7hAuydtteryAA)\n        \n        \t```ts\n        \tinterface NodeConfig {\n        \t\t\tappName: string;\n        \t\t\tport: number;\n        \t}\n        \n        \tclass NodeAppBuilder {\n        \t\t\tprivate configuration: NodeConfig = {\n        \t\t\t\t\tappName: 'NodeApp',\n        \t\t\t\t\tport: 3000\n        \t\t\t};\n        \n        \t\t\tprivate updateConfig<Key extends keyof NodeConfig>(key: Key, value: NodeConfig[Key]) {\n        \t\t\t\t\tthis.configuration[key] = value;\n        \t\t\t}\n        \n        \t\t\tconfig(config: Partial<NodeConfig>) {\n        \t\t\t\t\ttype NodeConfigKey = keyof NodeConfig;\n        \n        \t\t\t\t\tfor (const key of Object.keys(config) as NodeConfigKey[]) {\n        \t\t\t\t\t\t\tconst updateValue = config[key];\n        \n        \t\t\t\t\t\t\tif (updateValue === undefined) {\n        \t\t\t\t\t\t\t\t\tcontinue;\n        \t\t\t\t\t\t\t}\n        \n        \t\t\t\t\t\t\tthis.updateConfig(key, updateValue);\n        \t\t\t\t\t}\n        \n        \t\t\t\t\treturn this;\n        \t\t\t}\n        \t}\n        \n        \t// `Partial<NodeConfig>`` allows us to provide only a part of the\n        \t// NodeConfig interface.\n        \tnew NodeAppBuilder().config({appName: 'ToDoApp'});\n        \t```\n        \t</details>\n        \n        - [`Required<T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#requiredtype) - Make all properties in `T` required.\n        \t<details>\n        \t<summary>\n        \t\t\tExample\n        \t</summary>\n        \n        \t[Playground](https://typescript-play.js.org/?target=6#code/AQ4SwOwFwUwJwGYEMDGNgGED21VQGJZwC2wA3gFCjXAzFJgA2A-AFzADOUckA5gNxUaIYjA4ckvGG07c+g6gF8KQkAgCuEFFDA5O6gEbEwUbLm2ESwABQIixACJIoSdgCUYAR3Vg4MACYAPGYuFvYAfACU5Ko0APRxwADKMBD+wFAAFuh2Vv7OSBlYGdmc8ABu8LHKsRyGxqY4oQT21pTCIHQMjOwA5DAAHgACxAAOjDAAdChYxL0ANLHUouKSMH0AEmAAhJhY6ozpAJ77GTCMjMCiV0ToSAb7UJPPC9WRgrEJwAAqR6MwSRQPFGUFocDgRHYxnEfGAowh-zgUCOwF6KwkUl6tXqJhCeEsxDaS1AXSYfUGI3GUxmc0WSneQA)\n        \n        \t```ts\n        \tinterface ContactForm {\n        \t\t\temail?: string;\n        \t\t\tmessage?: string;\n        \t}\n        \n        \tfunction submitContactForm(formData: Required<ContactForm>) {\n        \t\t\t// Send the form data to the server.\n        \t}\n        \n        \tsubmitContactForm({\n        \t\t\temail: 'ex@mple.com',\n        \t\t\tmessage: 'Hi! Could you tell me more about\u2026',\n        \t});\n        \n        \t// TypeScript error: missing property 'message'\n        \tsubmitContactForm({\n        \t\t\temail: 'ex@mple.com',\n        \t});\n        \t```\n        \t</details>\n        \n        - [`Readonly<T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#readonlytype) - Make all properties in `T` readonly.\n        \t<details>\n        \t<summary>\n        \t\t\tExample\n        \t</summary>\n        \n        \t[Playground](https://typescript-play.js.org/?target=6#code/AQ4UwOwVwW2AZA9gc3mAbmANsA3gKFCOAHkAzMgGkOJABEwAjKZa2kAUQCcvEu32AMQCGAF2FYBIAL4BufDRABLCKLBcywgMZgEKZOoDCiCGSXI8i4hGEwwALmABnUVxXJ57YFgzZHSVF8sT1BpBSItLGEnJz1kAy5LLy0TM2RHACUwYQATEywATwAeAITjU3MAPnkrCJMXLigtUT4AClxgGztKbyDgaX99I1TzAEokr1BRAAslJwA6FIqLAF48TtswHp9MHDla9hJGACswZvmyLjAwAC8wVpm5xZHkUZDaMKIwqyWXYCW0oN4sNlsA1h0ug5gAByACyBQAggAHJHQ7ZBIFoXbzBjMCz7OoQP5YIaJNYQMAAdziCVaALGNSIAHomcAACoFJFgADKWjcSNEwG4vC4ji0wggEEQguiTnMEGALWAV1yAFp8gVgEjeFyuKICvMrCTgVxnst5jtsGC4ljsPNhXxGaAWcAAOq6YRXYDCRg+RWIcA5JSC+kWdCepQ+v3RYCU3RInzRMCGwlpC19NYBW1Ye08R1AA)\n        \n        \t```ts\n        \tenum LogLevel {\n        \t\t\tOff,\n        \t\t\tDebug,\n        \t\t\tError,\n        \t\t\tFatal\n        \t};\n        \n        \tinterface LoggerConfig {\n        \t\t\tname: string;\n        \t\t\tlevel: LogLevel;\n        \t}\n        \n        \tclass Logger {\n        \t\t\tconfig: Readonly<LoggerConfig>;\n        \n        \t\t\tconstructor({name, level}: LoggerConfig) {\n        \t\t\t\t\tthis.config = {name, level};\n        \t\t\t\t\tObject.freeze(this.config);\n        \t\t\t}\n        \t}\n        \n        \tconst config: LoggerConfig = {\n        \t\tname: 'MyApp',\n        \t\tlevel: LogLevel.Debug\n        \t};\n        \n        \tconst logger = new Logger(config);\n        \n        \t// TypeScript Error: cannot assign to read-only property.\n        \tlogger.config.level = LogLevel.Error;\n        \n        \t// We are able to edit config variable as we please.\n        \tconfig.level = LogLevel.Error;\n        \t```\n        \t</details>\n        \n        - [`Pick<T, K>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#picktype-keys) - From `T`, pick a set of properties whose keys are in the union `K`.\n        \t<details>\n        \t<summary>\n        \t\t\tExample\n        \t</summary>\n        \n        \t[Playground](https://typescript-play.js.org/?target=6#code/AQ4SwOwFwUwJwGYEMDGNgEE5TCgNugN4BQoZwOUBAXMAM5RyQDmA3KeSFABYCuAtgCMISMHloMmENh04oA9tBjQJjFuzIBfYrOAB6PcADCcGElh1gEGAHcKATwAO6ebyjB5CTNlwFwSxFR0BX5HeToYABNgBDh5fm8cfBg6AHIKG3ldA2BHOOcfFNpUygJ0pAhokr4hETFUgDpswywkggAFUwA3MFtgAF5gQgowKhhVKTYKGuFRcXo1aVZgbTIoJ3RW3xhOmB6+wfbcAGsAHi3kgBpgEtGy4AAfG54BWfqAPnZm4AAlZUj4MAkMA8GAGB4vEgfMlLLw6CwPBA8PYRmMgZVgAC6CgmI4cIommQELwICh8RBgKZKvALh1ur0bHQABR5PYMui0Wk7em2ADaAF0AJS0AASABUALIAGQAogR+Mp3CROCAFBBwVC2ikBpj5CgBIqGjizLA5TAFdAmalImAuqlBRoVQh5HBgEy1eDWfs7J5cjzGYKhroVfpDEhHM4MV6GRR5NN0JrtnRg6BVirTFBeHAKYmYY6QNpdB73LmCJZBlSAXAubtvczeSmQMNSuMbmKNgBlHFgPEUNwusBIPAAQlS1xetTmxT0SDoESgdD0C4aACtHMwxytLrohawgA)\n        \n        \t```ts\n        \tinterface Article {\n        \t\t\ttitle: string;\n        \t\t\tthumbnail: string;\n        \t\t\tcontent: string;\n        \t}\n        \n        \t// Creates new type out of the `Article` interface composed\n        \t// from the Articles' two properties: `title` and `thumbnail`.\n        \t// `ArticlePreview = {title: string; thumbnail: string}`\n        \ttype ArticlePreview = Pick<Article, 'title' | 'thumbnail'>;\n        \n        \t// Render a list of articles using only title and description.\n        \tfunction renderArticlePreviews(previews: ArticlePreview[]): HTMLElement {\n        \t\t\tconst articles = document.createElement('div');\n        \n        \t\t\tfor (const preview of previews) {\n        \t\t\t\t\t// Append preview to the articles.\n        \t\t\t}\n        \n        \t\t\treturn articles;\n        \t}\n        \n        \tconst articles = renderArticlePreviews([\n        \t\t\t{\n        \t\t\t\ttitle: 'TypeScript tutorial!',\n        \t\t\t\tthumbnail: '/assets/ts.jpg'\n        \t\t\t}\n        \t]);\n        \t```\n        \t</details>\n        \n        - [`Record<K, T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type) - Construct a type with a set of properties `K` of type `T`.\n        \t<details>\n        \t<summary>\n        \t\t\tExample\n        \t</summary>\n        \n        \t[Playground](https://typescript-play.js.org/?target=6#code/AQ4ejYAUHsGcCWAXBMB2dgwGbAKYC2ADgDYwCeeemCaWArgE7ADGMxAhmuQHQBQoYEnJE8wALKEARnkaxEKdMAC8wAOS0kstGuAAfdQBM8ANzxlRjXQbVaWACwC0JPB0NqA3HwGgIwAJJoWozYHCxixnAsjAhStADmwESMMJYo1Fi4HMCIaPEu+MRklHj8gpqyoeHAAKJFFFTAAN4+giDYCIxwSAByHAR4AFw5SDF5Xm2gJBzdfQPD3WPxE5PAlBxdAPLYNQAelgh4aOHDaPQEMowrIAC+3oJ+AMKMrlrAXFhSAFZ4LEhC9g4-0BmA4JBISXgiCkBQABpILrJ5MhUGhYcATGD6Bk4Hh-jNgABrPDkOBlXyQAAq9ngYmJpOAAHcEOCRjAXqwYODfoo6DhakUSph+Uh7GI4P0xER4Cj0OSQGwMP8tP1hgAlX7swwAHgRl2RvIANALSA08ABtAC6AD4VM1Wm0Kow0MMrYaHYJjGYLLJXZb3at1HYnC43Go-QHQDcvA6-JsmEJXARgCDgMYWAhjIYhDAU+YiMAAFIwex0ZmilMITCGF79TLAGRsAgJYAAZRwSEZGzEABFTOZUrJ5Yn+jwnWgeER6HB7AAKJrADpdXqS4ZqYultTG6azVfqHswPBbtauLY7fayQ7HIbAAAMwBuAEoYw9IBq2Ixs9h2eFMOQYPQObALQKJgggABeYhghCIpikkKRpOQRIknAsZUiIeCttECBEP8NSMCkjDDAARMGziuIYxHwYOjDCMBmDNnAuTxA6irdCOBB1Lh5Dqpqn66tISIykawBnOCtqqC0gbjqc9DgpGkxegOliyfJDrRkAA)\n        \n        \t```ts\n        \t// Positions of employees in our company.\n        \ttype MemberPosition = 'intern' | 'developer' | 'tech-lead';\n        \n        \t// Interface describing properties of a single employee.\n        \tinterface Employee {\n        \t\t\tfirstName: string;\n        \t\t\tlastName: string;\n        \t\t\tyearsOfExperience: number;\n        \t}\n        \n        \t// Create an object that has all possible `MemberPosition` values set as keys.\n        \t// Those keys will store a collection of Employees of the same position.\n        \tconst team: Record<MemberPosition, Employee[]> = {\n        \t\t\tintern: [],\n        \t\t\tdeveloper: [],\n        \t\t\t'tech-lead': [],\n        \t};\n        \n        \t// Our team has decided to help John with his dream of becoming Software Developer.\n        \tteam.intern.push({\n        \t\tfirstName: 'John',\n        \t\tlastName: 'Doe',\n        \t\tyearsOfExperience: 0\n        \t});\n        \n        \t// `Record` forces you to initialize all of the property keys.\n        \t// TypeScript Error: \"tech-lead\" property is missing\n        \tconst teamEmpty: Record<MemberPosition, null> = {\n        \t\t\tintern: null,\n        \t\t\tdeveloper: null,\n        \t};\n        \t```\n        \t</details>\n        \n        - [`Exclude<T, U>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#excludetype-excludedunion) - Exclude from `T` those types that are assignable to `U`.\n        \t<details>\n        \t<summary>\n        \t\t\tExample\n        \t</summary>\n        \n        \t[Playground](https://typescript-play.js.org/?target=6#code/JYOwLgpgTgZghgYwgAgMrQG7QMIHsQzADmyA3gFDLIAOuUYAXMiAK4A2byAPsgM5hRQJHqwC2AI2gBucgF9y5MAE9qKAEoQAjiwj8AEnBAATNtGQBeZAAooWphu26wAGmS3e93bRC8IASgsAPmRDJRlyAHoI5ABRAA8ENhYjFFYOZGVVZBgoXFFkAAM0zh5+QRBhZhYJaAKAOkjogEkQZAQ4X2QAdwALCFbaemRgXmQtFjhOMFwq9K6ULuB0lk6U+HYwZAxJnQaYFhAEMGB8ZCIIMAAFOjAANR2IK0HGWISklIAedCgsKDwCYgAbQA5M9gQBdVzFQJ+JhiSRQMiUYYwayZCC4VHPCzmSzAspCYEBWxgFhQAZwKC+FpgJ43VwARgADH4ZFQSWSBjcZPJyPtDsdTvxKWBvr8rD1DCZoJ5HPopaYoK4EPhCEQmGKcKriLCtrhgEYkVQVT5Nr4fmZLLZtMBbFZgT0wGBqES6ghbHBIJqoBKFdBWQpjfh+DQbhY2tqiHVsbjLMVkAB+ZAAZiZaeQTHOVxu9ySjxNaujNwDVHNvzqbBGkBAdPoAfkQA)\n        \n        \t```ts\n        \tinterface ServerConfig {\n        \t\tport: null | string | number;\n        \t}\n        \n        \ttype RequestHandler = (request: Request, response: Response) => void;\n        \n        \t// Exclude `null` type from `null | string | number`.\n        \t// In case the port is equal to `null`, we will use default value.\n        \tfunction getPortValue(port: Exclude<ServerConfig['port'], null>): number {\n        \t\tif (typeof port === 'string') {\n        \t\t\treturn parseInt(port, 10);\n        \t\t}\n        \n        \t\treturn port;\n        \t}\n        \n        \tfunction startServer(handler: RequestHandler, config: ServerConfig): void {\n        \t\tconst server = require('http').createServer(handler);\n        \n        \t\tconst port = config.port === null ? 3000 : getPortValue(config.port);\n        \t\tserver.listen(port);\n        \t}\n        \t```\n        \t</details>\n        \n        - [`Extract<T, U>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#extracttype-union) - Extract from `T` those types that are assignable to `U`.\n        \t<details>\n        \t<summary>\n        \t\t\tExample\n        \t</summary>\n        \n        \t[Playground](https://typescript-play.js.org/?target=6#code/CYUwxgNghgTiAEAzArgOzAFwJYHtXzSwEdkQBJYACgEoAueVZAWwCMQYBuAKDDwGcM8MgBF4AXngBlAJ6scESgHIRi6ty5ZUGdoihgEABXZ888AN5d48ANoiAuvUat23K6ihMQ9ATE0BzV3goPy8GZjZOLgBfLi4Aejj4AEEICBwAdz54MAALKFQQ+BxEeAAHY1NgKAwoIKy0grr4DByEUpgccpgMaXgAaxBerCzi+B9-ZulygDouFHRsU1z8kKMYE1RhaqgAHkt4AHkWACt4EAAPbVRgLLWNgBp9gGlBs8uQa6yAUUuYPQwdgNpKM7nh7mMML4CgA+R5WABqUAgpDeVxuhxO1he0jsXGh8EoOBO9COx3BQPo2PBADckaR6IjkSA6PBqTgsMBzPsicdrEC7OJWXSQNwYvFEgAVTS9JLXODpeDpKBZFg4GCoWa8VACIJykAKiQWKy2YQOAioYikCg0OEMDyhRSy4DyxS24KhAAMjyi6gS8AAwjh5OD0iBFHAkJoEOksC1mnkMJq8gUQKDNttKPlnfrwYp3J5XfBHXqoKpfYkAOI4ansTxaeDADmoRSCCBYAbxhC6TDx6rwYHIRX5bScjA4bLJwoDmDwDkfbA9JMrVMVdM1TN69LgkTgwgkchUahqIA)\n        \n        \t```ts\n        \tdeclare function uniqueId(): number;\n        \n        \tconst ID = Symbol('ID');\n        \n        \tinterface Person {\n        \t\t[ID]: number;\n        \t\tname: string;\n        \t\tage: number;\n        \t}\n        \n        \t// Allows changing the person data as long as the property key is of string type.\n        \tfunction changePersonData<\n        \t\tObj extends Person,\n        \t\tKey extends Extract<keyof Person, string>,\n        \t\tValue extends Obj[Key]\n        \t> (obj: Obj, key: Key, value: Value): void {\n        \t\tobj[key] = value;\n        \t}\n        \n        \t// Tiny Andrew was born.\n        \tconst andrew = {\n        \t\t[ID]: uniqueId(),\n        \t\tname: 'Andrew',\n        \t\tage: 0,\n        \t};\n        \n        \t// Cool, we're fine with that.\n        \tchangePersonData(andrew, 'name', 'Pony');\n        \n        \t// Goverment didn't like the fact that you wanted to change your identity.\n        \tchangePersonData(andrew, ID, uniqueId());\n        \t```\n        \t</details>\n        \n        - [`NonNullable<T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#nonnullabletype) - Exclude `null` and `undefined` from `T`.\n        \t<details>\n        \t<summary>\n        \t\t\tExample\n        \t</summary>\n        \tWorks with <a href=\"https://www.typescriptlang.org/tsconfig#strictNullChecks\"><code>strictNullChecks</code></a> set to <code>true</code>.\n        \n        \t[Playground](https://typescript-play.js.org/?target=6#code/C4TwDgpgBACg9gJ2AOQK4FsBGEFQLxQDOwCAlgHYDmUAPlORtrnQwDasDcAUFwPQBU-WAEMkUOADMowqAGNWwwoSgATCBIqlgpOOSjAAFsOBRSy1IQgr9cKJlSlW1mZYQA3HFH68u8xcoBlHA8EACEHJ08Aby4oKDBUTFZSWXjEFEYcAEIALihkXTR2YSSIAB54JDQsHAA+blj4xOTUsHSACkMzPKD3HHDHNQQAGjSkPMqMmoQASh7g-oihqBi4uNIpdraxPAI2VhmVxrX9AzMAOm2ppnwoAA4ABifuE4BfKAhWSyOTuK7CS7pao3AhXF5rV48E4ICDAVAIPT-cGQyG+XTEIgLMJLTx7CAAdygvRCA0iCHaMwarhJOIQjUBSHaACJHk8mYdeLwxtdcVAAOSsh58+lXdr7Dlcq7A3n3J4PEUdADMcspUE53OluAIUGVTx46oAKuAIAFZGQwCYAKIIBCILjUxaDHAMnla+iodjcIA)\n        \n        \t```ts\n        \ttype PortNumber = string | number | null;\n        \n        \t/** Part of a class definition that is used to build a server */\n        \tclass ServerBuilder {\n        \t\t\tportNumber!: NonNullable<PortNumber>;\n        \n        \t\t\tport(this: ServerBuilder, port: PortNumber): ServerBuilder {\n        \t\t\t\t\tif (port == null) {\n        \t\t\t\t\t\t\tthis.portNumber = 8000;\n        \t\t\t\t\t} else {\n        \t\t\t\t\t\t\tthis.portNumber = port;\n        \t\t\t\t\t}\n        \n        \t\t\t\t\treturn this;\n        \t\t\t}\n        \t}\n        \n        \tconst serverBuilder = new ServerBuilder();\n        \n        \tserverBuilder\n        \t\t\t.port('8000')   // portNumber = '8000'\n        \t\t\t.port(null)     // portNumber =  8000\n        \t\t\t.port(3000);    // portNumber =  3000\n        \n        \t// TypeScript error\n        \tserverBuilder.portNumber = null;\n        \t```\n        \t</details>\n        \n        - [`Parameters<T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#parameterstype) - Obtain the parameters of a function type in a tuple.\n        \t<details>\n        \t<summary>\n        \t\t\tExample\n        \t</summary>\n        \n        \t[Playground](https://typescript-play.js.org/?target=6#code/GYVwdgxgLglg9mABAZwBYmMANgUwBQxgAOIUAXIgIZgCeA2gLoCUFAbnDACaIDeAUIkQB6IYgCypSlBxUATrMo1ECsJzgBbLEoipqAc0J7EMKMgDkiHLnU4wp46pwAPHMgB0fAL58+oSLARECEosLAA5ABUYG2QAHgAxJGdpVWREPDdMylk9ZApqemZEAF4APipacrw-CApEgBogkKwAYThwckQwEHUAIxxZJl4BYVEImiIZKF0oZRwiWVdbeygJmThgOYgcGFYcbhqApCJsyhtpWXcR1cnEePBoeDAABVPzgbTixFeFd8uEsClADcIxGiygIFkSEOT3SmTc2VydQeRx+ZxwF2QQ34gkEwDgsnSuFmMBKiAADEDjIhYk1Qm0OlSYABqZnYka4xA1DJZHJYkGc7yCbyeRA+CAIZCzNAYbA4CIAdxg2zJwVCkWirjwMswuEaACYmCCgA)\n        \n        \t```ts\n        \tfunction shuffle(input: any[]): void {\n        \t\t// Mutate array randomly changing its' elements indexes.\n        \t}\n        \n        \tfunction callNTimes<Fn extends (...args: any[]) => any> (func: Fn, callCount: number) {\n        \t\t// Type that represents the type of the received function parameters.\n        \t\ttype FunctionParameters = Parameters<Fn>;\n        \n        \t\treturn function (...args: FunctionParameters) {\n        \t\t\tfor (let i = 0; i < callCount; i++) {\n        \t\t\t\tfunc(...args);\n        \t\t\t}\n        \t\t}\n        \t}\n        \n        \tconst shuffleTwice = callNTimes(shuffle, 2);\n        \t```\n        \t</details>\n        \n        - [`ConstructorParameters<T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#constructorparameterstype) - Obtain the parameters of a constructor function type in a tuple.\n        \t<details>\n        \t<summary>\n        \t\t\tExample\n        \t</summary>\n        \n        \t[Playground](https://typescript-play.js.org/?target=6#code/MYGwhgzhAECCBOAXAlqApgWQPYBM0mgG8AoaaFRENALmgkXmQDsBzAblOmCycTV4D8teo1YdO3JiICuwRFngAKClWENmLAJRFOZRAAtkEAHQq00ALzlklNBzIBfYk+KhIMAJJTEYJsDQAwmDA+mgAPAAq0GgAHnxMODCKTGgA7tCKxllg8CwQtL4AngDaALraFgB80EWa1SRkAA6MAG5gfNAB4FABPDJyCrQR9tDNyG0dwMGhtBhgjWEiGgA00F70vv4RhY3hEZXVVinpc42KmuJkkv3y8Bly8EPaDWTkhiZd7r3e8LK3llwGCMXGQWGhEOsfH5zJlsrl8p0+gw-goAAo5MAAW3BaHgEEilU0tEhmzQ212BJ0ry4SOg+kg+gBBiMximIGA0nAfAQLGk2N4EAAEgzYcYcnkLsRdDTvNEYkYUKwSdCme9WdM0MYwYhFPSIPpJdTkAAzDKxBUaZX+aAAQgsVmkCTQxuYaBw2ng4Ok8CYcotSu8pMur09iG9vuObxZnx6SN+AyUWTF8MN0CcZE4Ywm5jZHK5aB5fP4iCFIqT4oRRTKRLo6lYVNeAHpG50wOzOe1zHr9NLQ+HoABybsD4HOKXXRA1JCoKhBELmI5pNaB6Fz0KKBAodDYPAgSUTmqYsAALx4m5nC6nW9nGq14KtaEUA9gR9PvuNCjQ9BgACNvcwNBtAcLiAA)\n        \n        \t```ts\n        \tclass ArticleModel {\n        \t\ttitle: string;\n        \t\tcontent?: string;\n        \n        \t\tconstructor(title: string) {\n        \t\t\tthis.title = title;\n        \t\t}\n        \t}\n        \n        \tclass InstanceCache<T extends (new (...args: any[]) => any)> {\n        \t\tprivate ClassConstructor: T;\n        \t\tprivate cache: Map<string, InstanceType<T>> = new Map();\n        \n        \t\tconstructor (ctr: T) {\n        \t\t\tthis.ClassConstructor = ctr;\n        \t\t}\n        \n        \t\tgetInstance (...args: ConstructorParameters<T>): InstanceType<T> {\n        \t\t\tconst hash = this.calculateArgumentsHash(...args);\n        \n        \t\t\tconst existingInstance = this.cache.get(hash);\n        \t\t\tif (existingInstance !== undefined) {\n        \t\t\t\treturn existingInstance;\n        \t\t\t}\n        \n        \t\t\treturn new this.ClassConstructor(...args);\n        \t\t}\n        \n        \t\tprivate calculateArgumentsHash(...args: any[]): string {\n        \t\t\t// Calculate hash.\n        \t\t\treturn 'hash';\n        \t\t}\n        \t}\n        \n        \tconst articleCache = new InstanceCache(ArticleModel);\n        \tconst amazonArticle = articleCache.getInstance('Amazon forests burining!');\n        \t```\n        \t</details>\n        \n        - [`ReturnType<T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#returntypetype) - Obtain the return type of a function type.\n        \t<details>\n        \t<summary>\n        \t\t\tExample\n        \t</summary>\n        \n        \t[Playground](https://typescript-play.js.org/?target=6#code/MYGwhgzhAECSAmICmBlJAnAbgS2E6A3gFDTTwD2AcuQC4AW2AdgOYAUAlAFzSbnbyEAvkWFFQkGJSQB3GMVI1sNZNwg10TZgG4S0YOUY0kh1es07d+xmvQBXYDXLpWi5UlMaWAGj0GjJ6BtNdkJdBQYIADpXZGgAXmgYpB1ScOwoq38aeN9DYxoU6GFRKzVoJjUwRjwAYXJbPPRuAFkwAAcAHgAxBodsAx9GWwBbACMMAD4cxhloVraOCyYjdAAzMDxoOut1e0d0UNIZ6WhWSPOwdGYIbiqATwBtAF0uaHudUQB6ACpv6ABpJBINqJdAbADW0Do5BOw3u5R2VTwMHIq2gAANtjZ0bkbHsnFCwJh8ONjHp0EgwEZ4JFoN9PkRVr1FAZoMwkDRYIjqkgOrosepoEgAB7+eAwAV2BxOLy6ACCVxgIrFEoMeOl6AACpcwMMORgIB1JRMiBNWKVdhruJKfOdIpdrtwFddXlzKjyACp3Nq842HaDIbL6BrZBIVGhIpB1EMYSLsmjmtWW-YhAA+qegAAYLKQLQj3ZsEsdccmnGcLor2Dn8xGedHGpEIBzEzspfsfMHDNAANTQACMVaIljV5GQkRA5DYmIpVKQAgAJARO9le33BDXIyi0YuLW2nJFGLqkOvxFB0YPdBSaLZ0IwNzyPkO8-xkGgsLh8Al427a3hWAhXwwHA8EHT5PmgAB1bAQBAANJ24adKWpft72RaBUTgRBUCAj89HAM8xCTaBjggABRQx0DuHJv25P9dCkWRZVIAAiBjoFImpmjlFBgA0NpsjadByDacgIDAEAIAAQmYpjoGYgAZSBsmGPw6DtZiiFA8CoJguDmAQmoZ2QvtUKQLdoAYmBTwgdEiCAA)\n        \n        \t```ts\n        \t/** Provides every element of the iterable `iter` into the `callback` function and stores the results in an array. */\n        \tfunction mapIter<\n        \t\t\tElem,\n        \t\t\tFunc extends (elem: Elem) => any,\n        \t\t\tRet extends ReturnType<Func>\n        \t>(iter: Iterable<Elem>, callback: Func): Ret[] {\n        \t\t\tconst mapped: Ret[] = [];\n        \n        \t\t\tfor (const elem of iter) {\n        \t\t\t\t\tmapped.push(callback(elem));\n        \t\t\t}\n        \n        \t\t\treturn mapped;\n        \t}\n        \n        \tconst setObject: Set<string> = new Set();\n        \tconst mapObject: Map<number, string> = new Map();\n        \n        \tmapIter(setObject, (value: string) => value.indexOf('Foo')); // number[]\n        \n        \tmapIter(mapObject, ([key, value]: [number, string]) => {\n        \t\t\treturn key % 2 === 0 ? value : 'Odd';\n        \t}); // string[]\n        \t```\n        \t</details>\n        \n        - [`InstanceType<T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#instancetypetype) - Obtain the instance type of a constructor function type.\n        \t<details>\n        \t<summary>\n        \t\t\tExample\n        \t</summary>\n        \n        \t[Playground](https://typescript-play.js.org/?target=6#code/MYGwhgzhAECSAmICmBlJAnAbgS2E6A3gFDTTwD2AcuQC4AW2AdgOYAUAlAFzSbnbyEAvkWFFQkGJSQB3GMVI1sNZNwg10TZgG4S0YOUY0kh1es07d+xmvQBXYDXLpWi5UlMaWAGj0GjJ6BtNdkJdBQYIADpXZGgAXmgYpB1ScOwoq38aeN9DYxoU6GFRKzVoJjUwRjwAYXJbPPRuAFkwAAcAHgAxBodsAx9GWwBbACMMAD4cxhloVraOCyYjdAAzMDxoOut1e0d0UNIZ6WhWSPOwdGYIbiqATwBtAF0uaHudUQB6ACpv6ABpJBINqJdAbADW0Do5BOw3u5R2VTwMHIq2gAANtjZ0bkbHsnFCwJh8ONjHp0EgwEZ4JFoN9PkRVr1FAZoMwkDRYIjqkgOrosepoEgAB7+eAwAV2BxOLy6ACCVxgIrFEoMeOl6AACpcwMMORgIB1JRMiBNWKVdhruJKfOdIpdrtwFddXlzKjyACp3Nq842HaDIbL6BrZBIVGhIpB1EMYSLsmjmtWW-YhAA+qegAAYLKQLQj3ZsEsdccmnGcLor2Dn8xGedHGpEIBzEzspfsfMHDNAANTQACMVaIljV5GQkRA5DYmIpVKQAgAJARO9le33BDXIyi0YuLW2nJFGLqkOvxFB0YPdBSaLZ0IwNzyPkO8-xkGgsLh8Al427a3hWAhXwwHA8EHT5PmgAB1bAQBAANJ24adKWpft72RaBUTgRBUCAj89HAM8xCTaBjggABRQx0DuHJv25P9dCkWRZVIAAiBjoFImpmjlFBgA0NpsjadByDacgIDAEAIAAQmYpjoGYgAZSBsmGPw6DtZiiFA8CoJguDmAQmoZ2QvtUKQLdoAYmBTwgdEiCAA)\n        \n        \t```ts\n        \tclass IdleService {\n        \t\t\tdoNothing (): void {}\n        \t}\n        \n        \tclass News {\n        \t\t\ttitle: string;\n        \t\t\tcontent: string;\n        \n        \t\t\tconstructor(title: string, content: string) {\n        \t\t\t\t\tthis.title = title;\n        \t\t\t\t\tthis.content = content;\n        \t\t\t}\n        \t}\n        \n        \tconst instanceCounter: Map<Function, number> = new Map();\n        \n        \tinterface Constructor {\n        \t\t\tnew(...args: any[]): any;\n        \t}\n        \n        \t// Keep track how many instances of `Constr` constructor have been created.\n        \tfunction getInstance<\n        \t\t\tConstr extends Constructor,\n        \t\t\tArgs extends ConstructorParameters<Constr>\n        \t>(constructor: Constr, ...args: Args): InstanceType<Constr> {\n        \t\t\tlet count = instanceCounter.get(constructor) || 0;\n        \n        \t\t\tconst instance = new constructor(...args);\n        \n        \t\t\tinstanceCounter.set(constructor, count + 1);\n        \n        \t\t\tconsole.log(`Created ${count + 1} instances of ${Constr.name} class`);\n        \n        \t\t\treturn instance;\n        \t}\n        \n        \n        \tconst idleService = getInstance(IdleService);\n        \t// Will log: `Created 1 instances of IdleService class`\n        \tconst newsEntry = getInstance(News, 'New ECMAScript proposals!', 'Last month...');\n        \t// Will log: `Created 1 instances of News class`\n        \t```\n        \t</details>\n        \n        - [`Omit<T, K>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#omittype-keys) - Constructs a type by picking all properties from T and then removing K.\n        \t<details>\n        \t<summary>\n        \t\t\tExample\n        \t</summary>\n        \n        \t[Playground](https://typescript-play.js.org/?target=6#code/JYOwLgpgTgZghgYwgAgIImAWzgG2QbwChlks4BzCAVShwC5kBnMKUcgbmKYAcIFgIjBs1YgOXMpSFMWbANoBdTiW5woFddwAW0kfKWEAvoUIB6U8gDCUCHEiNkICAHdkYAJ69kz4GC3JcPG4oAHteKDABBxCYNAxsPFBIWEQUCAAPJG4wZABySUFcgJAAEzMLXNV1ck0dIuCw6EjBADpy5AB1FAQ4EGQAV0YUP2AHDy8wEOQbUugmBLwtEIA3OcmQnEjuZBgQqE7gAGtgZAhwKHdkHFGwNvGUdDIcAGUliIBJEF3kAF5kAHlML4ADyPBIAGjyBUYRQAPnkqho4NoYQA+TiEGD9EAISIhPozErQMG4AASK2gn2+AApek9pCSXm8wFSQooAJQMUkAFQAsgAZACiOAgmDOOSIJAQ+OYyGl4DgoDmf2QJRCCH6YvALQQNjsEGFovF1NyJWAy1y7OUyHMyE+yRAuFImG4Iq1YDswHxbRINjA-SgfXlHqVUE4xiAA)\n        \n        \t```ts\n        \tinterface Animal {\n        \t\t\timageUrl: string;\n        \t\t\tspecies: string;\n        \t\t\timages: string[];\n        \t\t\tparagraphs: string[];\n        \t}\n        \n        \t// Creates new type with all properties of the `Animal` interface\n        \t// except 'images' and 'paragraphs' properties. We can use this\n        \t// type to render small hover tooltip for a wiki entry list.\n        \ttype AnimalShortInfo = Omit<Animal, 'images' | 'paragraphs'>;\n        \n        \tfunction renderAnimalHoverInfo (animals: AnimalShortInfo[]): HTMLElement {\n        \t\t\tconst container = document.createElement('div');\n        \t\t\t// Internal implementation.\n        \t\t\treturn container;\n        \t}\n        \t```\n        \t</details>\n        \n        - [`Uppercase<S extends string>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#uppercasestringtype) - Transforms every character in a string into uppercase.\n        \t<details>\n        \t<summary>\n        \t\tExample\n        \t</summary>\n        \n        \t```ts\n        \ttype T = Uppercase<'hello'>;  // 'HELLO'\n        \n        \ttype T2 = Uppercase<'foo' | 'bar'>;  // 'FOO' | 'BAR'\n        \n        \ttype T3<S extends string> = Uppercase<`aB${S}`>;\n        \ttype T4 = T3<'xYz'>;  // 'ABXYZ'\n        \n        \ttype T5 = Uppercase<string>;  // string\n        \ttype T6 = Uppercase<any>;  // any\n        \ttype T7 = Uppercase<never>;  // never\n        \ttype T8 = Uppercase<42>;  // Error, type 'number' does not satisfy the constraint 'string'\n        \t```\n        \t</details>\n        \n        - [`Lowercase<S extends string>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#lowercasestringtype) - Transforms every character in a string into lowercase.\n        \t<details>\n        \t<summary>\n        \t\tExample\n        \t</summary>\n        \n        \t```ts\n        \ttype T = Lowercase<'HELLO'>;  // 'hello'\n        \n        \ttype T2 = Lowercase<'FOO' | 'BAR'>;  // 'foo' | 'bar'\n        \n        \ttype T3<S extends string> = Lowercase<`aB${S}`>;\n        \ttype T4 = T3<'xYz'>;  // 'abxyz'\n        \n        \ttype T5 = Lowercase<string>;  // string\n        \ttype T6 = Lowercase<any>;  // any\n        \ttype T7 = Lowercase<never>;  // never\n        \ttype T8 = Lowercase<42>;  // Error, type 'number' does not satisfy the constraint 'string'\n        \t```\n        \t</details>\n        \n        - [`Capitalize<S extends string>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#capitalizestringtype) - Transforms the first character in a string into uppercase.\n        \t<details>\n        \t<summary>\n        \t\tExample\n        \t</summary>\n        \n        \t```ts\n        \ttype T = Capitalize<'hello'>;  // 'Hello'\n        \n        \ttype T2 = Capitalize<'foo' | 'bar'>;  // 'Foo' | 'Bar'\n        \n        \ttype T3<S extends string> = Capitalize<`aB${S}`>;\n        \ttype T4 = T3<'xYz'>;  // 'ABxYz'\n        \n        \ttype T5 = Capitalize<string>;  // string\n        \ttype T6 = Capitalize<any>;  // any\n        \ttype T7 = Capitalize<never>;  // never\n        \ttype T8 = Capitalize<42>;  // Error, type 'number' does not satisfy the constraint 'string'\n        \t```\n        \t</details>\n        \n        - [`Uncapitalize<S extends string>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#uncapitalizestringtype) - Transforms the first character in a string into lowercase.\n        \t<details>\n        \t<summary>\n        \t\tExample\n        \t</summary>\n        \n        \t```ts\n        \ttype T = Uncapitalize<'Hello'>;  // 'hello'\n        \n        \ttype T2 = Uncapitalize<'Foo' | 'Bar'>;  // 'foo' | 'bar'\n        \n        \ttype T3<S extends string> = Uncapitalize<`AB${S}`>;\n        \ttype T4 = T3<'xYz'>;  // 'aBxYz'\n        \n        \ttype T5 = Uncapitalize<string>;  // string\n        \ttype T6 = Uncapitalize<any>;  // any\n        \ttype T7 = Uncapitalize<never>;  // never\n        \ttype T8 = Uncapitalize<42>;  // Error, type 'number' does not satisfy the constraint 'string'\n        \t```\n        \t</details>\n        \n        You can find some examples in the [TypeScript docs](https://www.typescriptlang.org/docs/handbook/utility-types.html).\n        \n        ## Maintainers\n        \n        - [Sindre Sorhus](https://github.com/sindresorhus)\n        - [Jarek Radosz](https://github.com/CvX)\n        - [Dimitri Benin](https://github.com/BendingBender)\n        - [Pelle Wessman](https://github.com/voxpelli)\n        \n        ## License\n        \n        SPDX-License-Identifier: (MIT OR CC0-1.0)\n        \n        ---\n        \n        <div align=\"center\">\n        \t<b>\n        \t\t<a href=\"https://tidelift.com/subscription/pkg/npm-type-fest?utm_source=npm-type-fest&utm_medium=referral&utm_campaign=readme\">Get professional support for this package with a Tidelift subscription</a>\n        \t</b>\n        \t<br>\n        \t<sub>\n        \t\tTidelift helps make open source sustainable for maintainers while giving companies<br>assurances about security, maintenance, and licensing for their dependencies.\n        \t</sub>\n        </div>\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - typestyle@2.4.0\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) 2016 typestyle\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - tzdata@1.0.43\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        [OSI Approved License]\n        The MIT License (MIT)\n        \n        Copyright (c) 2016 Rogier Schouten <https://github.com/rogierschouten>\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in\n        all copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n        THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - undici-types@6.20.0\n        \n        This package contains the following license and notice below:\n        \n        MIT License\n        \n        Copyright (c) Matteo Collina and Undici contributors\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm packages may be included in this product:\n        \n         - validate.io-function@1.0.2\n         - validate.io-integer@1.0.5\n         - validate.io-number@1.0.3\n        \n        These packages each contain the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2014 Athan Reines.\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - validate.io-integer-array@1.0.0\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2015 Athan Reines.\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - ws@8.18.0\n        \n        This package contains the following license and notice below:\n        \n        Copyright (c) 2011 Einar Otto Stangvik <einaros@gmail.com>\n        Copyright (c) 2013 Arnout Kazemier and contributors\n        Copyright (c) 2016 Luigi Pinca and contributors\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy of\n        this software and associated documentation files (the \"Software\"), to deal in\n        the Software without restriction, including without limitation the rights to\n        use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\n        the Software, and to permit persons to whom the Software is furnished to do so,\n        subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\n        FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\n        COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\n        IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\n        CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - yaml@1.10.2\n        \n        This package contains the following license and notice below:\n        \n        Copyright 2018 Eemeli Aro <eemeli@gmail.com>\n        \n        Permission to use, copy, modify, and/or distribute this software for any purpose\n        with or without fee is hereby granted, provided that the above copyright notice\n        and this permission notice appear in all copies.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH\n        REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND\n        FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,\n        INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS\n        OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER\n        TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF\n        THIS SOFTWARE.\n        \n        -----------\n        \n        The following npm package may be included in this product:\n        \n         - yjs@13.6.23\n        \n        This package contains the following license and notice below:\n        \n        The MIT License (MIT)\n        \n        Copyright (c) 2023\n          - Kevin Jahns <kevin.jahns@protonmail.com>.\n          - Chair of Computer Science 5 (Databases & Information Systems), RWTH Aachen University, Germany\n        \n        Permission is hereby granted, free of charge, to any person obtaining a copy\n        of this software and associated documentation files (the \"Software\"), to deal\n        in the Software without restriction, including without limitation the rights\n        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n        copies of the Software, and to permit persons to whom the Software is\n        furnished to do so, subject to the following conditions:\n        \n        The above copyright notice and this permission notice shall be included in all\n        copies or substantial portions of the Software.\n        \n        THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n        SOFTWARE.\n        \n        -----------\n        \n        This file was generated with the generate-license-file npm package!\n        https://www.npmjs.com/package/generate-license-file",
    "summary": "A JupyterLab extension.",
    "version": "0.1.0",
    "project_urls": {
        "Bug Tracker": "https://github.com/GoogleCloudPlatform/scheduler-jupyter-plugin/issues",
        "Homepage": "https://github.com/GoogleCloudPlatform/scheduler-jupyter-plugin",
        "Repository": "https://github.com/GoogleCloudPlatform/scheduler-jupyter-plugin.git"
    },
    "split_keywords": [
        "jupyter",
        " jupyterlab",
        " jupyterlab-extension"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "7df3817e6296dd0d00f791aa79b6ccbe6cadaa3996b68eaef730e3d5e0fd776a",
                "md5": "c4255c2260105570c03f5fd241128143",
                "sha256": "3042c99d46c3805bc0e47075fbb0f6055aeea44d3917a37c76505370bfb33e7a"
            },
            "downloads": -1,
            "filename": "scheduler_jupyter_plugin-0.1.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "c4255c2260105570c03f5fd241128143",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 1055791,
            "upload_time": "2025-07-09T17:39:52",
            "upload_time_iso_8601": "2025-07-09T17:39:52.834054Z",
            "url": "https://files.pythonhosted.org/packages/7d/f3/817e6296dd0d00f791aa79b6ccbe6cadaa3996b68eaef730e3d5e0fd776a/scheduler_jupyter_plugin-0.1.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "8c0d6bbde60e9ac094540b43d7efd973275a3c4e6fa259a0de54bd454ab4e767",
                "md5": "9a753e947c9587f7dddc6ba221b05548",
                "sha256": "d8d8b1526eaec19a5b00b5dd2ee7bb9e4885a83c7419db09ad5b91e095eb4a69"
            },
            "downloads": -1,
            "filename": "scheduler_jupyter_plugin-0.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "9a753e947c9587f7dddc6ba221b05548",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 1399858,
            "upload_time": "2025-07-09T17:39:54",
            "upload_time_iso_8601": "2025-07-09T17:39:54.864785Z",
            "url": "https://files.pythonhosted.org/packages/8c/0d/6bbde60e9ac094540b43d7efd973275a3c4e6fa259a0de54bd454ab4e767/scheduler_jupyter_plugin-0.1.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-09 17:39:54",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "GoogleCloudPlatform",
    "github_project": "scheduler-jupyter-plugin",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "scheduler-jupyter-plugin"
}
        
Elapsed time: 1.60006s